跳轉到主要內容
claude-max-api-proxy 是一個社群 npm 套件(不是 OpenClaw 外掛),可將 Claude Max/Pro 訂閱公開為 OpenAI 相容的 API 端點,因此你可以將任何 OpenAI 相容工具指向你的訂閱,而不是 Anthropic API 金鑰。
僅提供技術相容性,並非官方核准的路徑。Anthropic 過去曾封鎖 Claude Code 以外的部分訂閱用法;在依賴此方式前,請先確認 Anthropic 目前的計費規則。Anthropic 的 Claude Code 文件將 claude -p 描述為 Agent SDK/程式化使用。截至 Anthropic 2026 年 6 月 15 日的支援更新,Claude Agent SDK、claude -p 與第三方應用程式使用量都會計入已登入訂閱的使用限制(先前公告的獨立 Agent SDK 點數方案已暫停)。請參閱 Anthropic 的 Agent SDK 方案文章Pro/MaxTeam/Enterprise 方案文章,以及 Anthropic provider,了解 OpenClaw 自身的 Claude 命令列介面計費說明。

為什麼使用此方式

方式成本路徑最適合
Anthropic API 金鑰透過 Claude Console 依 token 付費生產應用程式、共用自動化、大量使用
Claude 訂閱代理Claude Code / claude -p 方案與點數規則使用相容工具的個人實驗
此代理可讓 Claude Max 或 Pro 訂閱搭配 OpenAI 相容工具使用。這不是無限制的固定費率路徑,它會繼承 Claude Code 的使用限制。對於生產使用,API 金鑰仍是更清楚的計費路徑。

運作方式

Your App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic
     (OpenAI format)                (converts format)              (uses your login)
代理會針對每個請求將 Claude Code 命令列介面作為子程序啟動,將 OpenAI 格式的聊天請求轉換為命令列介面提示,並以 OpenAI 格式串流(或傳回)回應。

開始使用

1

安裝代理

需要 Node.js 20+ 與已驗證的 Claude Code 命令列介面。
npm install -g claude-max-api-proxy

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

啟動伺服器

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

測試代理

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!"}]
  }'
4

設定 OpenClaw

將 OpenClaw 指向此代理,作為自訂 OpenAI 相容端點:
{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}
以下模型 ID 是代理自身的目錄,不是 OpenClaw 的 Anthropic 模型參照。每個 ID 都會對應到 Claude Code 命令列介面模型別名(opussonnethaiku),因此只要 Anthropic 在命令列介面中更新該別名,底層模型就會改變。依賴特定對應前,請先查看代理目前的 README。
模型 ID命令列介面別名目前對應
claude-opus-4opusClaude Opus 4.5
claude-sonnet-4sonnetClaude Sonnet 4
claude-haiku-4haikuClaude Haiku 4

進階設定

這會使用 OpenClaw 的通用自訂 /v1 OpenAI 相容路由,與任何其他自架 OpenAI 相容後端的路徑相同:
  • 不會套用僅限原生 OpenAI 的請求塑形。
  • /fastservice_tier 僅適用於直接傳送至 api.anthropic.com 的流量;代理路由會保留 service_tier 不變(請參閱 Anthropic provider 快速模式)。
  • 沒有 Responses store、提示快取提示,或 OpenAI 推理相容酬載塑形。
  • OpenClaw 的 OpenAI/Codex 歸因標頭(originatorversionUser-Agent)只會在原生 api.openai.com OAuth 流量中傳送,不會在像此代理這樣的自訂 OPENAI_BASE_URL 目標上傳送。
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;除了命令列介面自身對 Anthropic 的呼叫外,不會將資料傳送到任何第三方伺服器。
  • 支援串流回應。
  • 啟動時不會檢查驗證失敗,只有在聊天請求實際執行後才會浮現;如果命令列介面尚未驗證,預期第一個請求會失敗,而不是伺服器拒絕啟動。
如需透過 Claude 命令列介面或 API 金鑰進行原生 Anthropic 整合,請參閱 Anthropic provider。如需 OpenAI/Codex 訂閱,請參閱 OpenAI provider

相關

Anthropic provider

透過 Claude 命令列介面或 API 金鑰進行的原生 OpenClaw 整合。

OpenAI provider

適用於 OpenAI/Codex 訂閱。

模型選擇

所有供應商、模型參照與容錯移轉行為概覽。

設定

完整設定參考。