模型提供商
claude-max-api-proxy 是一个社区 npm 软件包(不是 OpenClaw 插件),它将 Claude Max/Pro 订阅公开为兼容 OpenAI 的 API 端点,因此你可以将任何兼容 OpenAI 的工具指向你的订阅,而无需使用 Anthropic API key。
为什么使用此方式
| 方式 |
费用途径 |
最适合 |
| Anthropic API key |
通过 Claude Console 按 token 付费 |
生产应用、共享自动化、大用量场景 |
| Claude 订阅代理 |
Claude Code / claude -p 套餐和点数规则 |
使用兼容工具进行个人实验 |
此代理让 Claude Max 或 Pro 订阅能够与兼容 OpenAI 的工具配合使用。它并非不限量的固定费率方案,而是沿用 Claude Code 的使用限额。对于生产用途,API key 仍然是计费方式更明确的选择。
工作原理
text你的应用 -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic (OpenAI 格式) (转换格式) (使用你的登录状态)
代理会为每个请求将 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": "你好!"}] }'
配置 OpenClaw
将 OpenClaw 指向该代理,并将其用作自定义的兼容 OpenAI 端点:
json5{ env: { 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 Opus 4.5 |
claude-sonnet-4 |
sonnet |
Claude Sonnet 4 |
claude-haiku-4 |
haiku |
Claude Haiku 4 |
高级配置
代理式兼容 OpenAI 端点说明
此方式使用 OpenClaw 的通用自定义 /v1 兼容 OpenAI 路由,与其他任何自托管的兼容 OpenAI 后端使用相同路径:
- 仅适用于原生 OpenAI 的请求整形不会生效。
/fast 和 service_tier 仅适用于直接的 api.anthropic.com 流量;代理路由不会修改 service_tier(请参阅 Anthropic 提供商快速模式)。
- 不进行 Responses
store、提示词缓存提示或 OpenAI 推理兼容载荷整形。
- 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 未完成身份验证,预期首次请求会失败,而不是服务器拒绝启动。
相关内容