Claude Max API Proxy Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Claude Max API proxy

개요

이 페이지는 OpenClaw Claude Max API Proxy provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Community proxy to expose Claude subscription credentials as an OpenAI-compatible endpoint

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Approach	Cost route	Best for
Anthropic API key	Pay per token through Claude Console	Production apps, shared automation, volume
Claude subscription proxy	Claude Code / claude -p plan and credit rules	Personal experiments with compatible tools

공식 문서 기반 상세

아래는 공식 providers/claude-max-api-proxy 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

claude-max-api-proxy is a community npm package (not an OpenClaw plugin) that exposes a Claude Max/Pro subscription as an OpenAI-compatible API endpoint, so you can point any OpenAI-compatible tool at your subscription instead of an Anthropic API key.

Technical compatibility only, not an officially sanctioned path. Anthropic has blocked some subscription usage outside Claude Code in the past; verify Anthropic's current billing rules before relying on this.

Anthropic's Claude Code docs describe claude -p as Agent SDK/programmatic usage. As of Anthropic's June 15, 2026 support update, Claude Agent SDK, claude -p, and third-party app usage draw from the signed-in subscription's usage limits (the previously announced separate Agent SDK credit plan is paused). See Anthropic's Agent SDK plan article, the Pro/Max and Team/Enterprise plan articles, and Anthropic provider for OpenClaw's own Claude CLI billing notes.

Why use this

Approach	Cost route	Best for
Anthropic API key	Pay per token through Claude Console	Production apps, shared automation, volume
Claude subscription proxy	Claude Code / claude -p plan and credit rules	Personal experiments with compatible tools

This proxy lets a Claude Max or Pro subscription work with OpenAI-compatible tools. It is not an unlimited flat-rate path — it inherits Claude Code's usage limits. API keys remain the clearer billing path for production use.

동작 방식

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

The proxy spawns the Claude Code CLI as a subprocess per request, converts OpenAI-format chat requests to CLI prompts, and streams (or returns) the response back in OpenAI format.

시작하기

Install the proxy

Requires Node.js 20+ and an authenticated Claude Code CLI.

```bash
npm install -g claude-max-api-proxy

# Verify Claude CLI is authenticated
claude --version
claude auth login   # if not already authenticated
```

Start the server

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

Test the proxy

```bash
curl http://localhost:3456/health
curl 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!"}]
  }'
```

Configure OpenClaw

Point OpenClaw at the proxy as a custom OpenAI-compatible endpoint:

```json5
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}
```

The model ids below are the proxy's own catalog, not OpenClaw's Anthropic model refs. Each id maps to a Claude Code CLI model alias (opus, sonnet, haiku), so the underlying model shifts whenever Anthropic updates that alias in the CLI. Check the proxy's current README before relying on a specific mapping.

Model ID	CLI alias	Current mapping
claude-opus-4	opus	Claude Opus 4.5
claude-sonnet-4	sonnet	Claude Sonnet 4
claude-haiku-4	haiku	Claude Haiku 4

고급 설정

Proxy-style OpenAI-compatible notes

This uses OpenClaw's generic custom `/v1` OpenAI-compatible route, the same
path as any other self-hosted OpenAI-compatible backend:

- Native OpenAI-only request shaping does not apply.
- `/fast` and `service_tier` only apply to direct `api.anthropic.com`
  traffic; proxy routes leave `service_tier` untouched (see
  [Anthropic provider fast mode](https://docs.openclaw.ai/providers/anthropic#advanced-configuration)).
- No Responses `store`, prompt-cache hints, or OpenAI reasoning-compat
  payload shaping.
- OpenClaw's OpenAI/Codex attribution headers (`originator`, `version`,
  `User-Agent`) are only sent on native `api.openai.com` OAuth traffic, not
  on custom `OPENAI_BASE_URL` targets like this proxy.

Auto-start on macOS with 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
```

참고

• Inherits Claude Code's claude -p billing, usage-credit, and rate-limit behavior.
• Binds to 127.0.0.1 only; does not send data to any third-party server beyond the CLI's own call to Anthropic.
• Streaming responses are supported.
• Auth failures are not checked at startup and only surface once a chat request actually runs; if the CLI is unauthenticated, expect the first request to fail rather than the server to refuse to start.

For native Anthropic integration with Claude CLI or API keys, see Anthropic provider. For OpenAI/Codex subscriptions, see OpenAI provider.

관련 문서

Native OpenClaw integration with Claude CLI or API keys.


For OpenAI/Codex subscriptions.


Overview of all providers, model refs, and failover behavior.


Full config reference.

검증 체크리스트

• openclaw models list --provider claude-max-api-proxy 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers