Providers
Claude Max API 프록시
claude-max-api-proxy는 Claude Max/Pro 구독을 OpenAI 호환 API 엔드포인트로 노출하는 커뮤니티 npm 패키지(OpenClaw Plugin 아님)입니다. 따라서 Anthropic API 키 대신 OpenAI 호환 도구에서 구독을 사용할 수 있습니다.
사용 이유
| 방식 | 비용 처리 경로 | 적합한 용도 |
|---|---|---|
| Anthropic API 키 | Claude Console을 통해 토큰당 결제 | 프로덕션 앱, 공유 자동화, 대규모 사용 |
| Claude 구독 프록시 | Claude Code / claude -p 요금제 및 크레딧 규칙 |
호환 도구를 이용한 개인 실험 |
이 프록시를 사용하면 Claude Max 또는 Pro 구독을 OpenAI 호환 도구에서 사용할 수 있습니다. 무제한 정액제 경로가 아니며 Claude Code의 사용량 한도가 그대로 적용됩니다. 프로덕션 용도에서는 API 키가 여전히 더 명확한 요금 청구 경로입니다.
작동 방식
애플리케이션 -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic (OpenAI 형식) (형식 변환) (로그인 사용)프록시는 요청마다 Claude Code CLI를 하위 프로세스로 실행하고, OpenAI 형식의 채팅 요청을 CLI 프롬프트로 변환한 다음 응답을 OpenAI 형식으로 스트리밍하거나 반환합니다.
시작하기
프록시 설치
Node.js 20 이상과 인증된 Claude Code CLI가 필요합니다.
npm install -g claude-max-api-proxy # Claude CLI 인증 여부 확인claude --versionclaude auth login # 아직 인증하지 않은 경우서버 시작
claude-max-api# 서버는 http://localhost:3456 에서 실행됨프록시 테스트
curl http://localhost:3456/healthcurl 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 호환 엔드포인트로 사용하도록 OpenClaw를 지정합니다.
{ env: { OPENAI_API_KEY: "not-needed", OPENAI_BASE_URL: "http://localhost:3456/v1", }, agents: { defaults: { model: { primary: "openai/claude-opus-4" }, }, },}| 모델 ID | CLI 별칭 | 현재 매핑 |
|---|---|---|
claude-opus-4 |
opus |
Claude Opus 4.5 |
claude-sonnet-4 |
sonnet |
Claude Sonnet 4 |
claude-haiku-4 |
haiku |
Claude Haiku 4 |
고급 구성
프록시 방식 OpenAI 호환 관련 참고 사항
이 방식은 다른 자체 호스팅 OpenAI 호환 백엔드와 동일하게 OpenClaw의 일반 사용자 지정 /v1 OpenAI 호환 경로를 사용합니다.
- OpenAI 전용 기본 요청 형식 조정은 적용되지 않습니다.
/fast와service_tier는api.anthropic.com으로 직접 전송되는 트래픽에만 적용됩니다. 프록시 경로에서는service_tier를 변경하지 않습니다(Anthropic 공급자 고속 모드 참조).- Responses의
store, 프롬프트 캐시 힌트 또는 OpenAI 추론 호환 페이로드 형식 조정은 제공되지 않습니다. - OpenClaw의 OpenAI/Codex 출처 표시 헤더(
originator,version,User-Agent)는 기본api.openai.comOAuth 트래픽에만 전송되며, 이 프록시와 같은 사용자 지정OPENAI_BASE_URL대상에는 전송되지 않습니다.
LaunchAgent를 사용하여 macOS에서 자동 시작
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참고 사항
- Claude Code의
claude -p요금 청구, 사용량 크레딧 및 속도 제한 동작이 그대로 적용됩니다. 127.0.0.1에만 바인딩되며, CLI 자체에서 Anthropic을 호출하는 경우를 제외하고 서드 파티 서버로 데이터를 전송하지 않습니다.- 스트리밍 응답을 지원합니다.
- 인증 실패는 시작 시 확인되지 않고 채팅 요청이 실제로 실행될 때만 드러납니다. CLI가 인증되지 않은 경우 서버가 시작을 거부하는 대신 첫 번째 요청이 실패합니다.
관련 항목
Was this useful?
