Claude-to-OpenAI Proxy - 本地代理工具

📋 前置要求

电脑上需要装 Python 3.8+。

打开终端，输入：

python3 --version

能看到版本号即可。如果没有安装：

brew install python3

打开命令提示符，输入：

python --version

如果没有安装：去 python.org 下载安装。

⚠ 注意：安装 Python 时务必勾选 "Add Python to PATH"，否则无法双击启动。

🚀 使用步骤

1

下载并解压

下载 macOS 版 ZIP，解压到任意目录。

2

双击 start.command

首次启动会自动创建虚拟环境并安装依赖，约 10-20 秒。之后启动秒开。

如果双击打开了文本编辑器：右键 start.command → 打开方式 → 终端
如果提示"无法打开"：系统设置 → 隐私与安全性 → 点击"仍要打开"

3

看到如下输出即成功

[START] Launching proxy... (Ctrl+C to stop)
* Running on http://127.0.0.1:4000

4

停止服务

在终端窗口按 Ctrl + C。

1

下载并解压

下载 Windows 版 ZIP，解压到任意目录。

2

双击 start.bat

首次启动会自动创建虚拟环境并安装依赖，约 10-20 秒。之后启动秒开。

如果 Windows 安全防护拦截：点击"更多信息" → "仍要运行"

3

看到如下输出即成功

[START] Launching proxy... (Ctrl+C to stop)
* Running on http://127.0.0.1:4000

4

停止服务

在窗口里按 Ctrl + C，然后关闭窗口。

⚙️ 配置文件

打开同目录下的 config.json：

{
  "upstream_url": "https://aiimpl.yonyoucloud.com",
  "port": 4000
}

字段	说明	默认值
`upstream_url`	Anthropic 协议的上游 API 地址	https://aiimpl.yonyoucloud.com
`port`	本地监听端口	4000

换上游地址

{
  "upstream_url": "https://api.anthropic.com",
  "port": 4000
}

改完保存，重启服务生效。

🔗 在 WorkBuddy 中使用

1

打开 WorkBuddy → 设置 → 模型 → 添加自定义模型

2

填写以下信息：

字段	填写内容
Base URL	`http://localhost:4000/v1`
API Key	你的上游 API Key
模型名	上游支持的模型名（如 `DeepSeek-V4-Pro`）

3

保存，选中新模型，开始对话。

🧪 测试

启动代理后，在终端测试：

测试连接

curl http://localhost:4000/health

返回 {"status":"ok"} 即正常。

测试对话

curl http://localhost:4000/v1/chat/completions \
  -H "Authorization: Bearer 你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"DeepSeek-V4-Pro","max_tokens":50,"messages":[{"role":"user","content":"你好"}]}'

❓ 常见问题

启动报错 "Python not found"

macOS：终端运行 brew install python3
Windows：去 python.org 重新安装，勾选 "Add Python to PATH"，然后重启电脑。

报错 "Port already in use"

端口被占用了。改 config.json 里的 port，比如改成 8080。

WorkBuddy 报 401 认证失败

检查 API Key 是否复制完整、有没有首尾空格。API Key 应该是上游服务的 Key。

WorkBuddy 报连接失败

确认代理还在运行（终端窗口没关）。确认 Base URL 是 http://localhost:4000/v1（不是 https）。

想同时用多个模型

直接在 WorkBuddy 的模型名里填不同的名字就行。代理不限制模型，上游支持什么就能调什么。

关闭终端服务就停了？

是的。这个工具是前台运行的，关窗口即停。需要用的时候双击启动即可。

会存储我的 API Key 吗？

不会。代理从请求头中读取 Key 并直接转发给上游，不做任何存储或记录。

📁 文件说明

文件	说明
`start.command`	macOS 双击启动
`start.bat`	Windows 双击启动
`config.json`	配置文件（上游地址、端口）
`claude_proxy.py`	核心代码

首次启动后会多一个 .venv 文件夹（Python 虚拟环境），属正常文件，不要删除。