Claude Code✓ 공식 문서로 확인10월 16일 수집
클로드 코드 setup-token으로 1년짜리 로그인 토큰 만들어 쓰는 법
claude setup-token은 1년 동안 쓰는 OAuth 토큰을 만든다. CI 파이프라인이나 스크립트처럼 브라우저로 로그인할 수 없는 곳에서 쓰라고 만든 명령이다.
- 터미널에서 돌린다.
/login과 같은 브라우저 승인 화면이 뜨고, 승인하면 토큰이 터미널에 찍힌다.
claude setup-token
- 토큰은 어디에도 저장되지 않는다. 바로 복사해 인증할 곳의 환경변수에 넣는다.
export CLAUDE_CODE_OAUTH_TOKEN=발급받은-토큰
Pro·Max·Team·Enterprise 구독이 있어야 하고 사용량은 그 구독에서 나간다. 토큰으로는 모델 요청만 보낼 수 있어서 원격 제어(Remote Control) 세션이나 claude.ai 커넥터는 쓰지 못한다. 로컬에 직접 등록한 MCP 서버는 그대로 된다. --bare로 띄우면 이 변수를 읽지 않으니 그때는 ANTHROPIC_API_KEY나 apiKeyHelper로 인증한다.
ANTHROPIC_API_KEY·ANTHROPIC_AUTH_TOKEN·apiKeyHelper가 함께 잡혀 있으면 그쪽이 먼저 쓰인다. 변수를 둔 채 /login을 하면 지금 세션만 새 로그인으로 바뀌고, 새 세션은 다시 이 변수를 읽는다. 평소 로그인 대신 쓰자는 글도 X에 돌았지만 위 기능이 빠지고, 토큰이 새면 1년 동안 남이 내 구독으로 요청을 보낼 수 있으니 저장소에 올리지 않는다.
출처