跳转到内容

Claude Max API 代理

claude-max-api-proxy 是一个社区工具,可以将您的 Claude Max/Pro 订阅作为 OpenAI 兼容的 API 端点公开。这允许您将订阅与任何支持 OpenAI API 格式的工具一起使用。

方式计费路径最适合
Anthropic API通过 Claude Console 或云服务按 Token 付费生产应用、共享自动化、大量使用
Claude 订阅代理Claude Code / claude -p 计划和额度规则使用兼容工具进行个人实验

如果您拥有 Claude Max 或 Pro 订阅,并希望将其与 OpenAI 兼容的工具配合使用,此代理可能适合某些个人工作流程。这并非无限量的固定费率路径。对于生产使用,API 密钥仍是更明确的政策和计费路径。

Your App → claude-max-api-proxy → Claude Code CLI / claude -p → Anthropic
(OpenAI format) (converts format) (uses your login)

该代理:

  1. 在 OpenAIhttp://localhost:3456/v1/chat/completions 接受 OpenAI 格式的请求
  2. 将其转换为 Claude Code CLI 命令
  3. 以 OpenAI 格式返回响应(支持流式传输)
  1. 安装代理

    需要 Node.js 20+ 和 Claude Code CLI。

    Terminal window
    npm install -g claude-max-api-proxy
    # Verify Claude CLI is authenticated
    claude --version
  2. 启动服务器

    Terminal window
    claude-max-api
    # Server runs at http://localhost:3456
  3. 测试代理

    Terminal window
    # Health check
    curl http://localhost:3456/health
    # List models
    curl http://localhost:3456/v1/models
    # Chat completion
    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" },
    },
    },
    }
模型 ID映射到
claude-opus-4Claude Opus 4
claude-sonnet-4Claude Sonnet 4
claude-haiku-4Claude Haiku 4
OpenAI代理风格 OpenAI 兼容说明

此路径与其他自定义 /v1OpenAI 后端使用相同的代理风格 OpenAI 兼容路由:

  • 原生仅限 OpenAI 的请求整形不适用
  • service_tier,无 Responses storeOpenAIOpenClaw,无提示缓存提示,也无 OpenAI 推理兼容负载整形
  • 隐藏的 OpenClaw 归属标头(originatorversionUser-Agent)不会在代理 URL 上注入
在 macOS 上使用 LaunchAgent 自动启动

创建一个 LaunchAgent 以自动运行代理:

Terminal window
cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'

Label

com.claude-max-api

RunAtLoad

KeepAlive

ProgramArguments

/usr/local/bin/node

/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js

EnvironmentVariables

PATH

/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin

EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

  • 这是一个社区工具,不获得 Anthropic 或 OpenClaw 的官方支持
  • 需要有效的 Claude Max/Pro 订阅,并已完成 Claude Code CLI 身份验证
  • 继承 Claude Code claude -p 的计费、使用额度和速率限制行为
  • 代理在本地运行,不会将数据发送到任何第三方服务器
  • 完全支持流式响应

Anthropic 提供商

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

OpenAI 提供商

用于 OpenAI/Codex 订阅。

Model selection

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

Configuration

完整的配置参考。