提供商

Claude Max API 代理

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。

    bash
    npm install -g claude-max-api-proxy # 确认 Claude CLI 已完成身份验证claude --versionclaude auth login   # 如果尚未完成身份验证
  • 启动服务器

    bash
    claude-max-api# 服务器运行于 http://localhost:3456
  • 测试代理

    bash
    curl 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 的请求整形不会生效。
    • /fastservice_tier 仅适用于直接的 api.anthropic.com 流量;代理路由不会修改 service_tier(请参阅 Anthropic 提供商快速模式)。
    • 不进行 Responses store、提示词缓存提示或 OpenAI 推理兼容载荷整形。
    • OpenClaw 的 OpenAI/Codex 归属标头(originatorversionUser-Agent)仅随原生 api.openai.com OAuth 流量发送,不会发送到此代理之类的自定义 OPENAI_BASE_URL 目标。
    在 macOS 上使用 LaunchAgent 自动启动
    bash
    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 未完成身份验证,预期首次请求会失败,而不是服务器拒绝启动。

    相关内容

    Was this useful?
    On this page

    On this page