Providers
Claude Max API 프록시
claude-max-api-proxy는 Claude Max/Pro 구독을 OpenAI 호환 API 엔드포인트로 노출하는 커뮤니티 도구입니다. 이를 통해 OpenAI API 형식을 지원하는 모든 도구에서 구독을 사용할 수 있습니다.
왜 사용하나요?
| Approach | Cost | Best For |
|---|---|---|
| Anthropic API | 토큰당 과금(Opus 기준 입력 ~$15/M, 출력 ~$75/M) | 프로덕션 앱, 대량 사용 |
| Claude Max subscription | 월 $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 형식으로 응답 반환(Streaming 지원)
시작하기
프록시 설치
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
# 채팅 completion
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 | Maps To |
|---|---|
claude-opus-4 |
Claude Opus 4 |
claude-sonnet-4 |
Claude Sonnet 4 |
claude-haiku-4 |
Claude Haiku 4 |
고급 구성
프록시 스타일 OpenAI 호환 참고 사항
이 경로는 다른 사용자 지정 /v1 백엔드와 동일한 프록시 스타일 OpenAI 호환 경로를 사용합니다.
- 네이티브 OpenAI 전용 요청 shaping은 적용되지 않음
service_tier, Responsesstore, 프롬프트 캐시 힌트, OpenAI reasoning 호환 페이로드 shaping 없음- 숨겨진 OpenClaw attribution header(
originator,version,User-Agent)는 프록시 URL에 주입되지 않음
LaunchAgent로 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
- 이슈: https://github.com/atalovesyou/claude-max-api-proxy/issues
참고
- 이것은 커뮤니티 도구이며, Anthropic이나 OpenClaw가 공식 지원하지 않습니다.
- Claude Code CLI가 인증된 활성 Claude Max/Pro 구독이 필요합니다.
- 프록시는 로컬에서 실행되며 어떤 서드파티 서버에도 데이터를 전송하지 않습니다.
- Streaming 응답을 완전히 지원합니다.