Claude Code Custom API 연결 가이드

준비: 필요한 두 가지 설정값

중요

ANTHROPIC_BASE_URL에는 다음 값만 입력하세요:

textCopy

https://api.ourtoken.ai

/v1/messages를 추가하지 마세요. Claude Code가 요청 경로를 자동으로 붙입니다.

1단계: Claude Code 설치

Mac 사용자

터미널을 열고 다음 명령을 붙여 넣어 실행하세요:

curl -fsSL https://claude.ai/install.sh | bash

설치 후 claude 명령을 실행할 수 있도록 Claude Code를 시스템 PATH에 추가합니다:

p="$HOME/.local/bin"; grep -qxF 'export PATH="$HOME/.local/bin:$PATH"' "$HOME/.zshrc" 2>/dev/null || echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.zshrc"; export PATH="$p:$PATH"; claude --version

Windows 사용자

시작 메뉴에서 PowerShell을 검색해 열고 다음 명령을 붙여 넣어 실행하세요:

irm https://claude.ai/install.ps1 | iex

설치 후 claude 명령을 실행할 수 있도록 Claude Code를 시스템 PATH에 추가합니다:

$p="$env:USERPROFILE\.local\bin"; $u=[Environment]::GetEnvironmentVariable("Path","User"); if (($u-split";")-notcontains$p){[Environment]::SetEnvironmentVariable("Path",$u.TrimEnd(";")+";"+$p,"User")}; $env:Path+=";$p"; claude --version

다음을 실행하세요:

claude --version

버전 번호가 표시되면 설치가 완료된 것입니다.

Claude Code 버전 번호 스크린샷

⚠️ claude 명령이 실행되지 않으면 Claude Code가 시스템 PATH에 추가되었는지 확인하세요.

⚠️ 설치 후 Anthropic 계정으로 로그인하지 마세요. 다음 단계에서 OurToken API Key로 직접 연결합니다.

2단계: OurToken 자격 증명 설정

Claude Code 설치가 완료되면 다음 설정 파일을 엽니다. 파일이나 폴더가 없으면 직접 만드세요.

설정 파일 경로

• Mac:

  textCopy

  ~/.claude/settings.json
  

• Windows:

  textCopy

  C:\Users\<username>\.claude\settings.json
  

Windows에서는 <username>을 자신의 Windows 사용자 이름으로 바꾸세요.

다음 내용을 settings.json에 작성하고 your ourtoken api key를 자신의 OurToken API Key로 바꾸세요:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your ourtoken api key",
    "ANTHROPIC_BASE_URL": "https://api.ourtoken.ai",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ENABLE_TOOL_SEARCH": "true"
  },
  "model": "sonnet",
  "effortLevel": "medium",
  "autoUpdatesChannel": "latest"
}

참고

설정 파일의 모델은 다른 지원 모델로 변경할 수 있습니다. 현재 지원되는 모델은 OurToken API Keys 페이지에서 확인하세요.

OurToken 모델 목록 스크린샷

3단계: 설정 확인

터미널 또는 PowerShell을 열고 아무 디렉터리에서 다음을 실행하세요:

claude

Claude Code 인터페이스에 들어간 뒤 간단한 메시지를 입력합니다:

안녕하세요

Claude Code가 정상적으로 응답하면 OurToken API 연결이 성공한 것입니다.

OurToken에 로그인해 Dashboard에서 API 호출 기록과 비용 내역도 확인할 수 있습니다.

• ✅ Claude Code가 정상적으로 응답함
• ✅ OurToken Dashboard에 호출 기록이 표시됨
• ✅ 계정 잔액이 정상적으로 차감됨

위 조건을 만족하면 Claude Code를 사용할 수 있습니다.

다음 단계: VS Code 플러그인과 Claude Code 클라이언트 사용

설정을 완료하면 VS Code + Claude Code 플러그인 또는 Claude Code 클라이언트에서도 바로 Claude Code를 사용할 수 있습니다. 이들은 로컬에 이미 설정된 OurToken 자격 증명을 재사용하므로 다시 설정할 필요가 없습니다.