코딩 에이전트 연결하기 (Claude)

포털 화면은 개발 중입니다. 화면의 낱말과 배치는 바뀔 수 있고, 단추가 실행하는 명령은 이미 만들어져 있습니다.

모든 작업공간에는 코딩 에이전트 Claude Code가 설치되어 있습니다. 작업공간의 Claude Code는 연구자 본인의 Claude 계정으로 일하므로, 처음에 한 번 내 계정을 연결합니다. 한 번 연결하면 모든 작업공간이 그 연결을 쓰고, 작업공간마다 로그인할 필요가 없습니다.

필요한 것

• Claude 구독. 토큰은 내 컴퓨터에서 claude setup-token 명령으로 받는데, 이 명령은 Claude 구독으로 인증합니다. Anthropic 문서에 따르면 Pro, Max, Team, Enterprise 구독에서 쓸 수 있고, 무료 claude.ai 계정으로는 받을 수 없습니다.
• 내 컴퓨터의 Claude Code. 그 명령을 실행하려면 내 컴퓨터에 Claude Code가 설치되어 있어야 합니다. 작업공간 안이 아니라 내 컴퓨터입니다.
• 브라우저. 명령을 실행하면 브라우저에서 내 Claude 계정으로 승인합니다.

1. 내 컴퓨터에 Claude Code 설치

이미 설치했다면 건너뜁니다. 터미널에서 claude --version 명령을 실행해 버전이 나오면 설치되어 있습니다.

설치 명령은 Anthropic 문서에 있는 그대로입니다.

설치가 끝나면 새 터미널 창을 열어야 claude 명령이 보입니다.

2. 토큰 받기

내 컴퓨터의 터미널에서 실행합니다.

브라우저가 열리면 내 Claude 계정으로 로그인해 승인합니다. 승인하면 터미널에 토큰이 찍힙니다. 토큰은 이렇게 시작합니다: sk-ant-.

이 명령은 토큰을 어디에도 저장하지 않고 화면에 찍기만 합니다. 토큰은 비밀번호와 같으니 파일이나 메신저에 남기지 말고 바로 다음 단계에서 붙여 넣으세요. Anthropic 문서에 따르면 이 토큰은 1년 동안 쓸 수 있습니다.

3. 포털에서 연결하기

왼쪽 메뉴의 [내 계정]에서 Claude 구역으로 갑니다. 토큰을 「Claude 토큰 (sk-ant-...)」 칸에 붙여 넣고 [Claude 연결]을 누릅니다.

켜져 있는 작업공간이 있으면 「Claude를 연결했습니다. 켜져 있는 작업공간에 바로 반영했습니다: ws-0012」처럼 나옵니다. 켜져 있는 작업공간에서 새로 여는 Claude 창이나 claude 세션은 다시 시작하지 않아도 바로 새 토큰을 씁니다. 이미 열려 있던 Claude 창이나 claude 세션은 닫았다가 다시 열어야 새 토큰을 씁니다. 꺼져 있는 작업공간은 다음에 시작할 때 씁니다.

표준 입력: (숨김)Connected Claude.Updated running workspaces: ws-0012

토큰이 아닌 것을 붙여 넣으면 「Claude 토큰이 아닙니다.」가 나오고, 사유에 「claude setup-token이 출력한 토큰(sk-ant-...)을 붙여 넣으세요.」라고 나옵니다.

개인정보 설정

연결하는 곳에 이 안내가 있습니다: 「개인 Claude 계정을 연결합니다. 대화를 모델 학습에 쓰는지 같은 데이터 처리 조건은 내 Claude 계정의 설정을 따르고, 기관이 정할 수 없습니다. 연결하기 전에 Claude 계정의 개인정보 설정을 확인하세요.」

에이전트가 읽은 내용은 내 Claude 계정으로 모델 제공사(Anthropic)에 전송됩니다. 작업공간의 데이터를 에이전트가 읽으면 그 내용도 전송된다는 뜻입니다.

작업공간 안에서는

• IDE의 Claude Code 창과 터미널의 claude 명령은 연결한 토큰으로 이미 로그인되어 있습니다. 로그인 창이 나오지 않습니다.
• 토큰은 작업 폴더 밖의 읽기 전용 파일로 들어가고, Claude Code를 시작할 때 그 프로세스에 넘겨집니다(그래서 Claude가 실행하는 명령도 그 토큰을 갖습니다). 작업 폴더, IDE와 터미널의 환경 변수, 결과와 함께 저장되는 환경에는 남지 않습니다.
• 토큰 파일은 작업공간 안에서 연구자 권한으로 읽을 수 있습니다. 에이전트의 파일 읽기 도구는 이 파일을 읽지 못하게 막아 두었지만, 에이전트가 실행하는 명령까지 막지는 못합니다.

토큰을 바꿀 때

새 토큰을 받아 같은 방법으로 다시 연결하면 바뀝니다. 켜져 있는 작업공간에도 바로 반영되지만, 이미 열려 있던 Claude 창이나 claude 세션은 닫았다가 다시 열어야 새 토큰을 씁니다. 만료된 토큰을 바꿀 때는 꼭 다시 여세요. 지금은 포털에서 연결을 지우는 단추가 없고, 새 토큰으로 바꿀 수만 있습니다.

이 문서에서 확인하지 못한 것

• 토큰이 만료되기 전에 포털이 미리 알려 주는지. 확인한 화면에는 「연결한 때」만 나옵니다.
• 이미 받은 토큰을 Anthropic 쪽에서 무효로 하는 방법.