7.4. Claude Code 연결 관리
개요
Claude Code 는 사용자가 자기 PC 에서 쓰는 코딩용 AI 도구입니다. 사용자는 이 도구를 AAS 에 연결해 자기 AI 에이전트에게 일을 시킬 수 있습니다. 연결 하나마다 연결 기록이 생기고, 관리자는 모든 사람의 연결을 한 화면에서 봅니다. 연결을 강제로 끊을 수도 있습니다. 허락 범위나 연결 허용 여부를 관리자가 미리 정하는 화면은 없습니다. 관리자가 정할 수 있는 것은 연결 끊기뿐입니 다.
권한: 관리자. 모든 사람의 연결 보기와 강제 끊기는 관리자만 할 수 있습니다. 사용자는 자기 연결만 봅니다. 이 장은 PC 를 잃어버렸거나 퇴사자 연결을 정리해야 할 때, 보안 점검에서 연결 목록을 확인해야 할 때 씁니다.
연결 만드는 법은 사용자 매뉴얼의 7.5. Claude Code 연결을 봅니다.
연결의 종류
| 종류 | 만드는 방법 | 특징 |
|---|---|---|
| OAuth | 사용자 PC 에서 연결 명령을 실행하고 브라우저에서 로그인한 뒤 「허용」을 누릅니다. | 쓸 때마다 만료가 늘어나고 저절로 갱신됩니다. |
| 수동 | 사용자가 「설정 › Claude Code 연결」에서 토큰을 만듭니다. | 브라우저가 없는 곳(CI, 원격 서버)에서 씁니다. 만료는 7일, 30일, 60일, 90일 중에서 고릅니다(기본 30일). 무기한 토큰은 없습니다. |
연결이 허락하는 범위는 세 묶음 중 하나입니다.
| 묶음 | 허락하는 일 |
|---|---|
| 전체(내 AI 에이전트) | 사용자가 화면에서 할 수 있는 일 모두 |
| 스킬 개발용 | 대화, 파일 읽기·쓰기, 스킬 쓰기, 비밀값 쓰기, 승인. 이 연결을 가진 사람의 PC 에서 비밀값을 넣고 바꿀 수 있으므로 보안 점검 때 분실·퇴사 여부를 먼저 봅니다. |
| 읽기만 | 대화를 보고 결과를 받습니다. |
한 사람이 만들 수 있는 연결은 10개까 지입니다.
권한 규칙
- 연결은 만든 사람의 권한 그대로 일합니다.
- 관리자의 연결도 관리자 권한을 쓰지 못합니다. 전체 AI 에이전트 작업공간 조회, 사용자 관리, 게시 요청 승인 같은 관리 일은 Claude Code 연결로 할 수 없고 브라우저 로그인으로만 할 수 있습니다.
- 토큰 원문은 만들 때 한 번만 보입니다. 관리자도 다시 볼 수 없습니다.
모든 연결 보기
이 기능은 관리자에게만 보입니다. 로그인을 켠 설치에서만 보입니다. 로그인을 끈 설치에서는 Claude Code 를 연결할 수 없고, 「사용자·권한」 화면 제목 아래에 「로그인이 꺼져 있습니다」가 나옵니다. 이 문구가 보이면 운영자에게 알립니다.
그림 7.4-1. 「Claude Code 연결」 목록
- 왼쪽 메뉴의 「관리 › 사용자·권한」을 엽니다.
- 「Claude Code 연결」 탭을 누릅니다.
성공하면 연결 목록이 나옵니다.
목록에는 살아 있는 연결만 나옵니다. 한 줄마다 다음 값이 있습니다.
| 항목 | 내용 |
|---|---|
| 사람 | 연결을 만든 사용자 |
| 이름 | 연결 이름 |
| 종류 | 「OAuth」 또는 「수동」 |
| 마지막 사용 | 마지막으로 쓴 시각 |
| 만료 | 만료 시각. 7일 안이면 주황색으로 나옵니다. |
연결이 없으면 「아직 Claude Code 를 연결한 사람이 없습니다.」가 나옵니다.
연결 강제로 끊기
- 「Claude Code 연결」 탭에서 끊을 줄의 「강제 끊기」 버튼을 누릅니다.
- 확인 창의 「사유」 칸에 끊는 이유를 적습니다. 2자 이상 200자까지 적을 수 있습니다.
- 「강제 끊기」 버튼을 누릅니다.
끊으면 그 사람의 Claude Code 연결이 바로 끝납니다. 되돌리는 기능은 없습니다. 다시 쓰려면 사용자가 새로 연결해야 합니다. 사유를 적지 않으면 버튼이 눌리지 않습니다. 성공하면 목록에서 그 줄이 사라지고 「{이름} 을 끊었습니다」가 나옵니다. 끊기지 않으면 화면을 새로 읽고 다시 시도하고, 계속되면 운영자에게 알립니다.
사용자에게 보이는 것
- 사용자의 받은편지함에 연결 이름, 끊은 관리자, 사유가 담긴 알림이 나옵니다.
- 사용자의 「설정 › Claude Code 연결」에서 끝난 연결 줄에 「끊음」과 사유가 나옵니다. 끝난 연결은 30일 동안 「끝난 연결 보기(30일)」로 볼 수 있습니다.
계정을 정리할 때
퇴사자처럼 사용자 계정을 정리할 때는 이 탭에서 그 사람의 연결이 남아 있는지 함께 확인하고 필요하면 끊습니다. 사용 중지와 삭제 절차는 2.1. 사용자 추가와 수정에 있습니다. 그 장의 절차에는 Claude Code 연결을 끊는 단계가 없으므로, 계정을 정리한 뒤 이 탭에서 따로 확인합니다.
만료 알림
- 7일 안에 끝나는 연결은 사용자의 받은편지함에 알림이 나옵니다. OAuth 연결은 쓰면 만료가 늘어나므로 알림이 오지 않습니다. 수동 토큰은 「새 토큰 만들기」 링크가 함께 나옵니다.
- 사용자의 왼쪽 메뉴 「설정 › Claude Code 연결」에도 7일 안에 끝나는 수동 토큰 수가 빨간 숫자로 나옵니다.