Claude Code API 키: 1분 만에 발급하고 설정하기

API 키 vs 구독 로그인

Claude Code에는 두 가지 인증 방법이 있습니다. /login을 사용하면 Claude Pro 또는 Max 요금제가 사용되며, 사용량은 해당 요금제의 5시간 및 주간 허용 한도에 포함됩니다. API 키를 사용하면 구성한 API 엔드포인트로 요청을 보내며 토큰 단위로 요금을 지불합니다.

API 키가 구성되면 Claude Code는 해당 키로 요금이 청구되며 Claude 요금제 허용 한도를 사용하지 않습니다. 변수를 제거하고 /login을 실행하면 다시 전환됩니다.

Claude Code 사용 한도 작동 방식

키를 얻고 잔액을 충전하는 방법

1. 1. 회원가입

   이메일, Google 또는 GitHub으로 aicodewith.ai 계정을 만듭니다.

2. 2. 잔액 충전

   결제는 선불 방식입니다. 해외 계정은 Stripe를 통해 카드로 USD로 결제하며, 중국 본토 계정은 Alipay를 통해 CNY로 결제합니다. 결제 지역은 첫 충전 시 선택되며 최소 금액은 결제 화면에 표시됩니다.

3. 3. 키 생성

   대시보드에서 API Keys를 열고 키를 생성합니다. 선택적으로 일일, 월간 또는 총 지출 한도를 설정할 수 있습니다. 키를 복사하고 다음 단계에서 Claude Code에 붙여넣습니다.

잔액은 사용하는 모델과 채널의 가격에 따라 토큰 단위로 차감됩니다. 크레딧은 1년간 유효하며, 충전 후 90일 이내에 사용하지 않은 잔액을 환불받을 수 있습니다. 이때 10% 수수료가 적용됩니다.

충전 옵션결제 및 환불 FAQ환불 정책

"From" prices are based on the Economy channel, the lowest-priced Claude channel currently listed (about 19% of Anthropic list price). Other channels cost more; the rate depends on the channel you choose, and the models page is always the source of truth.

키를 설정할 위치

한 곳을 선택하세요. settings.json이 가장 안정적입니다. Claude Code CLI와 IDE 확장 기능이 모두 이 파일을 읽기 때문입니다. 셸 변수는 빠른 테스트나 CI 작업에 유용합니다.

1. 1. 옵션 A: ~/.claude/settings.json (권장)

   macOS 및 Linux: ~/.claude/settings.json. Windows: %USERPROFILE%\.claude\settings.json. 파일이 없으면 생성하고, 이미 있으면 env 블록을 병합하세요.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

2. 2. 첫 실행 로그인 화면 건너뛰기

   새 설치에서는 ~/.claude.json에 이 필드를 추가하여 Claude Code가 Anthropic 계정 로그인을 요구하지 않게 합니다. 파일이 이미 있으면 덮어쓰지 말고 필드를 추가하세요.

   ~/.claude.json

   {
     "hasCompletedOnboarding": true
   }

3. 3. 옵션 B: 셸 환경 변수

   ~/.zshrc 또는 ~/.bashrc에 다음 줄을 추가하고(또는 CI 단계에서 export) 새 터미널을 엽니다.

   bash / zsh

   export ANTHROPIC_BASE_URL="https://api.aicodewith.ai"
   export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
   export ANTHROPIC_API_KEY=""

4. 4. Windows(PowerShell)에서의 옵션 B

   사용자 수준 변수를 설정합니다. 그런 다음 새 터미널을 엽니다.

   PowerShell

   [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicodewith.ai", "User")
   [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")

ANTHROPIC_BASE_URL은 도메인만 있는 https://api.aicodewith.ai입니다. /v1을 추가하지 마세요. Claude Code가 경로를 직접 추가하며 /v1이 있으면 404 오류가 발생합니다.

ANTHROPIC_AUTH_TOKEN 또는 ANTHROPIC_API_KEY?

ANTHROPIC_API_KEY를 빈 문자열로 설정하는 것이 중요합니다. 셸에 이전 Anthropic 키가 여전히 export되어 있으면 aicodewith 키 대신 그 키가 전송되어 요청이 401 오류로 실패할 수 있습니다.

전체 Claude Code 설정 가이드

정상 작동 확인 및 오류 의미

1. 모든 Claude Code 세션을 닫고 claude를 다시 실행합니다.
2. /status를 실행하여 API 엔드포인트가 api.aicodewith.ai로 표시되는지 확인합니다.
3. 짧은 메시지를 보냅니다. 요청과 요금이 대시보드 사용 기록에 표시됩니다.
4. /cost를 실행하여 세션의 토큰당 비용을 확인합니다.

여러 프로젝트와 기기에서 키 하나 사용하기

키는 특정 기기나 프로젝트에 묶여 있지 않습니다. 노트북, 개발 서버, CI에서 동일한 키를 사용하거나 프로젝트, 팀원, 파이프라인별로 키를 하나씩 만들 수 있습니다. 키를 분리하면 사용 기록과 지출 한도도 분리되며, 다른 키에 영향을 주지 않고 하나만 삭제할 수 있습니다.

• •키별 일일, 월간 또는 총 지출 한도는 제어 불능 에이전트 루프가 잔액을 소진하는 것을 막아 줍니다.
• •사용 기록에는 각 요청의 모델, 토큰, 비용이 표시됩니다.
• •키를 비밀번호처럼 취급하세요. git에 포함하지 말고, 유출된 경우 키를 교체하세요.

다음 단계

구독 없이 Claude Code 사용하기Claude Max 대안: 토큰당 결제Claude Code 사용 한도 설명Claude Code 통합 가이드문서

FAQ