跳转到主要内容
claude-max-api-proxy 是一个社区 npm 包（不是 OpenClaw 插件），它会把 Claude Max/Pro 订阅暴露为 OpenAI 兼容的 API 端点，因此你可以把任何 OpenAI 兼容工具指向你的订阅，而不是使用 Anthropic API key。
仅表示技术兼容，并非官方认可的路径。Anthropic 过去曾阻止在 Claude Code 之外使用某些订阅；在依赖此方式前，请先确认 Anthropic 当前的计费规则。Anthropic 的 Claude Code 文档将 claude -p 描述为 Agent SDK/程序化用法。截至 Anthropic 2026 年 6 月 15 日的支持更新，Claude Agent SDK、claude -p 和第三方应用用法都会消耗已登录订阅的用量限制（此前公布的独立 Agent SDK credit 方案已暂停）。请参阅 Anthropic 的 Agent SDK 方案文章、Pro/Max 和 Team/Enterprise 方案文章，以及 Anthropic 提供商，了解 OpenClaw 自身的 Claude CLI 计费说明。

​
为什么使用它

方式成本路径最适合
Anthropic API key通过 Claude Console 按 token 付费生产应用、共享自动化、大用量
Claude 订阅代理Claude Code / claude -p 方案和 credit 规则使用兼容工具进行个人实验
此代理让 Claude Max 或 Pro 订阅可以配合 OpenAI 兼容工具使用。它不是无限量固定费率路径，它继承 Claude Code 的用量限制。对于生产用途，API key 仍然是更清晰的计费路径。

​
工作原理

Your App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic
     (OpenAI format)                (converts format)              (uses your login)
代理会针对每个请求把 Claude Code CLI 作为子进程启动，将 OpenAI 格式的聊天请求转换为 CLI prompt，并以 OpenAI 格式流式传回（或返回）响应。

​
入门指南

1

安装代理

需要 Node.js 20+ 和已认证的 Claude Code CLI。
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" },
    },
  },
}
下面的 model id 是代理自身的目录，不是 OpenClaw 的 Anthropic 模型引用。每个 id 都映射到一个 Claude Code CLI 模型别名（opus、sonnet、haiku），因此只要 Anthropic 在 CLI 中更新该别名，底层模型就会随之变化。在依赖特定映射前，请检查代理当前的 README。
Model IDCLI 别名当前映射
claude-opus-4opusClaude Opus 4.5
claude-sonnet-4sonnetClaude Sonnet 4
claude-haiku-4haikuClaude Haiku 4

​
高级配置

这会使用 OpenClaw 的通用自定义 /v1 OpenAI 兼容路由，与任何其他自托管 OpenAI 兼容后端使用相同路径：
  • 原生 OpenAI 专用请求整形不适用。
  • /fast 和 service_tier 仅适用于直连 api.anthropic.com 的流量；代理路由会保持 service_tier 不变（参见 Anthropic 提供商快速模式）。
  • 没有 Responses store、prompt-cache 提示或 OpenAI reasoning 兼容 payload 整形。
  • OpenClaw 的 OpenAI/Codex 归因标头（originator、version、User-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 计费、用量 credit 和速率限制行为。
  • 仅绑定到 127.0.0.1；除 CLI 自身对 Anthropic 的调用外，不会向任何第三方服务器发送数据。
  • 支持流式响应。
  • 启动时不会检查认证失败，只有在聊天请求实际运行后才会暴露；如果 CLI 未认证，预期首次请求会失败，而不是服务器拒绝启动。
如需使用 Claude CLI 或 API key 的原生 Anthropic 集成，请参阅 Anthropic 提供商。对于 OpenAI/Codex 订阅，请参阅 OpenAI provider。

​
相关内容

Anthropic 提供商

使用 Claude CLI 或 API key 的 OpenClaw 原生集成。

OpenAI provider

用于 OpenAI/Codex 订阅。

模型选择

所有提供商、模型引用和故障转移行为概览。

配置

完整配置参考。