Providers

Claude Max API 프록시

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

왜 이것을 사용하나요?

접근 방식 비용 경로 적합한 용도
Anthropic API Claude Console 또는 클라우드를 통해 토큰당 결제 프로덕션 앱, 공유 자동화, 대량 사용
Claude 구독 프록시 Claude Code / claude -p 플랜 및 크레딧 규칙 호환 도구를 사용한 개인 실험

Claude Max 또는 Pro 구독이 있고 이를 OpenAI 호환 도구와 함께 사용하려는 경우, 이 프록시는 일부 개인 워크플로에 맞을 수 있습니다. 이는 무제한 정액 경로가 아닙니다. 프로덕션 사용에는 API 키가 여전히 더 명확한 정책 및 청구 경로입니다.

작동 방식

Code
Your App → claude-max-api-proxy → Claude Code CLI / claude -p → Anthropic     (OpenAI format)              (converts format)          (uses your login)

프록시는 다음을 수행합니다.

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

시작하기

  • 프록시 설치

    Node.js 22+와 Claude Code CLI가 필요합니다.

    bash
    npm install -g claude-max-api-proxy # Verify Claude CLI is authenticatedclaude --version
  • 서버 시작

    bash
    claude-max-api# Server runs at http://localhost:3456
  • 프록시 테스트

    bash
    # Health checkcurl http://localhost:3456/health # List modelscurl http://localhost:3456/v1/models # Chat completioncurl http://localhost:3456/v1/chat/completions \  -H "Content-Type: application/json" \  -d '{    "model": "claude-opus-4",    "messages": [{"role": "user", "content": "Hello!"}]  }'
  • OpenClaw 구성

    OpenClaw가 프록시를 사용자 지정 OpenAI 호환 엔드포인트로 사용하도록 지정합니다.

    json5
    {  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

    고급 구성

    프록시 스타일 OpenAI 호환 참고 사항

    이 경로는 다른 사용자 지정 /v1 백엔드와 동일한 프록시 스타일 OpenAI 호환 경로를 사용합니다.

    • 기본 OpenAI 전용 요청 구성은 적용되지 않습니다
    • service_tier, Responses store, 프롬프트 캐시 힌트, OpenAI reasoning 호환 페이로드 구성은 없습니다
    • 숨겨진 OpenClaw attribution 헤더(originator, version, User-Agent)는 프록시 URL에 삽입되지 않습니다
    LaunchAgent로 macOS에서 자동 시작

    프록시를 자동으로 실행하도록 LaunchAgent를 만듭니다.

    bash
    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 구독이 필요합니다
    • Claude Code claude -p의 청구, 사용 크레딧, 속도 제한 동작을 상속합니다
    • 프록시는 로컬에서 실행되며 데이터를 어떤 서드파티 서버에도 보내지 않습니다
    • 스트리밍 응답이 완전히 지원됩니다

    관련 항목

    Was this useful?
    On this page

    On this page