Claude Code 사용량 한도에 걸려도 작업을 이어가는 법: API 크레딧으로 claude-api 명령 만들기 5단계

Team이나 Max 좌석으로 Claude Code를 쓰다 사용량 한도에 걸리면 한도가 풀릴 때까지 작업이 멈춥니다. API 크레딧이 있다면 claude-api라는 명령 하나를 만들어 두고 claude-api -c를 치면 방금 하던 대화를 그대로 이어서 크레딧으로 계속 진행할 수 있습니다. 이 글은 2026년 10월 18일 Claude Startups로 받은 $1,000 크레딧으로 실제로 설정하고 동작을 확인한 순서입니다.

이 글은 이런 분께 필요합니다

• Claude Team(Standard·Premium)이나 Max로 Claude Code를 쓰는데 한도에 자주 걸리는 분
• 스타트업 프로그램, 이벤트 등으로 받은 API 크레딧이 만료 전에 남을까 봐 걱정되는 분
• "Team 좌석 여러 개를 혼자 돌려 쓰면 되지 않나?"를 고민 중인 분(아래에서 왜 안 되는지 먼저 짚습니다)

준비물은 다음과 같습니다.

• macOS 터미널(zsh)과 설치된 Claude Code. 저는 2.1.302 버전에서 확인했습니다
• 크레딧이 들어 있는 Claude Console 조직
• 키를 보관할 비밀번호 관리자(선택)

먼저: 좌석 여러 개를 돌려 쓰는 방식은 안 됩니다

"계정 사용량을 다 쓰면 다음 계정으로 자동으로 넘어가게" 만드는 방법이 종종 공유됩니다. Team 좌석 5개를 혼자 쓰는 경우가 대표적입니다. 하지만 공식 도움말은 각 좌석이 지정된 한 사람에게 배정되고 그 사람만 쓸 수 있으며, 다른 사람 계정으로 작업을 돌려 남은 사용량을 쓰는 것도 안 된다고 명시합니다(Purchase and manage seats on Team plans). 더 필요하면 Premium 좌석으로 올리거나 사용 크레딧(usage credits)을 켜라고 안내합니다.

스타트업 프로그램 혜택은 약관을 지키는 동안에만 유지되므로, 계정 돌려쓰기로 걸리면 Team 할인과 크레딧까지 함께 잃을 수 있습니다. 이 글의 방법은 같은 사람이 자기 API 키로 쓰는 것이라 이 문제와 무관합니다.

방식	한도 이후 비용	비고
좌석 여러 개 돌려 쓰기	없음	정책 위반. 좌석은 한 사람 전용
Team 사용 크레딧 켜기	표준 API 요금, 별도 결제	조직 설정 > 사용량에서 켬
API 키로 이어 쓰기(이 글)	이미 받은 API 크레딧에서 차감	크레딧을 먼저 소진할 때 적합

Step 1. 크레딧 잔액과 자동 충전 상태를 확인합니다

Claude Console > 결제를 엽니다. 오른쪽 위에서 크레딧이 들어 있는 조직이 선택돼 있는지 먼저 확인합니다.

볼 것은 두 가지입니다.

• 프로모션 크레딧 표의 잔액과 만료일. 제 경우 $1,000에 만료일 2027년 4월 5일(UTC)입니다. 위 화면의 $999.99는 이 글의 테스트로 1센트를 쓴 뒤의 값입니다.
• "자동 충전이 꺼져 있습니다. 잔액이 모두 소진되면 API 요청이 중단됩니다." 이 문구가 보이면 크레딧을 다 써도 카드로 결제되지 않고 그냥 멈춥니다. 크레딧 범위 안에서만 쓰고 싶다면 꺼진 상태를 유지합니다.

Step 2. Claude Code 전용 API 키를 만듭니다

Console > API 키에서 키 생성을 누릅니다. 처음에 ID 페더레이션 안내가 나오면 API 키로 계속하기를 누릅니다.

칸	값	이유
이름	claude-code-fallback	나중에 비용을 키별로 구분하기 위해
만료	사용자 지정, 크레딧 만료 다음 날	크레딧이 사라진 뒤 키가 남아 카드 결제로 이어지지 않게
범위	기본 워크스페이스	Admin API를 못 쓰는 최소 권한

키 생성을 누르면 키가 한 번만 표시됩니다. 키 복사로 복사해 비밀번호 관리자에 먼저 저장해 둡니다. 창을 닫으면 다시 볼 수 없습니다.

Step 3. 키를 본인만 읽을 수 있는 파일에 저장합니다

터미널에서 아래를 실행합니다. read -rs는 입력한 내용을 화면에 보여주지 않으므로, 실행 후 복사한 키를 붙여넣고 Enter를 누르면 됩니다.

mkdir -p ~/.config/claude-api && chmod 700 ~/.config/claude-api
read -rs KEY && printf '%s' "$KEY" > ~/.config/claude-api/key && chmod 600 ~/.config/claude-api/key && unset KEY
ls -l ~/.config/claude-api/key   # -rw------- 로 나오면 정상

키를 .zshrc에 export ANTHROPIC_API_KEY=...로 넣지 않는 이유는, 그렇게 하면 평소의 claude까지 항상 API 키로 실행돼 Team·Max 사용량 대신 크레딧이 먼저 깎이기 때문입니다. 키는 아래 명령을 실행할 때만 불러옵니다.

Step 4. claude-api 명령을 만듭니다

Claude Code가 설치된 폴더(~/.local/bin)에 실행 파일을 하나 만듭니다. which claude로 경로가 다르면 마지막 줄의 경로를 맞춰 바꿉니다.

cat > ~/.local/bin/claude-api <<'EOF'
#!/bin/zsh
# Claude Code를 Console API 키(크레딧)로 실행합니다.
KEY_FILE="$HOME/.config/claude-api/key"
if [[ ! -r "$KEY_FILE" ]]; then
  echo "API 키 파일이 없습니다: $KEY_FILE" >&2
  exit 1
fi
export ANTHROPIC_API_KEY="$(<"$KEY_FILE")"
exec "$HOME/.local/bin/claude" "$@"
EOF
chmod 755 ~/.local/bin/claude-api

.zshrc를 건드리지 않으므로 dotfiles를 git으로 관리하고 있어도 충돌이 없습니다. 이 명령은 ANTHROPIC_API_KEY를 그 실행에만 넣고 나머지 옵션은 그대로 claude에 넘깁니다.

Step 5. 실제로 크레딧으로 나가는지 확인합니다

세 가지를 확인했습니다.

1) 응답이 오는지

claude-api -p "Reply with exactly: OK" --model haiku
# OK

2) 로그인 계정이 아니라 키가 쓰이는지. 일부러 틀린 키를 넣으면 실패해야 합니다.

ANTHROPIC_API_KEY=sk-ant-invalid-test claude -p "Reply OK" --model haiku
# Invalid API key · Fix external API key

환경 변수의 키가 로그인보다 우선한다는 뜻이므로, claude-api로 실행한 요청은 크레딧에서 차감됩니다. 실제로 테스트 후 Console 잔액이 $1,000.00에서 $999.99로 줄었습니다(Step 1 화면).

3) 직전 대화를 이어가는지

claude-api -p "Remember this word: PINEAPPLE. Reply only: saved" --model haiku
# saved
claude-api -c -p "What word did I ask you to remember? Reply with the word only." --model haiku
# PINEAPPLE

Claude Code는 대화 기록을 내 컴퓨터(프로젝트 폴더 기준)에 저장하므로, 같은 폴더에서 -c를 붙이면 인증 방식이 바뀌어도 직전 대화를 이어갑니다.

쓰는 법

상황	명령
평소(Team·Max 좌석 사용량)	claude
한도에 걸린 작업을 크레딧으로 이어갈 때	claude-api -c
처음부터 크레딧으로 돌릴 큰 작업	claude-api

크레딧은 만료되면 사라집니다. 제 경우 약 5.5개월 동안 $1,000을 써야 하므로 한 달에 $180 정도가 필요한 페이스입니다. 한도에 걸릴 때만 쓰면 남기 쉬워서, 긴 리팩터링이나 배치 작업처럼 오래 걸리는 일은 처음부터 claude-api로 돌리고 있습니다. 매달 1일에 잔액과 지난달 사용액을 확인하는 알림도 걸어 두었습니다.

Max에서 Team으로 옮겼다면: 개인 구독 해지

Team을 시작해도 기존 개인 Max 구독은 자동으로 해지되지 않습니다. claude.ai 왼쪽 아래 계정 메뉴에서 개인 계정(예: "개인 Max")으로 바꾼 뒤 설정 > 결제 > 구독 취소 > 해지를 누릅니다. Team 조직이 선택된 상태에서 결제 설정을 열면 Team 조직의 결제 화면이 열리고, 그 화면에도 해지 버튼이 있습니다. 거기서 누르면 Team이 해지되니 화면 제목이 "맥스 플랜"인지 먼저 확인합니다.

해지하면 "구독이 ○월 ○일에 취소될 예정입니다"로 바뀌고, 그날까지는 Max를 그대로 쓸 수 있습니다. 마음이 바뀌면 구독 갱신으로 되돌립니다. 계정 자체를 삭제하지 않으면 기존 대화와 프로젝트도 남습니다.

문제별 정리

증상	원인	해결
API 키 파일이 없습니다	Step 3의 파일이 없거나 권한 문제	ls -l ~/.config/claude-api/key로 확인 후 다시 저장
Invalid API key	키를 잘못 붙여넣었거나 만료·삭제됨	Console에서 키 상태 확인, 새 키로 Step 3 반복
평소 claude도 크레딧이 깎임	.zshrc 등에 ANTHROPIC_API_KEY가 export돼 있음	그 줄을 지우고 새 터미널을 엽니다
claude-api -c가 다른 대화를 이어감	다른 폴더에서 실행	원래 작업하던 프로젝트 폴더에서 실행
크레딧을 다 썼는데 요청이 멈춤	자동 충전 꺼짐(의도된 동작)	그대로 두거나, 필요하면 크레딧 구매
command not found: claude-api	~/.local/bin이 PATH에 없음	which claude로 나온 폴더에 파일을 만듭니다

마무리

정리하면 Console에서 키 하나를 만들고, 파일 하나와 실행 파일 하나를 두는 것으로 끝납니다. 좌석 한도는 좌석 한도대로 쓰고, 넘치는 작업은 내 크레딧으로 이어가는 구조라 계정을 돌려 쓰다 문제가 생길 걱정이 없습니다. 크레딧이 실제로 얼마나 빨리 줄어드는지는 한 달 뒤 사용액을 보고 이어서 정리하겠습니다.