Claude Proxy

Claude-to-OpenAI API 代理

这是一个部署在 Cloudflare Workers 上的 TypeScript 项目，它充当一个代理服务器，能够将 Claude API 格式的请求无缝转换为 OpenAI API 格式。这使得任何与 Claude API 兼容的客户端（例如官方的 @anthropic-ai/claude-code CLI）都能够与任何支持 OpenAI API 格式的服务进行通信，如 Google Gemini, Groq, Ollama 等。

✨ 功能特性

  * 动态路由：无需修改或重新部署代码，即可将请求代理到任意 OpenAI 兼容的 API 端点。目标 API 的地址和模型名称可以直接在请求的 URL 路径中动态指定。
  * 全功能 API 兼容：完全支持 Claude 的 /v1/messages 端点，包括流式 (streaming) 和非流式响应。
  * Tool Calling (函数调用)转换：自动且智能地将 Claude 的 tools 格式转换为 OpenAI 的格式。同时会对 input_schema 进行清理，以确保与 Google Gemini 等要求严格的 API 兼容。
  * Haiku 模型快捷方式：可透过 Cloudflare 的环境变量，为特定的 "Haiku" 模型配置一个固定的路由，方便快速调用。
  * 一键配置脚本：提供 claude_proxy.sh 脚本，通过交互式问答，引导用户一键完成本地 claude CLI 工具的安装与配置。
  * 轻松部署：可以一键将服务部署到 Cloudflare Workers 的全球网络。

🔬 工作原理：神奇的动态路由

本代理最核心的功能是其动态路由机制。它通过解析请求的 URL 来决定最终要访问的目标 API 和模型。

URL 格式：
https:///////v1/messages

处理流程：

1.  当一个请求发送到代理地址时，代理会解析 URL，从中提取出目标服务的 Base URL (例如 https://api.groq.com/openai/v1) 和模型名称 (例如 llama3-70b-8192)。
2.  代理会将请求标头 (Header) 中的 x-api-key 作为 Authorization: Bearer  转发给目标 API。
3.  代理将 Claude 格式的请求体 (Body) 转换为 OpenAI 格式，然后发送到目标的 /chat/completions 端点。
4.  最后，代理将收到的 OpenAI 格式响应转换回 Claude 格式，并返回给原始的客户端。

🚀 快速上手

我们强烈推荐使用 claude_proxy.sh 脚本来进行配置，它会自动处理所有设定。

步骤 1: 执行配置脚本

打开您的终端，直接执行以下命令：

步骤 2: 跟随互动提示进行设置

脚本将会引导您完成设置，您需要输入以下信息：

1.  Worker URL：您的代理服务地址。如果您尚未部署自己的服务，可以直接使用预设的公共地址 (https://claude-code-proxy.suixifa.workers.dev)。
2.  API Key：您的目标服务 API 密钥。例如，如果您想使用 Groq，这里就填写您的 Groq API Key。
3.  OpenAI URL：您的目标服务 API 地址 (不含 http(s):// 协议头)。例如，Groq 的地址是 api.groq.com/openai/v1。
4.  模型名称：您希望使用的模型，例如 llama3-70b-8192。

脚本会自动检查并安装 claude 命令行工具，并将您的设置写入 ~/.claude/settings.json。完成后，脚本还会发送一个测试请求来验证代理连接是否成功。

步骤 3: 开始使用！

配置完成后，您就可以直接在终端中使用 claude 命令，它将通过您设置的代理与指定的模型进行通讯。

🛠️ 进阶用法：自托管部署

如果您希望拥有自己的代理服务，可以按照以下步骤将此项目部署到您自己的 Cloudflare 账户。

1\. 部署到…