跳转至

Claude Max API 代理

claude-max-api-proxy 是一个社区 npm 包(非 OpenClaw 插件),它将 Claude Max/Pro 订阅暴露为 OpenAI 兼容的 API 端点,这样你就可以将任何 OpenAI 兼容工具指向你的订阅,而不是 Anthropic API 密钥。

Warning

仅限技术兼容性,并非官方认可的途径。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/Max 和 Team/Enterprise 计划文章,以及 Anthropic 提供方 中 OpenClaw 自身 Claude CLI 的计费说明。

为什么使用此代理

方案 计费路径 适用场景
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 CLI 作为子进程启动,将 OpenAI 格式的聊天请求转换为 CLI 提示,并以 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: {
    vars: {
      OPENAI_API_KEY: "not-needed",
      OPENAI_BASE_URL: "http://localhost:3456/v1",
    },
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

Note

以下模型 ID 是该代理自身的目录,而非 OpenClaw 的 Anthropic 模型引用。每个 ID 映射到 Claude Code CLI 的一个模型别名(opus、sonnet、haiku),因此每当 Anthropic 更新 CLI 中的该别名时,底层模型也会随之变化。在依赖特定映射之前,请查看该代理当前的 README。

模型 ID CLI 别名
claude-opus-4 opus
claude-sonnet-4 sonnet
claude-haiku-4 haiku

高级配置

代理式 OpenAI 兼容说明

这使用的是 OpenClaw 的通用自定义 /v1 OpenAI 兼容路由,与任何其他自托管 OpenAI 兼容后端使用相同的路径:

  • 不适用原生 OpenAI 专属的请求整形。
  • /fast 和 service_tier 仅适用于直接发往 api.anthropic.com 的流量;代理路由不会改动 service_tier(参见 Anthropic 提供方的快速模式)。
  • 不涉及 Responses store、prompt-cache 提示或 OpenAI 推理兼容的负载整形。
  • OpenClaw 的 OpenAI/Codex 归属请求头(originator、version、User-Agent)仅在原生 api.openai.com OAuth 流量中发送,而不会发送到类似此代理的自定义 OPENAI_BASE_URL 目标。
在 macOS 上使用 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

备注

  • 继承 Claude Code 的 claude -p 计费、使用额度和速率限制行为。
  • 仅绑定 127.0.0.1;除 CLI 自身对 Anthropic 的调用外,不会向任何第三方服务器发送数据。
  • 支持流式响应。
  • 启动时不会检查认证失败,只有在聊天请求实际运行时才会暴露;如果 CLI 未认证,预计第一个请求会失败,而不是服务器拒绝启动。

Note

如需使用 Claude CLI 或 API keys 进行原生 Anthropic 集成,请参阅 Anthropic 提供商。如需 OpenAI/Codex 订阅,请参阅 OpenAI 提供商。

Anthropic 提供商

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

OpenAI 提供商

适用于 OpenAI/Codex 订阅。

模型选择

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

配置

完整配置参考。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw