Claude Code API 키 사용 및 구독 결제 분리 안내

Claude Code 세션은 어떤 자격 증명을 사용하고 있습니까?

Claude Code 로그인은 두 가지 방식 중 하나로 작동합니다. claude.ai의 Claude 구독 계정으로 로그인하거나, Anthropic Console 조직을 통해 인증하는 방식입니다. 후자의 경우 해당 조직의 API(애플리케이션 프로그래밍 인터페이스) 잔액에서 모든 토큰 사용량이 차감됩니다. 현재 어떤 방식이 활성화되어 있는지 확인하려면 실행 중인 세션 내에서 /status를 실행하십시오. Status 탭의 Login method 행에는 로그인한 계정이 표시되며, API 키가 자격 증명을 제공하는 경우에는 추가로 API key 행이 나타납니다.

해당 도구가 현재 요금제에 포함되는지 여부는 별개의 문제이며, Claude Code가 Claude Pro 구독에 포함되는지 여부에서 확인할 수 있습니다. 또한 Claude API 키의 작동 원리는 Claude API 인증 작동 방식에서 다룹니다. 아래 내용은 앞선 두 문서에서 다루지 않는 부분으로, 세션이 실제로 어떤 자격 증명을 선택했는지 확인하고 이를 변경하는 방법을 설명합니다.

아래 동작 방식은 2026년 10월 6일에 확인한 Anthropic의 Claude Code 인증 문서를 기준으로 합니다. Claude Code는 자주 업데이트되며, 일부 동작은 최소 버전을 요구하므로 기기에 문제가 있다고 판단하기 전에 claude --version을 실행하여 최신 버전인지 확인하십시오.

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

claude.ai 계정과 platform.claude.com의 Claude Console 계정은 서로 다른 계정입니다. 동일한 이메일 주소를 사용하더라도 각각 별도의 로그인 정보, 별도의 잔액, 별도의 조직으로 분리되어 운영됩니다. 한쪽을 생성한다고 해서 다른 쪽이 자동으로 생성되지 않습니다. Max 플랜을 결제해도 Console 조직에 크레딧이 충전되지 않으며, Console 조직에 잔액을 충전해도 플랜에 아무런 영향을 주지 않습니다.

잔액이 다른 이유는 과금 모델이 다르기 때문입니다. 구독 계정은 플랜의 사용량 한도를 사용하며, 이 한도는 5시간 단위의 롤링 윈도우와 주간 단위로 초기화되고 웹상의 Claude와 공유됩니다. 반면 Console 자격 증명은 조직 단위로 토큰당 과금되며, 정확한 수치는 Console 사용량 페이지에서 확인할 수 있습니다. 실제 업무 환경에서 이러한 차이가 발생하는 비용에 대해서는 구독 결제와 토큰당 결제 비교에서 다룹니다.

특정 계정 유형은 구독 방식을 전혀 사용할 수 없습니다. Anthropic은 Pro 또는 Max 구독, Claude for Teams 또는 Enterprise 좌석, Claude Console 계정, 클라우드 제공업체, 그리고 Cloud gateway를 로그인 가능한 계정으로 명시합니다. 여기서 Cloud gateway란 조직이 직접 운영하며 /login을 통해 기업용 SSO(Single Sign-On)로 로그인하는 자체 호스팅 Claude 앱 게이트웨이를 의미합니다. 무료 claude.ai 계정은 이 목록에 포함되지 않으므로, 무료 플랜 사용자는 로그인할 수 있는 구독 자격 증명이 없으며 무료 Claude 티어의 포함 범위와 제한 사항은 명령줄 도구까지 확장되지 않습니다. 남은 방법은 API 크레딧을 사용하는 Console 조직이며, 이는 다른 형태의 유료 계정입니다.

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

프로젝트 디렉터리에서 claude를 실행합니다. 처음 실행하면 브라우저 창이 열리며, 플랜이 포함된 claude.ai 계정으로 로그인할 수 있습니다.

claude

서버 환경에서는 두 가지가 다르게 동작합니다. 브라우저가 자동으로 열리지 않으면 c을 눌러 로그인 URL을 클립보드에 복사한 뒤, 로컬 머신의 브라우저에 붙여넣으십시오. 만약 브라우저가 터미널로 돌아오는 대신 로그인 코드를 표시한다면, 해당 코드를 복사하여 터미널의 입력 프롬프트에 붙여넣으십시오. SSH(secure shell), WSL2, 컨테이너 내부에서는 브라우저가 원격 머신에서 Claude Code가 시작한 로컬 콜백 서버에 접근할 수 없으므로 이 두 번째 경우가 정상입니다. VS Code의 Remote-SSH로 서버의 코드를 다룬다면 이 로그인에 앞서 서버에 CLI를 설치해야 하며, 그 순서는 VS Code에서 Claude Code를 쓰는 방법에서 다룹니다.

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

서버를 재구축하거나 인계할 때 자격 증명이 저장되는 위치를 아는 것은 중요합니다.

• Linux: ~/.claude/.credentials.json, 파일 모드 0600.
• macOS: 암호화된 Keychain. SSH 세션에서 잠겨 있어 Keychain에 쓰기가 거부되면, Claude Code는 동일한 0600 파일로 대체합니다. 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 블록에 표시된 달러 금액은 토큰 수를 정가 기준으로 계산한 로컬 추정치이므로, 실제 청구서가 아닌 API 사용자를 위한 참고용 수치로 간주해야 합니다. 구독자는 달러 금액이 아닌 막대 그래프를 확인해야 합니다.

Console 자격 증명의 경우, 중요한 수치는 Console에서 확인해야 합니다. 지출 내역은 사용량 페이지에서, 멤버별 수치는 Claude Code 대시보드에서 확인할 수 있습니다. 터미널에 출력되는 그 어떤 내용도 해당 요금 청구에 대한 공식적인 근거가 되지 않습니다.

작업 중에도 플랜 사용량 막대 그래프가 전혀 움직이지 않는다면, 환경 변수에 설정된 자격 증명이 우선 적용되고 있는 것입니다. 이러한 현상은 잘못된 자격 증명이 사용되고 있다는 가장 확실한 징후이며, Claude Code 세션 지출 추적 방법에서 이를 측정하는 더 자세한 방법을 다룹니다. 막대 그래프가 움직이다가 멈춘다면 플랜 한도에 도달한 것이며, 이에 대해서는 Claude 사용량 제한 및 초기화 주기 작동 방식에서 설명합니다.

실패 유형 및 확인 사항

모든 것이 정상 작동하지만 플랜 사용량이 변하지 않는 경우. 환경 변수 자격 증명이 적용된 상태입니다. /status 명령을 실행하면 API key 행이 표시되며, 위에서 설명한 셸 확인 절차를 통해 해당 변수를 확인할 수 있습니다.

구독 상태가 정상임에도 요청이 실패하는 경우. 비활성화되었거나 만료된 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를 실행하십시오. 상태 탭의 Login method 행에는 로그인한 계정이 표시되며, API 키가 자격 증명을 제공하는 경우 API key 행이 추가됩니다. Anthropic 프로필이나 페더레이션 자격 증명이 선택된 경우에는 로그인 행 대신 Profile 행이 나타납니다. 세션 외부에서는 셸에 ANTHROPIC_API_KEY이 설정되어 있는지 확인하여 로그인보다 우선순위가 높은 환경 자격 증명이 존재하는지 파악할 수 있습니다.

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

환경 자격 증명이 구독보다 우선하기 때문입니다. Claude Code는 고정된 순서에 따라 가장 먼저 발견된 자격 증명을 사용합니다. /login 구독 자격 증명은 클라우드 공급자 변수, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, apiKeyHelper, CLAUDE_CODE_OAUTH_TOKEN, 그리고 ANTHROPIC_PROFILE나 페더레이션 변수로 선택한 Anthropic 프로필 또는 페더레이션 자격 증명보다 낮은 우선순위를 갖습니다. user_oauth 모드의 활성 프로필만이 이보다 낮은 우선순위를 가지며, 로그인된 Claude apps gateway 세션은 전체 목록보다 우선합니다. unset ANTHROPIC_API_KEY을 실행하고 새 세션을 시작한 뒤 /status로 확인하십시오. 그 후 해당 변수를 설정한 셸 프로필, systemd 유닛, tmux 환경 또는 컨테이너 정의에서 export 명령을 제거하십시오. 그렇지 않으면 다음 로그인 셸에서 다시 설정됩니다.

무료 Claude 계정으로 Claude Code를 사용할 수 있습니까?

아니요. Anthropic이 로그인용으로 명시한 계정 유형은 Pro 또는 Max 구독, Claude for Teams 또는 Enterprise 좌석, Claude Console 계정, 클라우드 공급자, 그리고 /login을 통해 기업용 SSO로 로그인하는 자체 호스팅 Claude apps gateway입니다. 무료 claude.ai 계정은 여기에 포함되지 않으므로 저장할 구독 자격 증명이 없습니다. 구독을 대신할 유료 대안은 토큰 단위로 과금되는 Claude Console 조직이며, 이는 동일한 이메일 주소를 사용하더라도 별도의 계정으로 취급됩니다.

claude.ai 계정과 Console 계정은 잔액을 공유합니까?

아니요. 두 계정은 동일한 이메일 주소를 사용하더라도 청구 체계가 분리된 별개의 계정입니다. 구독 사용량은 웹상의 Claude와 공유되는 플랜 한도에서 차감되며, 5시간 단위 및 주간 단위로 갱신됩니다. Console 사용량은 조직 단위로 토큰당 과금되며 Console 사용량 페이지에 표시됩니다. 한쪽에 크레딧을 추가해도 다른 쪽에는 아무런 영향을 주지 않습니다.

헤드리스 서버에서 Claude Code를 인증하려면 어떻게 해야 합니까?

두 가지 방법이 있습니다. SSH를 통해 claude를 실행하고 본인의 컴퓨터에서 브라우저 로그인을 완료하십시오. c을 눌러 URL을 복사하고 해당 페이지에서 로그인한 뒤, 리다이렉트 대신 코드가 표시되면 터미널에 다시 붙여넣으십시오. 또는 브라우저가 있는 컴퓨터에서 claude setup-token을 실행하여 출력되는 1년 유효 토큰을 복사한 후, 서버에서 CLAUDE_CODE_OAUTH_TOKEN로 설정하십시오. 해당 토큰은 Pro, Max, Team 또는 Enterprise 플랜이 필요하며 모델 요청만 수행할 수 있습니다. 따라서 --bare을 사용하는 스크립트에는 API 키나 apiKeyHelper가 필요합니다.