跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

claude-max-api-proxy 是一個社群工具，可將你的 Claude Max/Pro 訂閱公開為 OpenAI 相容的 API 端點。這讓你能在任何支援 OpenAI API 格式的工具中使用你的訂閱。
此路徑僅用於技術相容性。Anthropic 過去曾封鎖部分在 Claude Code 之外的訂閱 使用方式。你必須自行決定是否使用它，並在依賴它之前確認 Anthropic 目前的條款。

​
為什麼使用這個？

做法成本最適合
Anthropic API按 token 付費（Opus 約 15/M輸入、15/M 輸入、75/M 輸出）生產應用程式、高用量
Claude Max 訂閱每月固定 $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

Install the proxy

需要 Node.js 20+ 和 Claude Code CLI。
npm install -g claude-max-api-proxy

# Verify Claude CLI is authenticated
claude --version
2

Start the server

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

Test the proxy

# 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

Configure OpenClaw

將 OpenClaw 指向此代理，作為自訂 OpenAI 相容端點：
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

​
內建目錄

Model ID對應至
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4

​
進階設定

此路徑使用與其他自訂 /v1 後端相同的代理式 OpenAI 相容路由：
  • 不套用原生僅限 OpenAI 的請求塑形
  • 沒有 service_tier、沒有 Responses store、沒有提示快取提示，也沒有 OpenAI reasoning 相容酬載塑形
  • 隱藏的 OpenClaw 歸因標頭（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 Max/Pro 訂閱，且 Claude Code CLI 已完成驗證
  • 此代理在本機執行，不會將資料傳送到任何第三方伺服器
  • 完整支援串流回應
若要使用 Claude CLI 或 API 金鑰進行原生 Anthropic 整合，請參閱 Anthropic provider。若要使用 OpenAI/Codex 訂閱，請參閱 OpenAI provider。

​
相關

Anthropic provider

透過 Claude CLI 或 API 金鑰與 OpenClaw 原生整合。

OpenAI provider

適用於 OpenAI/Codex 訂閱。

Model selection

所有提供者、模型參照與容錯移轉行為的概覽。

Configuration

完整設定參考。