Claude Max API Proxy

claude-max-api-proxy는 Claude Max/Pro 구독을 OpenAI 호환 API 엔드포인트로 노출하는 커뮤니티 도구입니다. OpenAI API 형식을 지원하는 모든 도구와 함께 구독을 사용할 수 있습니다.

왜 사용하나요?

접근 방식비용최적 사용
Anthropic API토큰당 지불(Opus의 경우 ~$15/M 입력, $75/M 출력)프로덕션 앱, 대량
Claude Max 구독월 $200 고정개인 사용, 개발, 무제한 사용

Claude Max 구독이 있고 OpenAI 호환 도구와 함께 사용하려는 경우 이 프록시는 상당한 비용을 절감할 수 있습니다.

작동 방식

귀하의 앱 → claude-max-api-proxy → Claude Code CLI → Anthropic (구독을 통해)
     (OpenAI 형식)              (형식 변환)      (로그인 사용)

프록시:

  1. http://localhost:3456/v1/chat/completions에서 OpenAI 형식 요청을 수락합니다
  2. Claude Code CLI 명령으로 변환합니다
  3. OpenAI 형식으로 응답을 반환합니다(스트리밍 지원)

설치

# Node.js 20+ 및 Claude Code CLI 필요
npm install -g claude-max-api-proxy

# Claude CLI가 인증되었는지 확인
claude --version

사용법

서버 시작

claude-max-api
# 서버가 http://localhost:3456에서 실행됩니다

테스트

# 상태 확인
curl http://localhost:3456/health

# 모델 목록
curl http://localhost:3456/v1/models

# 채팅 완성
curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

OpenClaw와 함께 사용

OpenClaw를 사용자 지정 OpenAI 호환 엔드포인트로 프록시에 연결할 수 있습니다:

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1"
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" }
    }
  }
}

사용 가능한 모델

Model ID매핑 대상
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

macOS에서 자동 시작

LaunchAgent를 생성하여 프록시를 자동으로 실행하세요:

cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.claude-max-api</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
  </dict>
</dict>
</plist>
EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

링크

참고 사항

  • 이것은 커뮤니티 도구이며 Anthropic 또는 OpenClaw에서 공식적으로 지원하지 않습니다
  • Claude Code CLI가 인증된 활성 Claude Max/Pro 구독이 필요합니다
  • 프록시는 로컬에서 실행되며 타사 서버로 데이터를 전송하지 않습니다
  • 스트리밍 응답이 완전히 지원됩니다

참조

← 문서로 돌아가기