Claude Code 연동 | API 문서

Claude Code는 Anthropic Messages 프로토콜로 모델을 호출합니다. ANTHROPIC_BASE_URL을 이 페이지의 Anthropic 호환 기본 URL로 설정하세요.

상위 공급자는 Claude Sonnet 4.6(claude-sonnet-4-6)을 지원하지만 RequestBeam에는 현재 공개되지 않았습니다. 활성 연동의 기본 모델이 아닙니다. 모델을 호출하기 전에 자신의 GET https://api.apihop.ai/v1/models 응답으로 접근 가능 여부를 확인하세요.

text

ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

사전 준비

먼저 유효한 RequestBeam API 키를 준비하세요. 키는 로컬 셸 환경에 기록됩니다. 저장소, 로그 또는 스크린샷에 포함하지 마세요.

Claude Code 설치

macOS / Linux에서는 Claude Code 기본 설치 프로그램을 사용하세요:

bash

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

설치 프로그램이 ~/.local/bin/claude를 표시하지만 claude를 찾을 수 없다면 새 터미널을 열거나 ~/.local/bin을 PATH에 추가하세요.

이전 작업 흐름을 위한 npm 패키지도 계속 제공됩니다:

bash

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

sudo npm install -g @anthropic-ai/claude-code를 사용하지 마세요. 이후 업그레이드 시 권한 문제가 생길 수 있습니다.

설치 후 CLI를 확인하세요:

bash

claude --version
claude doctor

Windows에서 Claude Code는 Git Bash 또는 WSL 사용을 권장합니다. PowerShell에서도 환경 변수를 설정할 수 있지만 영구 저장 방식은 터미널에 따라 다릅니다.

환경 변수 설정

임시 설정은 현재 터미널 세션에만 적용됩니다:

bash

export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS는 기본적으로 zsh를 사용합니다. 설정을 유지하려면 변수를 ~/.zshrc에 기록하고 source ~/.zshrc를 실행해 현재 터미널이 즉시 읽도록 하세요:

bash

printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

Linux에서 bash를 사용하면 같은 변수를 ~/.bashrc에 기록하고 source ~/.bashrc를 실행하세요.

Windows PowerShell 임시 설정:

powershell

$env:ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

PowerShell 사용자 수준 영구 설정:

powershell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

claude를 실행하기 전에 새 PowerShell 세션을 여세요.

설정 파일

셸 설정 대신 ~/.claude/settings.json을 생성하거나 편집할 수 있습니다. 파일이 이미 있다면 다른 설정을 교체하지 말고 기존 JSON에 env와 model을 병합하세요:

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_REQUESTBEAM_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

사용 가능한 모델:

claude-fable-5
claude-fable-5-1
claude-opus-4-6
claude-opus-4-7
claude-opus-4-8
claude-opus-5
claude-opus-5-5
claude-sonnet-5
claude-sonnet-5-5

GET https://api.apihop.ai/v1/models로 현재 API 키에서 사용할 수 있는 모델을 확인하세요.

시작 및 테스트

환경 변수를 설정한 후 Claude Code를 재시작하고 일반 프롬프트를 보내세요:

bash

claude "Reply exactly OK."

대화형 모드도 시작할 수 있습니다:

bash

claude

처음 실행하면 Claude Code가 테마, 안전 확인, 터미널 설정 또는 현재 디렉터리 신뢰 여부를 물을 수 있습니다. 터미널 안내를 따르세요.

모델 선택

환경 변수로 기본 모델을 설정하거나 --model로 단일 명령의 모델을 선택하세요:

bash

claude --model claude-sonnet-5-5 "Review this PR"

엔드포인트 동작

Claude Code는 설정된 RequestBeam API 키로 인증합니다. 서비스는 두 인증 형식을 모두 허용합니다:

http

x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

http

Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

응답은 Anthropic Messages의 기본 JSON 또는 SSE 이벤트 형식을 유지하며 OpenAI 형식으로 변환되지 않습니다.

문제 해결

ANTHROPIC_BASE_URL은 이 페이지의 공개 API 기본 URL에 /anthropic을 더한 값이어야 합니다.
ANTHROPIC_BASE_URL에 엔드포인트 경로를 포함하지 마세요. Anthropic 호환 기본 URL만 필요합니다.
macOS에서 ~/.zshrc를 편집한 후 source ~/.zshrc를 실행하거나 새 터미널을 열고 Claude Code를 시작하세요.
claude가 명령을 찾을 수 없다고 하면 설치 위치가 PATH에 있는지 확인하세요. 일반적인 위치는 ~/.local/bin/claude입니다.
claude doctor가 환경 변수 누락을 보고하면 같은 터미널에서 echo $ANTHROPIC_BASE_URL과 echo $ANTHROPIC_MODEL을 실행해 로드 여부를 확인하세요.
401이 발생하면 API 키가 유효한지 확인하세요.
모델을 사용할 수 없다면 모델 이름이 위의 사용 가능한 모델 목록에 있는지 확인하세요.
환경 변수 변경 후 Claude Code 프로세스를 재시작하세요.

POST https://api.apihop.ai/anthropic/v1/messages: Anthropic Messages 호환 엔드포인트입니다.