Claude Code ANTHROPIC_API_KEY가 잡히면 API 요금이 나올까 2026

2026년 4월 17일 기준 Anthropic 도움말은 Claude Code가 환경변수 API 키를 구독 로그인보다 우선할 수 있다고 안내한다. 그래서 ANTHROPIC_API_KEY가 살아 있는 터미널에서 Claude Code를 실행하면, 사용자는 Pro나 Max에 로그인했다고 생각해도 API 계정 기준으로 요금이 붙을 수 있다. 이 글은 Claude Code 비용이 이상하게 느껴질 때 /status, 터미널 환경변수, settings 파일을 어떤 순서로 확인해야 하는지 정리한다.

요금제보다 먼저 볼 게 있다.

바로 인증 경로다.

Claude Code를 쓰다 보면 비용 이야기가 자꾸 Pro냐 Max냐로 흐른다. 물론 그 질문도 중요하다. Pro는 월 고정비가 낮고, Max는 더 큰 사용량을 제공한다. 그런데 실제로 돈이 새는 순간은 의외로 더 작고 시시한 곳에서 나온다.

터미널에 API 키가 남아 있는가.

이 한 줄이다.

Claude Code가 구독으로 붙어 있다고 믿었는데, 실제로는 API 키로 붙어 있으면 이야기가 달라진다. 구독 사용량을 쓰는 줄 알았는데 Claude Console의 API 사용량이 움직일 수 있다. 팀에서는 이게 더 귀찮다. 누군가는 구독으로 쓰고, 누군가는 API 키로 쓰고, 또 누군가는 settings 파일에서 다른 경로를 물고 있으면 비용 비교가 바로 흐려진다.

이 글은 Claude Code 비용 최적화 전체를 다시 설명하지 않는다. 그건 이미 넓은 글에서 다뤘다. 여기서는 딱 하나만 본다.

ANTHROPIC_API_KEY가 잡혀 있으면 무엇이 달라지는가.

그리고 그걸 어떻게 확인하고, 언제 지우고, 언제 일부러 써야 하는가.

아래 상황이면 특히 이 글부터 보면 된다.

Claude Pro나 Max를 결제했는데 Claude Console의 API usage가 움직인다.
/cost에 금액이 보여서 실제 카드 청구액인지 헷갈린다.
팀원이 같은 Claude Code 작업을 했는데 비용 추적 결과가 서로 다르다.
CI, cron, 로컬 터미널이 같은 ANTHROPIC_API_KEY 이름을 공유한다.
Max 요금제를 바꿀지 고민 중인데, 먼저 인증 경로부터 확인하고 싶다.

이 글은 요금제 추천 글이 아니다. 비용 대화 전에 인증 경로를 닫는 점검표다.

먼저 판단표부터 보자

아래 표만 봐도 대부분의 사고는 막을 수 있다.

상황	가능성	먼저 볼 것	조치
Pro나 Max에 로그인했는데 API 비용이 움직인다	API 키 우선 사용	`/status`, `echo $ANTHROPIC_API_KEY`	키를 unset하고 새 세션 시작
`/cost` 금액이 보여서 실제 청구액처럼 느껴진다	API 사용량 추정치일 수 있음	Claude Code costs 문서	실제 청구는 Console Usage 확인
팀원이 같은 작업인데 비용이 다르다	인증 방식이 다름	각자 `/status` 결과	팀 공통 인증 규칙 정하기
CI나 자동화에서만 비용이 튄다	구독이 아니라 API lane이 맞을 수 있음	CI secrets, 환경변수	자동화 예산과 사람 구독 예산 분리
Max를 쓰는데도 뭔가 이상하다	Max 문제가 아니라 연결 문제일 수 있음	API 키, settings env	구독 lane인지 API lane인지 먼저 분리

핵심은 단순하다.

Claude Code 비용을 볼 때는 요금제보다 지금 어떤 인증으로 붙었는지를 먼저 봐야 한다.

그 다음에 Pro가 충분한지, Max가 나은지, API로 빼야 하는지를 판단해도 늦지 않다.

공식 문서가 말하는 핵심

Anthropic 도움말은 Claude Code의 인증 우선순위를 꽤 직접적으로 설명한다. 환경변수에 API 키가 설정되어 있으면, Claude Code는 구독 로그인보다 그 API 키를 우선할 수 있다. 이 경우 요금은 해당 API 키가 속한 API 계정 기준으로 붙는다.

이건 버그처럼 보일 수 있지만, 문서상으로는 의도된 동작에 가깝다. 개발자가 터미널마다 다른 API 계정을 쓰거나, 특정 프로젝트에서 API 계정을 명시적으로 쓰려는 경우가 있기 때문이다. 문제는 그 유연함이 개인 사용자에게는 착시를 만든다는 점이다.

나는 Claude Max에 로그인했다. 그러니 지금 Claude Code도 Max 구독 사용량을 쓰겠지. 이 추론이 항상 맞지는 않다.

터미널이 ANTHROPIC_API_KEY를 들고 있으면 이야기가 달라질 수 있다.

공식 비용 문서도 같이 봐야 한다. Claude Code의 /cost는 API 토큰 사용량을 보여주는 도구다. Pro나 Max 구독자의 실제 청구 판단에는 /cost보다 /stats나 계정 사용량 확인이 더 맞는 흐름으로 설명된다. API 사용자는 Console의 Usage와 Billing이 최종 기준이다.

도움말에는 충돌 경고도 언급된다. 초기 설정이나 로그인 뒤에 구독 인증과 환경변수 API 키가 동시에 활성화되어 있으면 Claude Code가 알림을 줄 수 있다는 내용이다. 다만 알림이 있다는 사실과 운영자가 그 의미를 정확히 이해하는 것은 별개다.

그래서 팀 문서에는 알림이 뜨면 확인한다보다 더 구체적으로 적어야 한다.

/status를 보고, ANTHROPIC_API_KEY를 확인하고, 어떤 lane으로 비용이 잡히는지 기록한다.

이 정도까지 해야 나중에 비용 리뷰가 덜 흐려진다.

그러니까 비용을 볼 때는 아래 세 문장을 분리해야 한다.

Pro나 Max 구독을 갖고 있다.
Claude Code에 로그인되어 있다.
지금 실행 중인 Claude Code 세션이 구독 사용량을 쓰고 있다.

1번과 2번이 참이어도 3번이 자동으로 참은 아니다.

이게 오늘 글의 핵심이다.

왜 이게 헷갈리나

헷갈리는 이유는 사용자가 보는 화면과 과금 경로가 다를 수 있기 때문이다.

사용자는 터미널에서 Claude Code를 켠다. 이전에 /login을 해둔 기억이 있다. Claude 앱에서는 Pro나 Max가 활성화되어 있다. 그래서 당연히 구독으로 쓰고 있다고 생각한다.

그런데 터미널 환경은 별도다.

.zshrc에 ANTHROPIC_API_KEY를 넣어둔 적이 있을 수 있다. 프로젝트 실행 스크립트에서 export한 키가 남아 있을 수 있다. CI 디버깅을 하다가 현재 shell session에만 API 키를 넣어둔 적도 있을 수 있다. 또 어떤 도구는 API 키를 자동으로 읽도록 설계되어 있다.

이 상태에서 Claude Code가 API 키를 우선 사용하면, 사람 머릿속의 요금제와 실제 인증 경로가 엇갈린다.

그래서 비용 사고가 나면 바로 이런 대화가 나온다.

나는 Max인데 왜 API 비용이 나오지.

나는 API를 일부러 쓴 적 없는데 왜 usage가 있지.

나는 /cost가 보이는데 이게 카드 청구액인가.

대부분은 모델 문제가 아니다.

연결 경로 문제다.

5분 점검 순서

비용이 이상하다고 느끼면 아래 순서대로 보면 된다.

먼저 Claude Code 안에서 /status를 실행한다. 공식 도움말은 현재 어떤 인증 방식이 활성화되어 있는지 확인할 때 /status를 보라고 안내한다. 여기서 구독 기반인지, API 키 기반인지 먼저 감을 잡는다.

그 다음 터미널에서 환경변수를 본다.

echo $ANTHROPIC_API_KEY

값이 비어 있으면 일단 그 터미널에는 API 키가 노출되어 있지 않은 상태다. 값이 나온다면 그 자체로 바로 경고등이다. 특히 키 전체를 화면에 오래 띄워두거나, 스크린샷에 담거나, 블로그 글에 붙이면 안 된다.

조금 더 명확하게 보려면 아래도 쓸 수 있다.

printenv ANTHROPIC_API_KEY

여기서 값이 보이면 지금 shell이 API 키를 들고 있는 것이다. Mac이나 Linux에서 현재 터미널 세션에서만 지우려면 이렇게 한다.

unset ANTHROPIC_API_KEY

그리고 Claude Code를 새로 시작한다. 이미 실행 중인 세션이 있다면, 환경변수 해제 뒤에 새 세션으로 확인하는 쪽이 안전하다.

Windows PowerShell이라면 확인은 이렇게 한다.

echo $env:ANTHROPIC_API_KEY

현재 세션에서만 지우려면 이렇게 한다.

Remove-Item Env:ANTHROPIC_API_KEY

Windows CMD를 쓴다면 확인은 이렇게 한다.

echo %ANTHROPIC_API_KEY%

현재 세션에서 비우려면 이렇게 한다.

set ANTHROPIC_API_KEY=

이후 다시 Claude Code에서 /status를 본다. 핵심은 한 번 보고 끝내는 게 아니라, 환경변수 확인 -> 해제 -> 새 세션 -> /status 확인 순서로 닫는 것이다.

돈 새는 문제는 추측으로 잡으면 오래 간다.

명령어로 잡아야 빨리 끝난다.

영구 설정까지 확인해야 하는 경우

현재 터미널에서 unset을 했는데도 새 터미널을 열 때마다 다시 살아난다면, 어딘가 영구 설정에 들어가 있을 가능성이 높다.

Mac 기본 zsh 환경이면 보통 아래 파일을 먼저 본다.

grep -n "ANTHROPIC_API_KEY" ~/.zshrc ~/.zprofile ~/.zshenv 2>/dev/null

bash를 쓴다면 이런 쪽이다.

grep -n "ANTHROPIC_API_KEY" ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

여기서 export 구문이 나오면 그 줄이 새 터미널마다 API 키를 되살리고 있을 수 있다. 무조건 삭제하라는 뜻은 아니다. API lane을 일부러 쓰는 사람에게는 필요한 설정일 수 있다. 다만 Claude Code를 구독 usage로 쓰고 싶다면 전역 export는 피하는 편이 안전하다.

특정 작업에서만 API 키를 쓰고 싶다면, 전역 설정보다 일회성 세션이 낫다. 공식 도움말도 필요한 경우에만 임시로 설정하는 쪽을 권한다.

다만 아래처럼 키를 명령어 한 줄에 그대로 쓰는 방식은 조심해야 한다.

ANTHROPIC_API_KEY="your-api-key-here" claude

이 방식은 해당 명령에만 API 키를 넘기는 의도가 더 분명하다. 하지만 shell 설정에 따라 명령어 기록에 실제 키가 남을 수 있다. 그래서 진짜 키를 다룰 때는 secret manager를 쓰거나, 기록이 남지 않는 방식으로 주입하고, 작업이 끝나면 반드시 해제하는 쪽이 안전하다.

단순 로컬 점검이라면 아래 흐름이 더 명확하다.

export ANTHROPIC_API_KEY="your-api-key-here"
claude
unset ANTHROPIC_API_KEY

이 경우에도 실제 키는 터미널 기록, 로그, 스크린샷에 남지 않게 관리해야 한다.

팀 환경이면 더 엄격해야 한다. 개인 노트북에서는 한 번 실수하고 끝날 수도 있지만, 팀 공용 레포의 .env, .claude/settings.json, CI secret, shell profile이 섞이면 비용 추적이 지저분해진다.

settings.json도 같이 봐야 한다

Claude Code settings 문서는 settings.json을 공식 설정 메커니즘으로 설명한다. 여기에는 권한, 환경변수, 도구 동작 같은 설정이 들어갈 수 있다. 즉 환경변수는 shell에만 있는 게 아니다.

프로젝트나 사용자 설정에서 env를 주입하고 있을 수 있다.

확인할 후보는 보통 아래다.

.claude/settings.json
.claude/settings.local.json
~/.claude/settings.json

레포 안에서만 빠르게 확인하려면 이렇게 볼 수 있다.

grep -R "ANTHROPIC_API_KEY" .claude 2>/dev/null

여기서 키 값 자체가 저장되어 있으면 보안상 더 나쁘다. 팀 레포에 커밋될 수 있고, 백업이나 로그에도 남을 수 있다. 설정 파일에는 가능하면 실제 비밀값을 넣지 않는 편이 안전하다.

만약 settings의 env로 API 키를 주입하고 있다면, 그 프로젝트에서는 Claude Code가 API lane으로 붙는 상황을 의도했는지 다시 봐야 한다. 의도했다면 예산과 로그를 API 기준으로 관리하면 된다. 의도하지 않았다면 구독 기반 사용과 충돌할 수 있다.

여기서 중요한 건 선악이 아니다.

API 키 사용 자체가 나쁜 게 아니다.

나쁜 건 내가 어떤 lane을 쓰는지 모르는 상태다.

언제 API 키를 일부러 써도 되나

API 키는 사고 원인이기도 하지만, 제대로 쓰면 좋은 분리 장치다.

예를 들어 자동화 작업은 구독 세션보다 API lane이 더 자연스러울 수 있다. 예약 실행, 배치 변환, 외부 서비스 연동, CI에서 돌아가는 코드 리뷰 같은 작업은 사람이 붙어 있는 Claude Code 세션과 성격이 다르다. 이런 작업은 사용량을 Console에서 따로 추적하고, spend limit을 걸고, 실패 시 중단되게 설계하는 편이 낫다.

반대로 사람이 붙어서 하는 긴 페어 코딩은 구독 lane이 더 편할 수 있다. 작은 질답이나 문서 정리는 Pro로 충분할 수 있고, 큰 레포 탐색이나 긴 리팩터링은 Max가 덜 끊길 수 있다.

그래서 내 기준은 이렇게 나눈다.

작업	추천 lane	이유
수동 질답, 작은 수정	Pro 또는 Max 구독	예측 가능한 고정비가 편하다
긴 레포 탐색, 리팩터링	Max 구독	세션 사용량 여유가 더 중요하다
CI, cron, batch 작업	API	사용량 추적과 제한을 분리하기 좋다
고객 서비스나 제품 기능	API 또는 managed runtime	구독 세션으로 돌릴 일이 아니다
실험성 도구 테스트	별도 API key	사고가 나도 범위를 좁히기 쉽다

API 키를 쓴다면 이름을 붙이는 게 좋다.

personal-dev

blog-automation

ci-review

sandbox-test

이런 식으로 구분해야 나중에 Console usage를 봐도 무엇이 돈을 썼는지 알 수 있다. 키 하나로 모든 걸 돌리면 비용 분석은 바로 안개 속으로 들어간다.

/cost를 볼 때 조심할 점

Claude Code 비용 문서는 /cost가 API 토큰 사용량을 보여주는 명령이라고 설명한다. 동시에 Pro나 Max 구독자는 구독에 포함된 사용량이 있기 때문에, /cost의 숫자를 그대로 청구액처럼 보면 안 된다는 흐름도 같이 나온다.

그래서 /cost는 이런 용도로 보는 게 좋다.

이 세션이 토큰을 많이 쓰고 있나.

큰 로그를 너무 많이 읽었나.

subagent를 많이 띄워서 context가 커졌나.

MCP 서버나 CLAUDE.md가 불필요하게 비대하지 않나.

반면 실제 카드 청구나 API 청구 확인은 Console Usage와 Billing이 더 맞다. 구독자는 /stats로 사용 패턴을 확인하는 쪽이 문서 흐름에 더 맞다.

말하자면 /cost는 체중계가 아니라 활동량계에 가깝다.

숫자가 무섭다고 바로 요금제부터 바꾸면 순서가 틀릴 수 있다. 먼저 인증 경로를 보고, 그 다음 context와 workflow를 보고, 마지막에 요금제를 본다.

돈이 새는 대표 장면

1. 예전에 테스트한 API 키가 shell profile에 남아 있다

가장 흔하다. 한 번 테스트하려고 .zshrc에 export를 넣어둔다. 그 뒤 Pro나 Max를 결제한다. 그리고 몇 주 뒤 Claude Code를 쓴다.

머릿속으로는 구독 사용이다. 터미널은 API 키를 들고 있다.

이때는 누가 이길까.

환경변수 API 키가 우선될 수 있다.

2. 프로젝트별 설정에서 env를 주입한다

팀 프로젝트에 .claude/settings.json이 있다. 거기서 env를 통해 API 관련 설정을 넣는다. 개발자는 그냥 레포를 열고 Claude Code를 실행한다.

이 경우 프로젝트 설정이 의도한 동작인지 확인해야 한다. 특히 새 팀원이 들어왔을 때 이 프로젝트는 API lane으로 돈이 나간다는 설명이 없으면 나중에 꼭 헷갈린다.

3. CI secret과 로컬 secret이 같은 이름이다

CI에서는 ANTHROPIC_API_KEY가 당연히 필요할 수 있다. 문제는 로컬에서도 같은 이름을 전역으로 쓰는 경우다. 자동화와 수동 작업이 같은 키를 물면, 어떤 사용량이 어디서 나왔는지 나중에 나누기 어렵다.

가능하면 CI용 키와 로컬 실험 키는 분리한다. 그리고 로컬에서는 필요한 순간에만 켠다.

4. /cost 숫자만 보고 요금제 문제라고 판단한다

숫자가 보이면 사람은 바로 돈으로 읽는다. 그런데 /cost는 문서상 API 토큰 사용량을 보여주는 도구에 가깝다. 구독자라면 그 숫자가 실제 청구액인지부터 단정하면 안 된다.

인증 경로를 먼저 보자. 그 다음 Console을 보자. 그 다음 요금제를 보자.

순서가 비용이다.

팀에서는 규칙을 하나로 고정해야 한다

개인 사용자는 실수해도 본인 카드만 아프다. 팀은 다르다.

팀에서 Claude Code를 쓴다면 아래 규칙을 문서로 박아두는 게 좋다.

사람의 수동 개발은 기본적으로 구독 lane으로 쓴다.
자동화, CI, cron은 API lane으로 분리한다.
ANTHROPIC_API_KEY는 전역 shell profile에 넣지 않는다.
프로젝트 settings에 API 키를 직접 저장하지 않는다.
/status 확인을 비용 이슈 점검의 첫 단계로 둔다.
API 키는 용도별로 나누고 spend limit을 붙인다.
비용 리뷰 때 /cost, /stats, Console Usage를 구분해서 본다.

이 정도만 있어도 비용 대화가 훨씬 깨끗해진다.

누가 많이 썼냐보다 먼저 볼 건 어떤 lane으로 썼냐다.

hooks로 막을 수 있을까

Claude Code hooks 문서는 PreToolUse 같은 이벤트에서 도구 실행 전 검사를 넣을 수 있다고 설명한다. 예를 들어 Bash 명령을 실행하기 전에 위험한 명령을 막거나, 특정 조건에서 허용·거부·질문으로 돌릴 수 있다.

비용 관점에서도 아이디어는 비슷하다.

API 키가 잡힌 상태에서 특정 명령을 실행하려 할 때 경고를 띄우는 방식이다.

다만 hooks가 인증 우선순위 자체를 바꾸는 마법 버튼은 아니다. Claude Code가 어떤 인증으로 붙는지 확인하는 첫 단계는 여전히 /status와 환경변수 점검이다. hooks는 반복 사고가 나는 팀에서 보조 안전장치로 붙이는 쪽에 가깝다.

다만 이 글에서는 곧바로 복잡한 hook부터 추천하지 않는다. 처음엔 더 단순하게 가는 게 낫다.

먼저 팀 문서에 규칙을 적는다. 그 다음 /status 확인 루틴을 만든다. 그 다음 shell profile에서 전역 API 키를 제거한다. 마지막으로 반복 사고가 나면 hook이나 wrapper script를 붙인다.

운영 도구는 문제를 줄여야 한다. 처음부터 도구가 문제보다 커지면, 그건 또 다른 비용이다.

개인 사용자를 위한 안전 루틴

개인이라면 아래 루틴만 기억해도 충분하다.

Claude Code를 켜기 전 터미널에서 한 번 본다.

echo $ANTHROPIC_API_KEY

값이 나오면 내가 지금 API lane을 쓸 의도가 있는지 묻는다. 의도가 없으면 지운다.

unset ANTHROPIC_API_KEY

Claude Code를 켠 뒤 /status를 본다. 이때 원하는 인증 방식이 맞는지 확인한다.

비용이 이상하면 /cost만 보지 말고 Console Usage도 본다. 구독 사용량 패턴은 /stats 쪽을 참고한다.

그리고 전역 shell profile에 API 키를 넣어두지 않는다. 필요한 순간에만 일회성으로 켠다.

이게 제일 덜 멋있고, 제일 잘 먹힌다.

비용 관리는 원래 멋보다 반복이다.

팀 사용자를 위한 안전 루틴

팀이라면 개인 루틴에 몇 가지가 더 붙는다.

첫째, API key owner를 분리한다. 개인 키로 팀 자동화를 돌리지 않는다. 팀 자동화는 팀 계정이나 전용 workspace 기준으로 둔다.

둘째, secret 이름은 같더라도 용도를 나눈다. 로컬 실험용 키와 CI 키가 같은 값이면 추적이 어렵다.

셋째, 신규 온보딩 문서에 Claude Code 인증 확인을 넣는다. 개발 환경 세팅 문서에 /status와 ANTHROPIC_API_KEY 확인 명령을 넣으면 된다.

넷째, 비용 리뷰에서는 사람 사용량과 자동화 사용량을 분리해서 본다. 같이 보면 누가 잘못했는지만 찾게 된다. 분리해서 보면 어느 workflow가 비싼지 보인다.

다섯째, 큰 자동화에는 spend limit을 먼저 둔다. Claude Code 비용 문서는 Console에서 spend limit과 usage reporting을 볼 수 있는 흐름을 안내한다. 팀이라면 이걸 선택이 아니라 안전장치로 봐야 한다.

기존 비용 글과 어떻게 이어지나

이 글은 큰 비용 전략 글의 하위 글이다.

Claude Code 비용 줄이는 운영 루틴 2026은 Pro·Max·API를 작업별로 나누는 기준표였다. 이번 글은 그중 API 키가 의도치 않게 켜져 있는 경우만 따로 떼어낸 체크리스트다.

Claude Code Max 요금제가 아깝게 느껴질 때는 Max가 비싼지, 운영이 비싼지 보는 글이었다. 이번 글은 그 전에 인증 경로부터 보자는 보강 글이다.

Claude 구독 차단 이후 뭐가 달라지나는 seat, API, hosted runtime, 직접 하네스의 lane을 나눴다. 이번 글은 그 lane 분리의 가장 작은 실전 단위다.

즉 내부링크 흐름은 이렇게 잡으면 좋다.

비용이 이상하다.
이 글에서 API 키 인증 경로를 확인한다.
문제가 인증 경로가 아니라면 비용 운영 루틴 글로 간다.
Max 자체가 아깝게 느껴진다면 Max 운영 습관 글로 간다.
구독, API, 하네스 구조를 비교해야 하면 구독 차단 이후 글로 간다.

이렇게 묶으면 TECHTAEK의 Claude Code 비용 허브가 더 단단해진다.

검색에서도 좋고, 독자 입장에서도 덜 헤맨다.

바로 쓸 수 있는 체크리스트

Claude Code 비용이 이상할 때 아래 순서로 보면 된다.

Claude Code 안에서 /status를 실행했다.
터미널에서 echo $ANTHROPIC_API_KEY를 확인했다.
값이 있다면 내가 API lane을 의도했는지 확인했다.
의도하지 않았다면 unset ANTHROPIC_API_KEY 후 새 세션을 시작했다.
.zshrc, .bashrc, .zprofile에 전역 export가 있는지 확인했다.
.claude/settings.json과 .claude/settings.local.json에 env 주입이 있는지 봤다.
CI secret과 로컬 secret이 같은 키인지 확인했다.
/cost 숫자를 실제 청구액으로 단정하지 않았다.
Console Usage와 Billing에서 API 사용량을 따로 확인했다.
자동화 작업은 API lane으로, 사람 수동 작업은 구독 lane으로 나눴다.

이 체크리스트를 한 번 돌렸는데도 비용이 이상하면 그때는 요금제나 workflow를 본다.

처음부터 Max를 욕하거나 API를 욕하면 멀리 간다.

먼저 연결부터 보자.

FAQ

Pro나 Max 구독 중이면 API 요금이 절대 안 나오나

아니다. 구독을 갖고 있어도 ANTHROPIC_API_KEY 같은 API 키 환경변수가 활성화되어 있으면 API 계정 기준으로 사용될 수 있다. 공식 도움말은 환경변수 API 키가 구독 인증보다 우선할 수 있다고 안내한다.

/cost에 금액이 나오면 그게 실제 카드 청구액인가

그렇게 바로 보면 위험하다. Claude Code 비용 문서는 /cost를 API 토큰 사용량 확인 도구로 설명한다. 실제 청구 확인은 API 사용자의 경우 Console Usage와 Billing을 보는 쪽이 맞다. Pro나 Max 구독자는 /stats로 사용 패턴을 보는 흐름이 더 적합하다.

API 키를 아예 쓰지 말아야 하나

아니다. 자동화, CI, batch 작업에는 API 키가 더 자연스러울 수 있다. 문제는 API 키를 쓰는 게 아니라, 내가 API 키를 쓰고 있다는 사실을 모르는 것이다.

전역 shell profile에 API 키를 넣어두면 안 되나

개인 실험에서는 편할 수 있다. 하지만 Claude Code를 구독 lane으로 주로 쓰려면 전역 export는 사고를 만들기 쉽다. 필요할 때만 해당 세션이나 해당 명령에 API 키를 넘기는 편이 더 명확하다.

settings.json에 API 키를 넣어도 되나

실제 비밀값을 프로젝트 settings에 넣는 건 피하는 편이 좋다. 레포에 커밋되거나 백업, 로그, 공유 과정에 남을 수 있다. settings는 동작 규칙을 두고, secret은 안전한 secret store나 환경별 관리 도구로 분리하는 쪽이 낫다.

팀에서는 무엇부터 정해야 하나

수동 개발은 구독 lane, 자동화는 API lane으로 나누는 원칙부터 정하면 된다. 그리고 /status 확인을 비용 이슈의 첫 단계로 넣는다. 이 두 개만 있어도 비용 대화가 훨씬 덜 감정적이 된다.

마지막 정리

Claude Code 비용이 이상할 때 제일 먼저 볼 건 요금제가 아니다.

ANTHROPIC_API_KEY다.

Pro냐 Max냐를 따지기 전에, 지금 세션이 구독으로 붙었는지 API 키로 붙었는지 확인해야 한다. 그걸 모르면 비용 최적화는 시작부터 어긋난다.

실전 순서는 간단하다.

/status를 본다.

터미널에서 ANTHROPIC_API_KEY를 본다.

settings 파일을 본다.

Console Usage를 본다.

그 다음에 Pro, Max, API를 나눈다.

돈 새는 문제는 대개 거창하지 않다.

가끔은 터미널에 남은 한 줄이 제일 비싸다.

Claude Code에서 ANTHROPIC_API_KEY가 잡히면 Pro·Max 말고 API 요금이 나올까 2026 — /status와 터미널 체크 순서