메인 콘텐츠로 건너뛰기

​
Claude Max API Proxy

claude-max-api-proxy는 Claude Max/Pro 구독을 OpenAI 호환 API 엔드포인트로 노출하는 커뮤니티 도구입니다. 이를 통해 OpenAI API 형식을 지원하는 모든 도구에서 구독을 사용할 수 있습니다.
이 경로는 기술적 호환성만을 위한 것입니다. Anthropic은 과거에 Claude Code 외부에서의 일부 구독 사용을 차단한 적이 있습니다. 이를 사용할지 여부는 스스로 판단해야 하며, 의존하기 전에 Anthropic의 현재 약관을 직접 확인해야 합니다.

​
왜 이것을 사용하나요?

ApproachCostBest For
Anthropic API토큰당 과금(Opus 기준 입력 약 15/M,출력15/M, 출력 75/M)프로덕션 앱, 높은 사용량
Claude Max subscription월 $200 정액개인 사용, 개발, 무제한 사용
Claude Max 구독이 있고 이를 OpenAI 호환 도구와 함께 사용하려는 경우, 이 프록시는 일부 워크플로에서 비용을 줄일 수 있습니다. 프로덕션 사용에는 여전히 API 키가 더 명확한 정책 경로입니다.

​
작동 방식

Your App → claude-max-api-proxy → Claude Code CLI → Anthropic (via subscription)
     (OpenAI format)              (converts format)      (uses your login)
프록시는 다음과 같이 동작합니다:
  1. http://localhost:3456/v1/chat/completions에서 OpenAI 형식 요청을 받습니다
  2. 이를 Claude Code CLI 명령으로 변환합니다
  3. OpenAI 형식으로 응답을 반환합니다(스트리밍 지원)

​
시작하기

1

프록시 설치

Node.js 20+ 및 Claude Code CLI가 필요합니다.
npm install -g claude-max-api-proxy

# Verify Claude CLI is authenticated
claude --version
2

서버 시작

claude-max-api
# Server runs at http://localhost:3456
3

프록시 테스트

# Health check
curl http://localhost:3456/health

# List models
curl http://localhost:3456/v1/models

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

OpenClaw 구성

사용자 지정 OpenAI 호환 엔드포인트로 프록시를 가리키도록 OpenClaw를 설정합니다:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

​
사용 가능한 모델

Model IDMaps To
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

​
고급

이 경로는 다른 사용자 지정 /v1 백엔드와 동일한 프록시 스타일 OpenAI 호환 경로를 사용합니다:
  • OpenAI 전용 네이티브 요청 shaping은 적용되지 않습니다
  • service_tier, Responses store, 프롬프트 캐시 힌트, OpenAI 추론 호환 payload shaping은 지원되지 않습니다
  • 숨겨진 OpenClaw attribution 헤더(originator, version, User-Agent)는 프록시 URL에 주입되지 않습니다
프록시를 자동으로 실행하도록 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 구독이 필요합니다
  • 프록시는 로컬에서 실행되며 데이터를 제3자 서버로 전송하지 않습니다
  • 스트리밍 응답이 완전히 지원됩니다
Claude CLI 또는 API 키를 사용하는 기본 Anthropic 통합은 Anthropic provider를 참조하세요. OpenAI/Codex 구독은 OpenAI provider를 참조하세요.

​
관련

Anthropic provider

Claude CLI 또는 API 키를 사용하는 기본 OpenClaw 통합.

OpenAI provider

OpenAI/Codex 구독용.

모델 provider

모든 provider, 모델 참조 및 장애 조치 동작 개요.

구성

전체 구성 참조.