설정

API 키 생성 및 복사

요금 페이지에서 플랜을 선택한 다음 대시보드의 API 키 페이지를 여세요. API 키를 생성하고 Claude Code용 AWSQ 또는 CCMAX 채널을 선택한 뒤, 필요에 따라 쿼터와 만료일을 설정하세요. 이미 API 키가 있다면 해당 키를 바로 사용할 수 있습니다.

claude-opus-5-5와 claude-sonnet-5-5 모델은 AWSQ와 CCMAX 채널에서 사용할 수 있습니다. 요청 시 claude-opus-5.5와 claude-sonnet-5.5 별칭도 사용할 수 있습니다. Opus 5.5 기본 요금은 백만 토큰당 입력 $4, 캐시 읽기 $0.20, 출력 $20이며, AWSQ는 쿼터를 1배, CCMAX는 2.5배로 소비합니다.

상위 서비스에서 실제로 Fast 모드를 사용하면 Opus 5.5의 기본 요금과 캐시 요금이 추가로 2배가 됩니다. 응답의 usage.speed를 기준으로 청구합니다. Anthropic Fast 모드 요금을 참고하세요.

API 키와 그 키가 쓰는 잔액이 모두 남아 있으면 생성 요청이 허용됩니다. 출력 한도와 도구 한도는 그 잔액 검사와 별개입니다. 끝난 요청은 실제 사용량으로 정산하므로, 동시에 보낸 요청은 잔액을 0 아래로 만들 수 있습니다.

Claude Messages에서는 매 요청에 전체 대화와 파일 내용을 직접 보내세요. 스레드 ID로 이어 가면 HTTP 404와 thread_not_found가 반환되므로 클라이언트가 로컬 기록을 다시 보낼 수 있습니다. 공유 계정의 파일 ID와 컨테이너 ID는 사용할 수 없습니다.

공유 자격 증명은 Anthropic이 제공하는 Skill을 지원합니다. 비공개 Skill, 원격 MCP 서버와 비공개 터널에는 테넌트별 인증이 필요합니다.

비용을 관리하려면 max_uses를 명시하세요. Web Search는 120회, Advisor는 최대 2회 및 호출당 출력 1,0244,096토큰으로 지정할 수 있습니다. Advisor는 Web Search 및 클라이언트 도구와 함께 사용할 수 있습니다.

독립 코드 실행에는 활성화한 컨테이너당 약 $0.00417가 부과됩니다(시간당 $0.05 × 5분, 채널 배율 적용 전). 같은 컨테이너 안에서 여러 번 호출해도 한 번만 청구합니다. 요청에 web_search_20260209, web_fetch_20260209 또는 이후 버전이 포함되면 컨테이너 요금이 면제됩니다.

도구 선언을 조정할 수 있는 경우 기본값은 Web Fetch 1회(결과당 텍스트 4,096토큰), Web Search 5회, Advisor 2회(회당 출력 4,096토큰)입니다. PDF에는 텍스트 상한이 적용되지 않습니다. 서명된 사고 기록, 클라이언트와 서버 도구의 혼용 또는 대기 중인 호출이 있으면 선언된 한도를 유지합니다. Mythos는 Advisor로 지원하지 않습니다.

공유 자격 증명의 클라이언트 도구는 직접 호출할 수 있어야 합니다. 프록시는 클라이언트 결과를 기다리는 동안 컨테이너를 일시 중지해야 하는 프로그래밍 방식 호출을 생성 전에 확인합니다. 출력 전 거부라도 bio, frontier_llm, reasoning_extraction 범주에는 입력 요금이 부과됩니다. 폴백은 각 모델의 실제 과금 대상 사용량으로 정산합니다.

Copy 버튼을 클릭합니다.

설정을 저장하거나 명령을 실행하기 전에 아래 모든 예제의 YOUR_DASHBOARD_API_KEY에 복사한 키를 입력하세요.

클라이언트별 Base URL

클라이언트키 채널복사할 Base URL요청 경로
Claude Code / Anthropic SDKAWSQ / CCMAXhttps://api.aiinide.com/v1/messages
OpenAI 호환 클라이언트로 Claude 사용AWSQ / CCMAXhttps://api.aiinide.com/v1/v1/chat/completions · /v1/responses
Codex CLICodexhttps://api.aiinide.com/responses
Gemini CLIGeminihttps://api.aiinide.com/v1beta/models/{model}:streamGenerateContent?alt=sse

Claude Code는 Base URL에 /v1/messages를 붙입니다. 기존 연동을 위해 /api/anthropic 접두사도 지원합니다. 기존 Base URL의 /api/codex 및 /api/gemini 접두사도 기존 키로 계속 사용할 수 있습니다.

Claude Code와 Anthropic SDK가 /v1/messages를 추가하므로 ANTHROPIC_BASE_URL에 /v1을 넣지 마세요. 대시보드 API 키를 사용하며, "stream":true로 스트리밍을 사용할 수 있습니다. 모델 예시: claude-haiku-4-5-20251001.

GET /v1/models는 anthropic-version 헤더가 있으면 페이지네이션을 포함한 Anthropic 형식으로, 없으면 OpenAI 형식으로 반환합니다. Codex 또는 Gemini 키로 GET /v1/models를 호출할 때는 anthropic-version을 생략하세요. 이 헤더를 보내면 400이 반환됩니다.

POST /v1/messages/count_tokens는 기존 호환 응답(input_tokens: 1)을 유지합니다. 정확한 토큰 수가 아니며 업스트림 호출이나 쿼터 소비가 없습니다.

OpenAI 요청에는 전체 대화를 포함해야 하며 Responses는 store=false를 사용합니다. Fast 모드와 서버 도구에는 Anthropic Messages를 사용하세요.

필수 환경 변수 설정

AI in IDE의 CLI와 VS Code 확장 기능이 프록시에 연결되려면 4개의 환경 변수가 필요합니다. 한 번만 등록해 두고, 수정 후에는 터미널이나 IDE를 다시 시작해 새 세션에서도 동일하게 적용되도록 하세요.

macOS 또는 Linux

다음 내용을 ~/.zshrc(zsh) 또는 ~/.bashrc(bash)에 추가합니다.

1
export ANTHROPIC_BASE_URL='https://api.aiinide.com'
2
export ANTHROPIC_AUTH_TOKEN="YOUR_DASHBOARD_API_KEY"
3
export API_TIMEOUT_MS=600000
4
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

파일을 저장한 뒤 source ~/.zshrc를 실행해 변경 사항을 반영합니다.

명령을 하나씩 추가하려면 (bash 사용 시 경로만 바꾸세요):

1
printf 'export ANTHROPIC_BASE_URL=%q\n' 'https://api.aiinide.com' >> ~/.zshrc
2
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_DASHBOARD_API_KEY"' >> ~/.zshrc
3
echo 'export API_TIMEOUT_MS=600000' >> ~/.zshrc
4
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1' >> ~/.zshrc
5
 
6
source ~/.zshrc

Windows

아래 방법 중 편한 방식으로 동일한 변수를 등록할 수 있습니다.

옵션 1 · GUI (권장, 영구 적용)

  1. Win + R → sysdm.cpl 입력 → Enter
  2. 고급 탭 → 환경 변수 클릭
  3. 사용자 변수 영역에서 새로 만들기를 눌러 각각 추가
    • ANTHROPIC_BASE_URL = https://api.aiinide.com
    • ANTHROPIC_AUTH_TOKEN = YOUR_DASHBOARD_API_KEY
    • API_TIMEOUT_MS = 600000
    • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = 1
  4. 창을 모두 닫고 터미널 또는 IDE를 다시 실행

옵션 2 · 명령 프롬프트 (영구)

1
setx ANTHROPIC_BASE_URL "https://api.aiinide.com"
2
setx ANTHROPIC_AUTH_TOKEN "YOUR_DASHBOARD_API_KEY"
3
setx API_TIMEOUT_MS "600000"
4
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

옵션 3 · PowerShell (영구)

1
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.aiinide.com', 'User')
2
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'YOUR_DASHBOARD_API_KEY', 'User')
3
[System.Environment]::SetEnvironmentVariable('API_TIMEOUT_MS', '600000', 'User')
4
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

옵션 4 · 명령 프롬프트 (임시 – 현재 창만)

1
set "ANTHROPIC_BASE_URL=https://api.aiinide.com"
2
set ANTHROPIC_AUTH_TOKEN=YOUR_DASHBOARD_API_KEY
3
set API_TIMEOUT_MS=600000
4
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

AI in IDE 코딩 환경 실행

작업하려는 프로젝트 경로에서 CLI를 실행합니다.

1
cd your-project
2
claude

정상적으로 실행되면 아래와 같은 화면이 나타납니다.

VS Code(또는 다른 IDE)에서 호환 가능한 확장 기능을 사용할 수도 있습니다. 다음과 같은 설정 요청이 뜨면:

환경 변수를 읽지 못한 상태이므로 구성을 다시 확인해 주세요. 필요하다면 설정 파일에 값을 직접 입력할 수 있습니다.

  • CLI 설정 파일

    • macOS/Linux: ~/.claude/settings.json
    • Windows: C:/Users/<UserName>/.claude/settings.json
    1
    {
    2
      "env": {
    3
        "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",
    4
        "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
    5
        "API_TIMEOUT_MS": "600000",
    6
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    7
      }
    8
    }
  • VS Code settings.json – 아래 항목 추가

    1
    "claudeCode.environmentVariables": [
    2
      { "name": "ANTHROPIC_BASE_URL", "value": "https://api.aiinide.com" },
    3
      { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_DASHBOARD_API_KEY" }
    4
    ],

수정 후에는 VS Code 창을 다시 로드하거나 터미널을 재시작하세요.