Claude Code 통합 · 종량제 API

Claude Code 서드파티 API 설정

Claude Code는 환경 변수에서 API 엔드포인트와 키를 읽습니다. ANTHROPIC_BASE_URL을 aicodewith로 지정하고 API 키를 추가하면 터미널에서 Claude Opus 5.5, Sonnet 5.5 등을 사용할 수 있으며 토큰당 과금됩니다.

Claude Code 요금제 허용량을 초과한 개발자, 키별 정산이 필요한 팀, 잔액에서 토큰당 결제를 선호하는 모든 사용자를 위한 것입니다.

설정 미리보기~/.claude/settings.json
ANTHROPIC_BASE_URL
https://api.aicodewith.ai
ANTHROPIC_AUTH_TOKEN
AI Code With API 키
ANTHROPIC_API_KEY
""
Model
claude-sonnet-5-5 (예시, /model로 전환)

1분 만에 설정

나중에 사용할 터미널을 위해 이 키를 저장하세요

로그인하면 이 명령에 사용자의 키가 포함됩니다. 복사해서 한 번 실행하면 도구가 테스트한 위치에 키를 보관합니다.

bash
dir="$HOME/.claude"
settingsFile="$dir/settings.json"
claudeJsonFile="$HOME/.claude.json"
mkdir -p "$dir"
cat > "$settingsFile" << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-***",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}
EOF
cat > "$claudeJsonFile" << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF
echo "配置完成!"
claude

로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기

복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법

대시보드 온보딩에서 제공하는 설정과 정확히 동일합니다.

  1. 1

    API 키 생성

    대시보드에 로그인하고 API Keys 페이지에서 키를 생성하세요. 일일, 월간 또는 총 지출 한도를 설정할 수 있습니다.

  2. 2

    settings.json 작성

    macOS / Linux: ~/.claude/settings.json. Windows: %USERPROFILE%\.claude\settings.json. 파일이 없으면 생성하세요.

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": "",
        "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
      }
    }
  3. 3

    첫 실행 로그인 건너뛰기

    ~/.claude.json에 hasCompletedOnboarding을 추가하여 Claude Code가 Anthropic 계정 로그인을 요구하지 않도록 하세요.

    ~/.claude.json
    {
      "hasCompletedOnboarding": true
    }

    ~/.claude.json이 이미 존재하면 덮어쓰지 말고 기존 JSON에 이 필드 하나를 추가하세요.

  4. 4

    Claude Code 재시작

    모든 Claude Code 세션을 닫고 claude를 다시 실행한 뒤 테스트 메시지를 보내세요.

각 변수의 역할

Claude Code는 시작할 때 settings.json의 env 블록을 읽어 환경 변수로 사용합니다.

ANTHROPIC_BASE_URL
API 엔드포인트입니다. https://api.aicodewith.ai를 /v1 없이 기본 도메인으로 사용하세요. Claude Code가 경로를 자체적으로 추가합니다.
ANTHROPIC_AUTH_TOKEN
aicodewith API 키이며 Authorization: Bearer로 전송됩니다.
ANTHROPIC_API_KEY
시스템에 이미 설정된 Anthropic 키와 충돌하지 않도록 비워 두세요.

API 키를 설정하면 Claude Code는 Claude 요금제 허용량 대신 API 과금을 사용합니다. 사용량은 aicodewith 잔액에서 토큰당 차감됩니다.

모델 선택

Claude Code에서 /model을 입력해 전환하세요. 일반적인 설정:

Claude Sonnet 5.5

일상적인 코딩을 위한 기본값이며 속도와 가격이 균형 잡혀 있습니다.

Claude Opus 5.5

대규모 리팩터링, 아키텍처 작업 및 찾기 어려운 버그에 적합합니다.

Claude Haiku 5.5

서브에이전트와 소규모 작업 배치에 적합하며 가장 저렴한 옵션입니다.

사용 가능한 모델과 실시간 가격은 모델 페이지를 참조하세요. /models

작동하는지 확인

  • Claude Code에서 /status를 실행하고 API 엔드포인트가 api.aicodewith.ai인지 확인하세요.
  • 메시지를 보낸 후 요청과 청구 내역이 대시보드 사용 기록에 나타납니다.
  • 세션의 토큰당 비용을 보려면 /cost를 실행하세요.

Claude 요금제로 다시 전환

settings.json에서 이 env 항목들을 제거한 다음 Claude Code에서 /login을 실행해 Anthropic 계정에 로그인하세요.

Claude Code가 아직 없나요?

Claude Code는 Node.js 18 이상이 필요합니다. npm으로 전역 설치하세요:

bash
npm install -g @anthropic-ai/claude-code

현재 설치 방법은 Anthropic 문서를 따르세요. 시작하려면 프로젝트 폴더에서 claude를 실행하세요.

npm의 Claude Code

자주 묻는 질문

base URL에 /v1이 포함되어야 하나요?

아니요. ANTHROPIC_BASE_URL을 https://api.aicodewith.ai로만 설정하세요. /v1을 추가하면 404 오류가 발생합니다.

Claude 요금제의 5시간 또는 주간 한도가 계속 적용되나요?

요청은 요금제 허용량을 사용하지 않습니다. aicodewith 잔액에서 토큰당 청구됩니다. 자체 속도 및 동시성 한도는 문서에 설명된 대로 계속 적용됩니다.

지출을 어떻게 제어하나요?

대시보드에서 각 API 키에 일일, 월간 또는 총 지출 한도를 설정하고, Claude Code에서 /cost를 실행해 언제든 세션 비용을 확인하세요.

VS Code 또는 JetBrains용 Claude Code 확장 프로그램과 작동하나요?

예. 확장 프로그램은 CLI와 동일한 ~/.claude/settings.json을 읽으므로 한 번만 설정하면 됩니다.

aicodewith는 Anthropic과 제휴되어 있나요?

아니요. aicodewith는 독립적인 제3자 API 서비스입니다. Claude 및 Claude Code는 Anthropic의 상표입니다.

일반적인 오류

대부분의 문제는 base URL, 키 또는 남아 있는 환경 변수에서 발생합니다.

401 / 잘못된 API 키

증상: 메시지를 보내자마자 인증이 실패합니다.

원인: 잘못되었거나 삭제된 키이거나, 시스템 ANTHROPIC_API_KEY가 설정을 덮어쓰고 있습니다.

  • 키를 다시 복사하고 불필요한 공백이 있는지 확인하세요
  • ANTHROPIC_API_KEY가 비어 있는지 확인하세요
  • 남아 있는 값을 찾으려면 echo $ANTHROPIC_API_KEY를 실행하세요

404 찾을 수 없음

증상: 요청이 404를 반환합니다.

원인: base URL에 /v1이 포함되어 있거나 오타가 있습니다.

  • https://api.aicodewith.ai로 변경하세요
  • 저장하고 Claude Code를 완전히 재시작하세요

여전히 "세션 한도에 도달했습니다"가 표시됨

증상: 여전히 Claude 요금제의 한도 메시지가 표시됩니다.

원인: 설정이 활성화되지 않았고 Claude Code가 여전히 구독 로그인을 사용 중입니다.

  • settings.json 경로와 JSON이 유효한지 확인하세요
  • 모든 세션을 닫고 재시작하세요
  • 현재 엔드포인트를 보려면 /status를 실행하세요

429 / 속도 제한됨

증상: 가끔 429 응답이 발생합니다.

원인: 요청 속도 또는 동시성이 속도 제한을 초과했습니다.

  • 병렬 서브에이전트를 더 적게 실행하세요
  • 잠시 기다렸다가 다시 시도하세요
  • 잔액과 키의 지출 한도를 확인하세요

Claude Code 사용량이 부족한가요?

Pro 및 Max의 5시간 및 주간 한도가 어떻게 작동하는지, 그리고 구독, 사용량 크레딧, 종량제 API가 비용에서 어떻게 비교되는지 알아보세요.

Claude Code 사용량 한도 가이드 읽기

출처

관련 링크

Claude 및 Claude Code는 Anthropic PBC의 상표입니다. 이 페이지는 Anthropic과 제휴하거나 Anthropic의 보증을 받지 않습니다.