Claude Code 任意模型代理

解决网络与支付的双重门槛

国内开发者在本地使用 Claude Code 时，通常要面对两个现实障碍：Anthropic API 无法直接访问，海外信用卡也并非人人持有。与此同时，国内大模型供应商提供了丰富的模型选择和按量计费方案，却因为协议差异难以直接接入 Claude Code。AnyModel for Claude Code 作为本地代理，正是为了填补这个缝隙。它不改变 Claude Code 的运行方式，而是在两者之间做协议翻译，让 Claude Code 可以像连 Anthropic 官方 API 一样调用第三方模型。

协议转换与可视化管理

代理的核心是 proxy.js，一个零依赖的 Node.js 进程，默认监听 127.0.0.1:4000。它接收 Claude Code 发出的 Anthropic Messages API 请求，转换为上游供应商支持的 OpenAI 协议格式，并将响应和 SSE 流式输出转换回 Anthropic 格式。工具调用（tool_use）在双向转换中被完整保留，因此 Claude Code 执行 shell 命令、读写文件等操作不受影响。

使用时主要分三步：

• 配置密钥：打开 http://localhost:4000 管理界面，在「配置 API 密钥」卡片中填入供应商 Key，或通过 DEEPSEEK_KEY、QWEN_KEY 等环境变量注入。密钥仅保存在本机 data/keys.json，不会上传。
• 选择模型：在界面中点击任意模型卡片即可切换，default 和 auto 是保留别名，会自动路由到当前选中的模型。切换实时生效，无需重启 Claude Code。
• 接入 Claude Code：从界面复制 settings.json 片段，粘贴到 ~/.claude/settings.json 的 env 字段，然后重开 VS Code 会话即可。

内置的 echo 自检别名和 /api/selftest 接口可以在不消耗外部 API、不需要密钥的情况下验证转换链路是否通畅。管理 API 提供环境自检、模型列表、活动日志等能力，方便排查问题。

适用边界与注意事项

这个方案适合个人开发者在本地环境使用，但也有几个限制需要清楚了解：

• 本地进程依赖：使用前必须保持 proxy.js 运行，代理未启动则 Claude Code 无法连接
• 协议子集实现：仅覆盖 Anthropic Messages API 的核心转换，部分高级特性（如 image blocks 的完整转换）未完全支持
• 仅本机监听：端口绑定 127.0.0.1，不支持远程访问或多机共享
• 平台倾向：启动脚本和路径检测以 Windows 为主要场景，核心代理本身跨平台可用
• 上游可用性：各供应商 API 的稳定性和限流策略由其自身决定，429 错误需自行检查账户余额

新增模型只需在 config.json 的 providers 中追加配置项，无需修改代理代码。