Claude Code에서 구독 대신 API key 쓰기

Claude Code 세션에서 사용하는 자격 증명은 무엇인가?

Claude Code 로그인은 두 가지 방식으로 작동한다. claude.ai의 Claude 구독 계정으로 로그인하거나, Anthropic Console 조직으로 인증할 수 있다. 후자의 경우 토큰 사용량이 사용 중인 요금제가 아니라 해당 조직의 API(application programming interface) 계정에 청구된다. 실행 중인 세션에서 /status를 실행하면 현재 어떤 방식이 활성화되어 있는지 확인할 수 있다. Status 탭에는 로그인한 계정의 Login method 행이 표시된다. 대신 API key가 자격 증명을 제공하면 추가로 API key 행이 표시된다.

이 도구가 사용 중인 요금제에 포함되는지는 별도의 문제다. 이에 대한 답은 Claude Pro 구독에 Claude Code가 포함되는지에서 확인할 수 있다. Claude API에서 key를 사용하는 인증 방식은 Claude API 인증이 작동하는 방식에서 다룬다. 이 두 문서에서 다루지 않는 내용은 다음과 같다. 실제 세션에서 어떤 자격 증명을 선택했는지와 이를 변경하는 방법이다.

아래 동작은 2026년 10월 10일에 확인한 Anthropic의 Claude Code 인증 문서를 기준으로 한다. Claude Code는 자주 릴리스되며, 이러한 동작 중 일부는 최소 버전을 지정한다. 따라서 시스템에 문제가 있다고 판단하기 전에 claude --version를 실행해야 한다.

하나의 이메일 주소를 공유할 수 있는 두 계정

claude.ai 계정과 platform.claude.com의 Claude Console 계정은 서로 다른 계정이다. 두 계정이 같은 이메일 주소를 사용해도 별도의 잔액을 가진 별도 로그인으로 유지되며, 서로 다른 조직에 속할 수 있다. 하나를 만든다고 다른 하나가 생성되지는 않는다. Console 조직에 충전해도 사용 중인 요금제에는 아무것도 추가되지 않는다.

반대의 경우에는 2026년 10월 10일에 확인된 예외가 하나 있다. 이제 Max 5x 및 Max 20x 요금제에는 월간 API 크레딧이 포함된다. 각각 월 $100 및 $200이며, Team 요금제에는 공동으로 사용하는 크레딧이 제공된다. 이 크레딧은 claude.ai의 billing settings에서 Console 조직을 연결한 뒤에만 해당 Console 조직에 반영되며, Claude Code에는 사용할 수 없다. Anthropic의 platform 문서에는 Claude Code가 지원 대상이 아니라고 명시되어 있다. 또한 도움말 센터에서는 연결된 조직의 API key를 사용하는 claude -p 실행만 예외로 인정한다. 따라서 해당 크레딧만 보유한 조직에 청구되는 대화형 세션은 Credit balance too low로 실패한다.

잔액이 다른 이유는 결제 모델이 다르기 때문이다. 구독 로그인은 요금제의 사용량 한도를 사용한다. 이 한도는 rolling five hour window와 weekly window를 기준으로 재설정되며, Claude on the web과 공유된다. Console credential은 조직에 토큰 단위로 청구된다. 정확한 수치는 Console usage page에서 확인할 수 있다. 이러한 차이가 실제 작업 비용에 미치는 영향은 토큰 단위 결제와 구독 결제 비교에서 설명한다.

한 계정 유형은 구독 경로를 전혀 사용할 수 없다. Anthropic은 로그인할 수 있는 계정으로 Pro 또는 Max 구독, Claude for Teams 또는 Enterprise seat, Claude Console 계정, cloud provider, Cloud gateway를 제시한다. 여기서 Cloud gateway는 조직이 운영하는 self-hosted Claude apps gateway를 의미하며, corporate SSO (single sign-on)를 통해 /login로 로그인한다. 무료 claude.ai 계정은 이 목록에 없으므로 free-plan 사용자는 로그인에 사용할 subscription credential이 없다. 따라서 무료 Claude 등급에 포함되는 기능과 포함되지 않는 기능은 command line tool까지 확장되지 않는다. 남은 방법은 API credit이 있는 Console 조직을 사용하는 것이며, 이는 다른 형태의 유료 계정이다.

경로 1: Claude 구독으로 로그인

프로젝트 디렉터리에서 claude을 실행합니다. 처음 실행하면 플랜이 연결된 claude.ai 계정으로 로그인할 수 있도록 브라우저 창이 열립니다.

claude

서버에서는 두 가지 동작이 다릅니다. 브라우저가 열리지 않으면 c를 눌러 로그인 URL을 클립보드에 복사한 다음, 자신의 컴퓨터에서 브라우저에 붙여 넣습니다. 그런 다음 해당 브라우저에 터미널로 돌아가는 대신 로그인 코드가 표시되면, 코드를 입력하라는 프롬프트에 다시 붙여 넣습니다. 이 두 번째 경우는 SSH(secure shell), WSL2 및 컨테이너 내부에서 정상입니다. Claude Code가 원격 컴퓨터에서 시작한 로컬 콜백 서버에 브라우저가 연결할 수 없기 때문입니다.

로그인이 완료되면 추측하지 말고 확인합니다. 세션을 시작한 뒤 /status를 실행합니다. Status 탭에는 로그인 방식과 저장된 조직 및 이메일 주소가 표시됩니다. /login는 다른 계정으로 로그인 흐름을 다시 실행하고, /logout는 저장된 자격 증명을 제거합니다. 로그아웃하면 최초 실행 설정 상태도 초기화되므로, 다음에 claude를 실행하면 온보딩 과정을 다시 진행하게 됩니다.

컴퓨터를 다시 구축하거나 다른 사람에게 넘길 때는 해당 자격 증명이 저장되는 위치를 알아야 합니다.

• Linux: ~/.claude/.credentials.json, 파일 모드는 0600입니다.
• macOS: 암호화된 Keychain입니다. SSH 세션에서 Keychain이 잠겨 있을 때처럼 Keychain이 쓰기를 거부하면 Claude Code는 동일한 0600 파일로 대체합니다. Console 로그인으로 API 키를 생성하는 경우에는 이 대체 경로를 사용하지 않으므로 Keychain에 쓸 수 있을 때까지 실패합니다.
• Windows: %USERPROFILE%\.claude\.credentials.json이며, 프로필 디렉터리 자체의 접근 제어에 따라 해당 사용자의 접근으로 제한됩니다.
• CLAUDE_CONFIG_DIR이 설정된 모든 플랫폼: 파일이 해당 디렉터리 아래로 이동하고 macOS Keychain 항목도 해당 디렉터리를 기준으로 연결됩니다. 따라서 다른 CLAUDE_CONFIG_DIR로 시작한 세션은 다른 자격 증명을 읽습니다.

Claude Code는 /login 및 /logout를 통해 해당 파일을 관리합니다. 파일을 직접 편집하는 것은 계정을 전환하는 지원되는 방법이 아닙니다.

경로 2: Console 조직을 통한 인증

Console 접근은 관리자로부터 시작됩니다. 관리자가 Console의 Settings, Members, Invite 메뉴를 통해 귀하를 초대합니다. 이때 역할을 할당하는데, Claude Code 역할은 Claude Code API 키만 생성할 수 있고, Developer 역할은 모든 키를 생성할 수 있습니다. 이후 /login 프롬프트에서 Anthropic Console 계정을 선택합니다.

Claude Code v2.1.242 버전부터는 두 가지 Console 경로가 존재하며, 각각 저장하는 정보가 다릅니다. Console 계정으로 로그인하면 해당 브라우저 로그인에서 얻은 OAuth(open authorisation) 토큰을 Anthropic 프로필로 저장하며, API 키는 생성하지 않습니다. Claude Code는 이 로그인 정보를 스스로 갱신하며, 갱신에 실패하면 다시 로그인할 때까지 요청이 실패합니다. 이 키 없는(keyless) 로그인은 해당 기기에 저장된 모든 claude.ai 로그인 정보를 로그아웃시킵니다. 프롬프트에서 레거시(legacy)라고 표시되는 API 키를 생성하면 Console 키가 발급되어 다른 자격 증명과 함께 저장됩니다. 정적 키는 갱신되지 않으므로 누군가 취소하기 전까지 계속 작동합니다. 이는 빌드 서버에서는 유용하지만, 노트북에서는 보안상 위험 요소가 될 수 있습니다.

키 없는 Console 로그인을 시작하기 전에 ANTHROPIC_API_KEY를 설정 해제하십시오. 해당 변수가 설정되어 있으면 Claude Code는 로그인 프롬프트를 완전히 건너뛰고 발견된 키를 승인할 것을 요청합니다.

항상 선택권이 주어지는 것은 아닙니다. 세션이 클라우드 공급자 환경에서 실행되거나, 설정 파일에서 forceLoginOrgUUID를 설정했거나, forceLoginMethod을 "claudeai" 또는 "console"로 고정한 경우, 혹은 기기에 관리형 설정 소스가 존재하지만 Claude Code가 이를 읽을 수 없는 경우 Claude Code는 묻지 않고 키를 생성합니다. 이는 관리자의 결정 사항이므로 키 없는 옵션이 나타나지 않는다면 관리자에게 문의하십시오. 또한 /status를 실행하면 세션이 로드한 모든 설정 파일의 이름이 포함된 Setting sources 줄이 출력되며, 관리형 설정 소스가 적용된 경우 해당 소스의 이름도 표시됩니다.

Claude Code를 Console 조직에 처음으로 인증하면 Console은 이를 위해 "Claude Code"라는 이름의 워크스페이스를 생성합니다. 이 워크스페이스는 Claude Code의 사용량을 한곳에서 추적하기 위해 존재하며, 해당 워크스페이스 내부에서는 API 키를 생성할 수 없습니다.

로그인 후에도 ANTHROPIC_API_KEY가 우선순위를 갖는 이유

Claude Code는 어떤 자격 증명을 사용할지 묻지 않습니다. 고정된 순서에 따라 소스를 확인하고 가장 먼저 발견된 것을 사용합니다. 2026년 10월 문서화된 우선순위는 다음과 같습니다.

1. CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX 또는 CLAUDE_CODE_USE_FOUNDRY이 설정된 경우의 클라우드 공급자 자격 증명.
2. 베어러 토큰으로 인증하는 게이트웨이를 위한 Authorization: Bearer 헤더로 전송되는 ANTHROPIC_AUTH_TOKEN.
3. X-Api-Key 헤더로 전송되는 ANTHROPIC_API_KEY.
4. 설정 파일에 명시된 apiKeyHelper 스크립트의 출력값.
5. claude setup-token에서 생성된 장기 토큰인 CLAUDE_CODE_OAUTH_TOKEN.
6. ant CLI 및 Workload Identity Federation이 사용하는 Anthropic 프로필 및 페더레이션 자격 증명.
7. /login에 의해 작성된 구독 자격 증명.

이 목록에는 두 가지 예외가 있습니다. ANTHROPIC_PROFILE에 프로필을 지정했거나, 페더레이션 변수가 설정되었거나, 활성 프로필이 Workload Identity Federation 프로필인 경우 해당 프로필은 6번 위치에 해당합니다. ant auth login나 키가 없는 Console 로그인이 생성하는 user_oauth 모드의 활성 프로필은 작동 중인 /login 자격 증명보다 낮은 순위를 갖습니다. 또한 로그인된 Claude 앱 게이트웨이 세션은 이 목록 전체에서 제외되며, 클라우드 공급자 변수를 포함한 목록상의 모든 항목보다 우선합니다. 관리자가 설정한 관리형 설정에서 게이트웨이 로그인을 요구하는 경우, Claude Code는 다른 소스를 건너뛰고 /login을 통한 로그인을 요청합니다.

어떠한 예외도 내보낸(exported) 키로부터 구독 정보를 보호하지 못합니다. 게이트웨이가 없는 경우 1번부터 5번까지의 모든 항목이 로그인한 계정보다 우선합니다. 따라서 프로세스 환경 어디에서든 ANTHROPIC_API_KEY이 내보내지면 해당 키가 우선 적용되며, 사용자는 자신의 플랜을 사용 중이라고 생각하지만 실제로는 Console 조직에 비용이 청구됩니다. 이는 오류가 아닙니다. 문서화된 순서대로 동작하는 것이며, 별도의 경고가 없는 이유도 이 때문입니다.

이 사실을 간과하기 쉬운 두 가지 세부 사항이 있습니다. 대화형 세션에서 Claude Code는 발견된 키를 사용할지 한 번 묻고 그 답변을 기억하므로, 한 달 전에 내린 선택이 오늘까지 적용됩니다. -p를 사용하는 비대화형 모드에서는 프롬프트가 전혀 나타나지 않으며 키가 존재하면 항상 사용됩니다. -p은 cron 작업이나 CI(지속적 통합) 단계가 실행되는 모드이므로, 무인 작업에서 잘못된 자격 증명이 가장 오랫동안 발견되지 않습니다.

세션 내에서 빠르게 시각적으로 확인할 방법이 있습니다. ANTHROPIC_API_KEY이 설정되어 있는 동안 /config에는 "Use custom API key" 토글이 표시됩니다. 이 토글은 변수가 설정된 경우에만 존재하므로, 토글이 보이지 않는다면 환경이 깨끗한 상태임을 의미합니다.

서버에서 유실된 키 찾기

내보낸 키는 셸 프로필 외에도 여러 곳에 남아 있을 수 있습니다.

• ~/.bashrc, ~/.bash_profile, ~/.profile 또는 ~/.zshrc: 모든 새로운 로그인 셸이 읽습니다.
• systemd 유닛: Environment= 또는 EnvironmentFile=을 통해 서비스로 실행하는 모든 항목에 적용됩니다.
• tmux 서버: 처음 시작할 때의 환경 변수 복사본을 유지합니다. 오늘 연 창은 지난주에 프로필에서 삭제한 변수를 상속받을 수 있는데, 이는 서버가 편집 이전부터 계속 실행 중이기 때문입니다.
• 컨테이너 이미지 또는 CI 작업 정의: 셸 내부에서 읽을 수 있는 파일 외부에서 변수가 설정됩니다.
• Claude Code 설정 파일의 env 블록: 일반적인 설정 키이며 표준 설정 우선순위를 따릅니다.

다른 작업을 수행하기 전에 다음을 확인하십시오.

[ -n "$ANTHROPIC_API_KEY" ] && echo "ANTHROPIC_API_KEY is set" || echo "not set"
env | grep -E '^(ANTHROPIC_|CLAUDE_CODE_)' | cut -d= -f1
grep -n 'ANTHROPIC_API_KEY' ~/.bashrc ~/.bash_profile ~/.profile ~/.zshrc 2>/dev/null
tmux show-environment 2>/dev/null | grep ANTHROPIC
grep -n 'ANTHROPIC_API_KEY\|apiKeyHelper' ~/.claude/settings.json .claude/settings.json .claude/settings.local.json 2>/dev/null

두 번째 명령은 의도적으로 cut을 거치도록 파이프를 연결했습니다. 이는 화면 공유나 녹화 중일 수 있는 상황에서 비밀 값을 출력하지 않고 변수 이름만 출력하기 위함입니다. 첫 번째 명령으로 질문을 결정합니다. 만약 변수가 설정되었다고 나오면, 이 셸에서 시작하는 다음 claude은 해당 키를 사용합니다. 다섯 곳 모두에서 아무런 반응이 없다면 환경 자격 증명이 존재하지 않는 것이며, 이 세션에서 시작된 작업은 /login 자격 증명을 사용하게 됩니다.

Claude Code를 실행하는 모든 서비스에 systemctl cat your-unit.service | grep -i environment을 추가하십시오. 유닛 파일은 자체 환경을 설정하며 셸 프로필을 읽지 않기 때문입니다.

한 자격 증명에서 다른 자격 증명으로 세션 전환하기

구독 계정으로 돌아가려면 다음을 수행합니다.

unset ANTHROPIC_API_KEY
[ -n "$ANTHROPIC_API_KEY" ] && echo "still set" || echo "clear"
claude

clear가 표시될 때까지 기다린 다음, 새 세션에서 /status를 실행하고 API key 행이 사라졌는지 확인합니다. 이미 실행 중인 Claude Code 프로세스는 시작 시점의 환경 변수를 유지하므로, 셸에서 변수를 설정 해제해도 아무런 변화가 없습니다. 세션을 재시작하십시오.

그 후 해당 변수를 설정했던 파일에서 export 명령을 삭제하십시오. 그렇지 않으면 다음 로그인 셸에서 다시 설정됩니다. tmux 내부에서는 tmux set-environment -u ANTHROPIC_API_KEY 명령을 사용하면 이후에 여는 창부터 해당 변수가 제거되지만, 이미 열려 있는 창은 기존 환경 변수를 그대로 유지합니다.

반대 방향으로 전환하려면 환경 변수에 ANTHROPIC_API_KEY을 설정하거나, /login를 실행하여 Console 계정을 선택합니다. 저장된 로그인 정보를 완전히 삭제하려면 /logout을 실행하십시오. 키리스(keyless) Console 로그인 후에는 /logout을 실행하여 해당 로그인 과정에서 생성된 자격 증명을 제거하고 취소할 수 있습니다.

만약 /status의 결과가 예상과 다르다면 claude doctor을 실행하십시오. 이 명령은 Claude Code가 거부한 설정 항목들을 나열합니다. 이를 통해 구문 분석에 실패하여 전혀 적용되지 않은 설정 파일을 찾아낼 수 있습니다.

브라우저가 없는 환경에서의 인증

claude setup-token는 /login와 동일한 브라우저 인증 흐름을 시작하며, 1년 동안 유효한 OAuth 토큰을 터미널에 출력합니다.

claude setup-token

토큰은 어디에도 저장되지 않으므로 화면에 나타나면 즉시 복사해야 합니다. 토큰이 필요한 머신에서 CLAUDE_CODE_OAUTH_TOKEN 환경 변수로 설정하십시오. 이 토큰은 구독 정보를 기반으로 인증하므로 Pro, Max, Team 또는 Enterprise 플랜이 필요하며, 모델 요청만 수행할 수 있습니다. Bare 모드에서는 이 토큰을 읽지 않으므로, --bare을 전달하는 스크립트에는 ANTHROPIC_API_KEY 또는 apiKeyHelper가 대신 필요합니다.

우선순위 문제도 주의해야 합니다. CLAUDE_CODE_OAUTH_TOKEN이 셸 프로필에 설정되어 있다면, /login을 실행해도 현재 세션만 새 로그인 정보로 전환될 뿐, 프로필에서 해당 변수를 제거하기 전까지는 모든 새 세션이 다시 이전 변수 값을 읽어 들입니다.

조직에서 Amazon Bedrock, Google Cloud 또는 Microsoft Foundry를 통해 추론을 실행하는 경우, 해당 자격 증명이 우선순위 최상단에 위치하므로 브라우저 로그인이 아예 발생하지 않습니다. 해당 설정은 별도의 작업이며, Bedrock 또는 Vertex에서 Claude Code 실행하기에서 다룹니다.

VPS(가상 사설 서버)에서의 장기 세션은 이러한 문제가 집중되는 곳입니다. 세션을 시작한 셸이 몇 달 전에 설정된 후 한 번도 재시작되지 않았을 수 있기 때문입니다. tmux 내부에서 Claude Code 실행하기에서 해당 설정의 세션 관련 내용을 다룹니다.

각 자격 증명이 실제로 무엇에 지출했는지 확인하기

구독 로그인에서는 /usage에 요금제 사용량 막대와 사용량을 소비한 항목별 내역이 표시된다. 해당 화면의 Session 블록에 표시되는 달러 금액은 토큰 수를 정가에 적용해 로컬에서 계산한 값이다. 관리자가 관리형 설정에 modelPricing 표를 설정한 경우에는 조직의 계약 요율을 적용한다. 이 경우 Total cost 줄에 해당 사실이 표시된다. 어느 경우든 이 값은 청구서가 아니라 API 사용자를 위한 추정치로 봐야 한다. 구독자는 달러 금액보다 사용량 막대를 확인해야 한다.

Console 자격 증명에서는 Console의 수치가 중요하다. 지출은 사용량 페이지에서, 구성원별 수치는 Claude Code 대시보드에서 확인한다. 터미널에 출력되는 내용은 해당 청구에 대한 공식 기준이 아니다.

작업 중에도 요금제 사용량 막대가 전혀 움직이지 않는다면 환경 자격 증명이 우선 적용되고 있을 가능성이 높다. /status에서 이를 확인할 수 있다. 단, 막대가 이미 가득 찬 경우는 예외다. 구독 세션은 포함된 한도를 초과해 usage credits를 계속 사용할 수 있으며, Anthropic은 이 사용량에 표준 API 요율을 적용해 청구한다. 이때는 사용량 막대가 그대로 유지된다. 이 경우가 아니라면 막대가 움직이지 않는 것이 잘못된 자격 증명이 적용되었다는 가장 명확한 신호다. Claude Code 세션의 지출 추적에서는 이를 측정하는 방법을 더 자세히 설명한다. 막대가 움직이다가 멈춘다면 요금제 한도에 도달한 것이다. Claude 사용량 한도와 재설정 기간의 작동 방식에서 이를 설명한다.

실패 유형과 확인할 항목

모든 기능이 작동하지만 요금제 사용량이 전혀 변하지 않습니다. 대개 환경 자격 증명이 적용된 상태입니다. /status에 API key 행이 표시되고, 위의 셸 확인에서도 해당 변수가 표시됩니다. 두 곳 모두 표시되지 않고 사용량 막대가 한도에 도달했다면 세션이 사용량 크레딧으로 전환된 것입니다. 이 경우 표준 API 요금이 적용되며, 해당 비용은 claude.ai의 Settings, Usage에서 확인할 수 있습니다.

구독이 정상인데 요청이 실패합니다. 비활성화되었거나 만료된 Console 조직에 속한 키가 로그인 자격 증명보다 우선 적용되고 있을 수 있습니다. unset ANTHROPIC_API_KEY을 실행하고 새 세션을 시작한 다음 /status를 다시 확인합니다. 오류에 잘못된 API 키가 명시되어 있다면 Claude Code의 잘못된 API 키 오류 수정에서 이 경우를 자세히 설명합니다. /login를 다시 실행해도 문제가 해결되지 않는 이유도 포함되어 있습니다.

시작할 때 로그인이 곧 만료된다는 경고가 표시됩니다. 최신 버전은 /login 자격 증명의 만료까지 3일 이내로 남으면 경고를 표시합니다. 실제로 만료된 후에는 /status에 저장된 조직과 이메일 주소와 함께 로그인 행이 만료 상태로 표시됩니다. 갱신하려면 /login을 실행합니다. 이 경고는 요청을 차단하지 않습니다. 따라서 무인 세션이 더 이상 진행되지 않을 때까지 쉽게 무시할 수 있습니다.

apiKeyHelper이 느리게 실행되거나 실패합니다. Claude Code는 기본적으로 5분마다 해당 도우미를 다시 실행합니다. 이 간격은 CLAUDE_CODE_API_KEY_HELPER_TTL_MS으로 조정할 수 있습니다. 실행에 10초보다 오래 걸리면 프롬프트 표시줄에 알림을 표시합니다. 오류가 발생했거나 시간 초과가 되었는지와 관계없이 도우미가 키를 반환하지 않으면 3회 시도 이내에 요청이 실패합니다.

올바른 자격 증명이지만 잘못된 조직에 연결됩니다. 하나의 이메일 주소가 두 조직에 속할 수 있습니다. /status에는 인증된 조직이 표시됩니다. 어느 조직에 연결되었는지 추측하지 말고 해당 행을 확인합니다.

FAQ

지금 Claude Code가 어떤 계정을 사용 중인지 어떻게 확인합니까?

세션에서 /status를 실행합니다. Status 탭에는 로그인한 계정에 해당하는 Login method 행이 표시되며, API key가 자격 증명을 제공하면 API key 행이 추가됩니다. 대신 Anthropic profile 또는 federation credential을 선택하면 로그인 행이 Profile 행으로 바뀝니다. 세션 외부에서는 셸에 ANTHROPIC_API_KEY이 설정되어 있는지 확인하면 로그인보다 우선하는 환경 자격 증명이 있는지 알 수 있습니다.

Claude Pro 또는 Max subscription이 무시되는 이유는 무엇입니까?

환경 자격 증명이 해당 subscription보다 우선하기 때문입니다. Claude Code는 고정된 순서로 처음 발견한 자격 증명을 사용합니다. /login subscription credential은 cloud provider 변수, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, apiKeyHelper, CLAUDE_CODE_OAUTH_TOKEN, 그리고 ANTHROPIC_PROFILE 또는 federation 변수로 선택한 Anthropic profile 또는 federation credential보다 우선순위가 낮습니다. user_oauth mode에서 활성화된 profile만 이보다 우선순위가 낮으며, 로그인된 Claude apps gateway session은 전체 목록보다 우선합니다. unset ANTHROPIC_API_KEY를 실행하고 새 세션을 시작한 다음 /status로 확인합니다. 그런 다음 해당 값을 설정한 shell profile, systemd unit, tmux 환경 또는 container 정의에서 export를 제거해야 합니다. 그렇지 않으면 다음 login shell에서 다시 설정됩니다.

무료 Claude account로 Claude Code를 사용할 수 있습니까?

아니요. Anthropic이 login에 사용할 수 있다고 명시한 account type은 Pro 또는 Max subscription, Claude for Teams 또는 Enterprise seat, Claude Console account, cloud provider, 그리고 /login를 통해 corporate SSO로 로그인한 self-hosted Claude apps gateway인 Cloud gateway입니다. 무료 claude.ai account는 여기에 포함되지 않으므로 저장할 subscription credential이 없습니다. Subscription의 유료 대안은 API credit이 있고 token 단위로 과금되는 Claude Console organisation입니다. 같은 email address를 사용하더라도 별도의 account입니다.

claude.ai account와 Console account는 하나의 잔액을 공유합니까?

아니요. 두 account가 같은 email address를 사용하더라도 별도의 billing과 별도의 account입니다. Subscription 사용량은 plan allowance에서 차감되며 Claude on the web과 공유되고, rolling five hour window와 weekly window에 따라 초기화됩니다. Console 사용량은 organisation에 token 단위로 과금되며 Console usage page에 표시됩니다. 한쪽에 credit을 추가해도 다른 쪽에는 영향을 주지 않습니다. 유일한 선택적 연동은 plan에서 Console로 연결하는 방식입니다. Max 또는 Team plan은 claude.ai에서 연결한 Console organisation으로 월간 API credit을 보낼 수 있지만, 이 credit은 Claude Code에 사용할 수 없습니다.

Headless server에서 Claude Code를 어떻게 인증합니까?

두 가지 방법이 있습니다. SSH를 통해 claude을 실행하고 자신의 machine에서 browser login을 완료합니다. c을 눌러 URL을 복사하고 해당 위치에서 로그인한 다음, browser가 redirect하지 않고 code를 표시하면 이를 terminal에 붙여 넣습니다. 또는 browser가 있는 machine에서 claude setup-token를 실행하고 출력되는 one-year token을 복사한 다음 server에서 CLAUDE_CODE_OAUTH_TOKEN으로 설정합니다. 이 token을 사용하려면 Pro, Max, Team 또는 Enterprise plan이 필요하며 model request만 수행할 수 있습니다. 따라서 --bare을 사용하는 script에는 API key 또는 apiKeyHelper가 필요합니다.