OpenClawDocs
이 페이지에서

이 페이지에서

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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 키가 여전히 더 명확한 요금 청구 경로입니다.

작동 방식

text
애플리케이션 -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic     (OpenAI 형식)                  (형식 변환)                   (로그인 사용)

프록시는 요청마다 Claude Code CLI를 하위 프로세스로 실행하고, OpenAI 형식의 채팅 요청을 CLI 프롬프트로 변환한 다음 응답을 OpenAI 형식으로 스트리밍하거나 반환합니다.

시작하기

  • 프록시 설치

    Node.js 20 이상과 인증된 Claude Code CLI가 필요합니다.

    bash
    npm install -g claude-max-api-proxy # Claude CLI 인증 여부 확인claude --versionclaude auth login   # 아직 인증하지 않은 경우

  • 서버 시작

    bash
    claude-max-api# 서버는 http://localhost:3456 에서 실행됨

  • 프록시 테스트

    bash
    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를 지정합니다.

    json5
    {  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.com OAuth 트래픽에만 전송되며, 이 프록시와 같은 사용자 지정 OPENAI_BASE_URL 대상에는 전송되지 않습니다.
    LaunchAgent를 사용하여 macOS에서 자동 시작
    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

    참고 사항

    • Claude Code의 claude -p 요금 청구, 사용량 크레딧 및 속도 제한 동작이 그대로 적용됩니다.
    • 127.0.0.1에만 바인딩되며, CLI 자체에서 Anthropic을 호출하는 경우를 제외하고 서드 파티 서버로 데이터를 전송하지 않습니다.
    • 스트리밍 응답을 지원합니다.
    • 인증 실패는 시작 시 확인되지 않고 채팅 요청이 실제로 실행될 때만 드러납니다. CLI가 인증되지 않은 경우 서버가 시작을 거부하는 대신 첫 번째 요청이 실패합니다.

    관련 항목

    Anthropic 공급자

    Claude CLI 또는 API 키를 사용하는 OpenClaw 기본 연동입니다.
    OpenAI 공급자

    OpenAI/Codex 구독용입니다.
    모델 선택

    모든 공급자, 모델 참조 및 장애 조치 동작의 개요입니다.
    구성

    전체 구성 참조입니다.
    Was this useful?