Claude Max API Proxy

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

경고: 이 방법은 기술적 호환성만을 제공합니다. Anthropic은 과거에 Claude Code 외부에서의 일부 구독 사용을 차단한 적이 있습니다. 사용 여부는 본인이 판단해야 하며, 의존하기 전에 Anthropic의 현행 약관을 반드시 확인하세요.

사용 이유

방식	비용	추천 대상
Anthropic API	토큰당 과금 (Opus 기준 입력 ~$15/M, 출력 ~$75/M)	프로덕션 앱, 대량 사용
Claude Max 구독	월 $200 정액	개인 사용, 개발, 무제한 사용

Claude Max 구독을 보유하고 있으며 OpenAI 호환 도구에서 사용하고 싶다면, 이 프록시로 일부 워크플로의 비용을 절감할 수 있습니다. 프로덕션 사용에는 API 키가 정책상 더 명확한 방법입니다.

작동 방식

앱 → claude-max-api-proxy → Claude Code CLI → Anthropic (구독 경유)
     (OpenAI 형식)              (형식 변환)          (로그인 사용)

프록시의 동작:

http://localhost:3456/v1/chat/completions에서 OpenAI 형식 요청을 수신
Claude Code CLI 명령으로 변환
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에서 사용하기

프록시를 커스텀 OpenAI 호환 엔드포인트로 지정할 수 있습니다:

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

사용 가능한 모델

모델 ID	매핑 대상
`claude-opus-4`	Claude Opus 4
`claude-sonnet-4`	Claude Sonnet 4
`claude-haiku-4`	Claude 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

링크

npm: https://www.npmjs.com/package/claude-max-api-proxy
GitHub: https://github.com/atalovesyou/claude-max-api-proxy
Issues: https://github.com/atalovesyou/claude-max-api-proxy/issues

참고 사항

이것은 커뮤니티 도구이며, Anthropic이나 OpenClaw에서 공식 지원하지 않습니다
Claude Max/Pro 구독이 활성화되어 있고 Claude Code CLI가 인증된 상태여야 합니다
프록시는 로컬에서 실행되며 제3자 서버로 데이터를 전송하지 않습니다
스트리밍 응답을 완전히 지원합니다