Claude Code 통합 · 종량제 API
Claude Code 서드파티 API 설정
Claude Code는 환경 변수에서 API 엔드포인트와 키를 읽습니다. ANTHROPIC_BASE_URL을 aicodewith로 지정하고 API 키를 추가하면 터미널에서 Claude Opus 5.5, Sonnet 5.5 등을 사용할 수 있으며 토큰당 과금됩니다.
Claude Code 요금제 허용량을 초과한 개발자, 키별 정산이 필요한 팀, 잔액에서 토큰당 결제를 선호하는 모든 사용자를 위한 것입니다.
- ANTHROPIC_BASE_URL
- https://api.aicodewith.ai
- ANTHROPIC_AUTH_TOKEN
- AI Code With API 키
- ANTHROPIC_API_KEY
- ""
- Model
- claude-sonnet-5-5 (예시, /model로 전환)
1분 만에 설정
나중에 사용할 터미널을 위해 이 키를 저장하세요
로그인하면 이 명령에 사용자의 키가 포함됩니다. 복사해서 한 번 실행하면 도구가 테스트한 위치에 키를 보관합니다.
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
API 키 생성
대시보드에 로그인하고 API Keys 페이지에서 키를 생성하세요. 일일, 월간 또는 총 지출 한도를 설정할 수 있습니다.
- 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
첫 실행 로그인 건너뛰기
~/.claude.json에 hasCompletedOnboarding을 추가하여 Claude Code가 Anthropic 계정 로그인을 요구하지 않도록 하세요.
~/.claude.json{ "hasCompletedOnboarding": true }~/.claude.json이 이미 존재하면 덮어쓰지 말고 기존 JSON에 이 필드 하나를 추가하세요.
- 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으로 전역 설치하세요:
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의 보증을 받지 않습니다.