raine/claude-code-proxy

Use Claude Code with your ChatGPT, Kimi, Cursor or Grok subscription via a local Anthropic-compatible proxy

它是什么

claude-code-proxy 是一个小型本地服务器，位于 Claude Code 编辑器（基于 Anthropic 的 Claude 构建的编码助手 UI）和多种大型语言模型提供商（如 OpenAI Codex、Kimi、Grok、OpenCode Go 和 Cursor Agent）之间。它将 Claude Code 期望的 Anthropic 风格 API 调用转换为这些提供商的原生 API，处理认证、模型路由、流式响应和基本诊断。

为什么重要

Claude Code 已经提供了丰富的编码助手功能（代码补全、重构、文档、子代理、编辑器集成）。然而，Claude Code 硬编码到 Anthropic 的付费 API。代理让您保留相同的 UI，同时使用任何受支持的基于订阅的后端，可能降低成本或访问具有不同优势的模型（例如，Kimi-for-coding、Grok、Cursor）。它还提供本地监控 UI，让您实时查看请求速率、令牌使用情况和错误。

如何开始

安装 – 在 macOS/Linux 上，您可以 brew install raine/claude-code-proxy/claude-code-proxy 或从仓库运行一行安装脚本。Windows 二进制文件在 GitHub releases 页面上。
认证 – 使用 ChatGPT Plus 或 Pro 账户登录（代理使用 ChatGPT 会话令牌，而不是 OpenAI API 密钥）：
```
claude-code-proxy codex auth login
```
运行代理 – 在终端中启动它：
```
claude-code-proxy serve
```
可选地添加 --no-monitor 以作为后台服务运行，稍后使用 claude-code-proxy monitor 附加 TUI 监控器。
启动 Claude Code – 通过设置几个环境变量将编辑器指向本地代理，例如：
```
ANTHROPIC_BASE_URL=http://127.0.0.1:18765 \
ANTHROPIC_AUTH_TOKEN=unused \
ANTHROPIC_MODEL=gpt-6-sol \
claude
```
代理将请求转发给您认证的提供商。
可选图像生成 – 使用 CCP_CODEX_IMAGES_API=1 启用 Codex 图像端点，并调用本地 /v1/images/generations 端点；代理将请求转发到已登录 ChatGPT 账户的图像配额。

主要功能

功能	作用
多提供商支持	支持 Codex、Kimi、Grok、OpenCode Go 和 Cursor Agent；您可以使用 `claude-code-proxy models` 列出可用模型。
认证处理	登录所选提供商（例如，ChatGPT Plus）并在本地存储会话令牌。
协议转换	接受来自 Claude Code 的 Anthropic 风格 HTTP 请求，并将其转换为提供商的原生 API 格式。
流式响应	保留 Claude Code 期望的逐令牌流式传输，使 UI 感觉即时。
本地监控 TUI	`claude-code-proxy monitor` 显示活动会话、最近请求、错误、令牌使用情况和吞吐量。
诊断与路由	根据环境变量将请求路由到适当的模型；可以按项目配置。
图像生成（可选）	暴露 `/v1/images/generations` 端点，返回使用 ChatGPT 图像配额的 base64 编码图像。
安全警告	默认仅绑定到 `127.0.0.1`；用户必须为任何外部暴露添加防火墙或反向代理保护。

谁可能使用它

喜欢 Claude Code 的开发人员，但想换成更便宜或更专业的模型。
运行多个编码代理的高级用户（例如，通过作者的 aven 任务队列），需要单个本地端点来路由到不同的后端。
研究人员在 Codex、Kimi、Grok 等之间实验模型性能，而无需重写 Claude Code 客户端。

限制

代理仅接受本地（回环）连接；公开暴露需要额外的安全步骤。
它依赖每个提供商的订阅账户；代理不提供任何免费层访问。
非官方使用可能违反提供商条款，因此用户自行承担风险。

进一步阅读

仓库链接到托管在 claude-code-proxy.raine.dev 的广泛文档（入门指南、提供商比较、配置选项、HTTP API 参考和监控 TUI 指南）。

许可证：MIT