模型供应商
claude-max-api-proxy 是一个社区 npm 包(不是 OpenClaw 插件),它将 Claude Max/Pro 订阅公开为 OpenAI- 兼容的 API 端点,因此您可以指向任何您订阅的 OpenAI- 兼容工具,而不是 Anthropic API 密钥。
为什么使用它
| 方式 |
成本路径 |
最适合 |
| Anthropic API 钥匙 |
通过 Claude Console 按 token 付费 |
生产应用、共享自动化、批量使用 |
| Claude 订阅代理 |
Claude Code / claude -p 计划和额度规则 |
使用兼容工具进行个人实验 |
此代理允许 Claude Max 或 Pro 订阅与 OpenAI- 兼容工具一起使用。它不是无限的统一费率路径 - 它继承了 Claude Code 的使用限制。 API 密钥仍然是生产使用中更清晰的计费路径。
工作原理
textYour App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic (OpenAI format) (converts format) (uses your login)
代理根据请求生成 Claude Code CLI 作为子进程,将 OpenAI- 格式的聊天请求转换为 CLI 提示,并以 OpenAI 格式流式传输(或返回)响应。
入门
安装代理
需要 Node.js 20+ 以及已通过身份验证的 Claude Code CLI。
bashnpm install -g claude-max-api-proxy claude --versionclaude auth login
启动服务器
bash
测试代理
bashcurl http://localhost:3456/healthcurl 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!"}] }'
配置OpenClaw
将 OpenClaw 指向代理作为自定义 OpenAI- 兼容端点:
json5{ env: { vars: { OPENAI_API_KEY: "not-needed", OPENAI_BASE_URL: "http://localhost:3456/v1", }, }, agents: { defaults: { model: { primary: "openai/claude-opus-4" }, }, },}
| 模型 ID |
CLI 别名 |
claude-opus-4 |
opus |
claude-sonnet-4 |
sonnet |
claude-haiku-4 |
haiku |
高级配置
代理样式 OpenAI- 兼容注释
这使用 OpenClaw 的通用自定义 /v1 OpenAI- 兼容路由,与任何其他自托管 OpenAI- 兼容后端相同的路径:
- Native OpenAI-only 请求整形不适用。
/fast 和 service_tier 仅适用于直接发送到 api.anthropic.com 的流量;代理路由会保持 service_tier 不变(参见 Anthropic provider 快速模式)。
- 不包含 Responses 的
store、prompt-cache 提示,或 OpenAI reasoning 兼容负载形状调整。
- OpenClaw 的 OpenAI/Codex 归属头(
originator、version、 User-Agent)仅在原生 api.openai.com OAuth 流量中发送,不会在像此代理这样的自定义 OPENAI_BASE_URL 目标上发送。
在 macOS 上自动启动 LaunchAgent
bashcat > ~/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 未通过身份验证,预期会是第一条请求失败,而不是服务器拒绝启动。
相关内容