人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载Claude Max/Pro 订阅用户常遇到一个痛点Anthropic 官方 API 按 token 计费成本高昂而订阅制套餐本身就包含充足的使用额度。claude-max-api-proxy正是为解决这一问题而生的社区工具——它把 Claude Max/Pro 订阅包装成本地 OpenAI 兼容 API 端点让任何支持 OpenAI API 格式的工具包括 OpenClaw都能直接调用订阅额度。读完本文你将掌握该代理的安装、启动、验证方法并学会把它配置为 OpenClaw 的自定义模型端点同时理解其底层借道 Claude Code CLI的工作原理与限制。一、为什么要用 Claude Max API Proxy订阅制 vs 按量计费的取舍在 OpenClaw本仓库项目中文社区版项目内文档与命令以openclaw-cn出现中选择模型提供商本质上是成本与场景的权衡。原文档给出了清晰的对比方案成本适用场景Anthropic API按 token 计费Opus 约 $15/M 输入、$75/M 输出生产应用、高流量Claude Max 订阅$200/月固定费用个人使用、开发、不限量使用结论很直接如果你已经持有 Claude Max/Pro 订阅并且日常使用的主要是兼容 OpenAI 格式的工具那么通过claude-max-api-proxy把订阅暴露成 API可以在高频个人使用场景下显著节省费用。作为参考仓库文档 docs/providers/anthropic.md 也提供了两条原生接入路径API 密钥或 Claude Code CLI setup-token本代理方案则是另一条完全独立的接入思路。注意claude-max-api-proxy 是社区工具并非 Anthropic 或 OpenClaw 官方支持。使用前需确认你拥有有效的 Claude Max/Pro 订阅且 Claude Code CLI 已完成登录认证。二、工作原理OpenAI 格式 → Claude Code CLI → 订阅额度整个链路的示意图如下Your App → claude-max-api-proxy → Claude Code CLI → Anthropic (via subscription) (OpenAI format) (converts format) (uses your login)代理的职责分三步接收OpenAI 格式的请求监听地址为http://localhost:3456/v1/chat/completions转换为 Claude Code CLI 命令把请求体中的messages、model等字段映射为 CLI 可执行的指令返回OpenAI 格式的响应且完整支持流式输出streaming。从 OpenClaw 仓库的实现可以印证这种借道 CLI的思路并非孤例OpenClaw 本身就在 docs/gateway/cli-backends.md 中内置了claude-cli与codex-cli两类 CLI 后端其默认参数可在 src/agents/cli-backends.ts 中看到例如 Claude Code CLI 后端使用-p --output-format json --dangerously-skip-permissions以非交互方式调用本地 CLI。claude-max-api-proxy 的本质与这一机制同源——都是复用本机已登录的 Claude Code CLI 会话从而把订阅额度变成可编程接口。三、安装与前置条件安装前需要满足两个前置条件Node.js 20Claude Code CLI已安装并完成认证。执行安装与验证# 全局安装代理 npm install -g claude-max-api-proxy # 验证 Claude CLI 已认证可用 claude --version安装完成后即可启动服务claude-max-api # 服务默认运行在 http://localhost:3456代理进程完全在本地运行请求不会发送到任何第三方服务器数据仅在本机与 Anthropic 之间流转。四、快速验证健康检查、模型列表与对话服务启动后依次用 curl 验证三个端点# 健康检查 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!}] }其中model字段使用代理自定义的模型 ID见下表请求与 OpenAI 官方/v1/chat/completions格式完全一致这也是它能被任意 OpenAI 兼容客户端复用的关键。五、可用模型映射代理内置了三档模型 ID分别对应 Claude 系列的不同规格模型 ID映射到claude-opus-4Claude Opus 4claude-sonnet-4Claude Sonnet 4claude-haiku-4Claude Haiku 4在 OpenClaw 仓库的 CLI 后端实现中src/agents/cli-backends.ts 也维护了一份类似的 Claude 模型别名表opus/sonnet/haiku及其多版本映射说明短模型名映射到具体 Claude 型号是这类工具通行的抽象方式方便上层按档位最强 / 均衡 / 轻量选择模型。六、接入 OpenClaw把代理配置为自定义 OpenAI 兼容端点在 OpenClaw 中模型引用统一采用provider/model的格式详见 docs/concepts/models.md。针对本代理标准做法是利用openai提供商的OPENAI_BASE_URL环境变量把端点指到本地代理{ env: { OPENAI_API_KEY: not-needed, OPENAI_BASE_URL: http://localhost:3456/v1 }, agents: { defaults: { model: { primary: openai/claude-opus-4 } } } }要点说明OPENAI_API_KEY填任意占位值如not-needed即可因为代理本身不需要密钥校验OPENAI_BASE_URL指向代理的/v1根路径默认模型写成openai/claude-opus-4其中openai是提供商前缀claude-opus-4是代理暴露的模型 ID。如果希望用更精细的自定义提供商方式而非全局覆盖openai端点OpenClaw 还支持在models.providers中注册一个独立命名的提供商docs/gateway/configuration-reference.md 中给出了完整的结构示例baseUrl、apiKey、api: openai-completions、models列表等字段同样适用于任何 OpenAI 兼容代理包括本代理{ models: { mode: merge, // merge默认| replace providers: { claude-max: { baseUrl: http://localhost:3456/v1, apiKey: not-needed, api: openai-completions, // openai-completions | openai-responses | anthropic-messages | google-generative-ai models: [ { id: claude-opus-4, name: Claude Opus 4, reasoning: false, input: [text] }, { id: claude-sonnet-4, name: Claude Sonnet 4, reasoning: false, input: [text] }, { id: claude-haiku-4, name: Claude Haiku 4, reasoning: false, input: [text] } ] } } } }配置后即可用openclaw-cn models list/openclaw-cn models status校验模型是否进入目录模型管理命令的完整用法见 docs/concepts/models.md。七、macOS 开机自启动LaunchAgent 方案为了让代理常驻运行原文档提供了 macOS LaunchAgent 配置。将以下 plist 写入~/Library/LaunchAgents/com.claude-max-api.plist并加载cat ~/Library/LaunchAgents/com.claude-max-api.plist EOF ?xml version1.0 encodingUTF-8? !DOCTYPE plist PUBLIC -//Apple//DTD PLIST 1.0//EN http://www.apple.com/DTDs/PropertyList-1.0.dtd plist version1.0 dict keyLabel/key stringcom.claude-max-api/string keyRunAtLoad/key true/ keyKeepAlive/key true/ keyProgramArguments/key array string/usr/local/bin/node/string string/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js/string /array keyEnvironmentVariables/key dict keyPATH/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配置说明RunAtLoad与KeepAlive均为true保证开机即启动、进程退出后自动拉起ProgramArguments中node的路径需与你机器上的实际安装位置一致Homebrew 常见于/usr/local/bin/node或/opt/homebrew/bin/nodeEnvironmentVariables中的PATH同时覆盖了 Intel 与 Apple Silicon 的 Homebrew 前缀确保claude等依赖命令可被找到。提示如果通过 launchd/systemd 等守护进程方式运行 OpenClaw 网关其运行环境 PATH 往往被裁剪无法找到claude命令。OpenClaw 的 CLI 后端文档 docs/gateway/cli-backends.md 中专门提到这种情况——建议在agents.defaults.cliBackends中为claude-cli配置command的完整路径本代理的 LaunchAgent 配置同样遵循这一思路为PATH显式补齐了常用目录。八、使用注意与限制结合原文档与 OpenClaw 仓库的 CLI 后端设计docs/gateway/cli-backends.md使用本方案前应明确以下几点社区工具性质claude-max-api-proxy 不受 Anthropic 或 OpenClaw 官方支持遇到问题应在其 GitHub Issues 反馈订阅依赖必须持有有效的 Claude Max/Pro 订阅且本机 Claude Code CLI 已登录认证代理本质上是 CLI 会话的 HTTP 化封装本地运行代理监听localhost不向第三方服务器转发数据如需跨机器访问需自行处理网络与安全策略流式支持代理完整支持 streaming 响应适合需要打字机效果的聊天场景能力边界作为对照OpenClaw 内置的 CLI 后端模式claude-cli后端明确不传递工具调用、不提供流式输出见 docs/gateway/cli-backends.md 的 Limitations 一节。claude-max-api-proxy 同样建立在 CLI 执行之上若需要 OpenClaw 的工具调用、多模型故障转移等完整能力官方支持的 Anthropic 提供商docs/providers/anthropic.md 与 OpenAI 提供商docs/providers/openai.md 仍是更完整的接入方式。九、相关接入路径一览若本代理不满足需求仓库文档还提供了其他可行路径Anthropic 提供商docs/providers/anthropic.md原生集成支持 API 密钥或 Claude Code CLI setup-token/OAuth 认证可配置 Prompt 缓存OpenAI 提供商docs/providers/openai.md支持 OpenAI/Codex 订阅可复用 Codex CLI 登录凭证模型提供商总览docs/concepts/model-providers.md按提供商逐一的配置示例与 CLI 引导命令CLI 后端docs/gateway/cli-backends.md直接以claude-cli/...模型引用复用本机 Claude Code CLI无需额外代理。小结claude-max-api-proxy 为已有订阅、想用 OpenAI 兼容工具的用户提供了一条低成本的本地桥接方案一条命令安装、一条命令启动通过OPENAI_BASE_URL即可接入 OpenClaw。理解其订阅 → Claude Code CLI → 本地 API的链路能帮你判断它是否适合你的个人开发场景也能在遇到问题时快速定位是订阅认证、CLI 环境还是配置指向出了问题。赞分享人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载相关推荐OpenClaw 接入 Claude Max 订阅claude-max-api-proxy 中转代理实战指南OpenClaw 接入 Claude Max 订阅claude max api proxy 中转代理实战指南 本文围绕 docs/providers/clau人工智能大模型LLM 网关AI Agent即时通讯Easegress Claude Proxy 实战让 Claude Code 通过 OpenAI 兼容接口无缝接入 AI 网关Easegress Claude Proxy 实战让 Claude Code 通过 OpenAI 兼容接口无缝接入 AI 网关 导读 Easegress 的云原生API网关微服务服务网格Plandex 接入 Claude Pro/Max 订阅完整指南连接命令、OAuth 原理与配额回退机制Plandex 接入 Claude Pro/Max 订阅完整指南连接命令、OAuth 原理与配额回退机制 Plandex 是面向大型项目与真实场景的开源 AI人工智能AI Agent代码智能体CLI开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考