本地代理工具,将 OpenAI Responses API 翻译为 Chat Completions API,使 codex CLI, 桌面端, Vs Code插件无缝接入通义千问、DeepSeek、Kimi 等国产大模型。编程的功能都可以用,有问题可以进群交流,大家可以相互交流, QQ群:1095150579,也欢迎大家给出建议。
v2.0 新增原生桌面管理界面(Electron + React),无需编辑 YAML 或打开浏览器。
内置 Python 后端 + Node.js 前端,开箱即用,不需要装 Python、Node 等任何环境。
Windows(PowerShell 管理员运行):
irm https://github.com/git-liu835/code-cn-bridge/releases/latest/download/code-CN-Bridge-Setup-latest.exe -OutFile setup.exe; ./setup.exe /S安装到默认目录
%LocalAppData%\code CN Bridge,安装完自动在桌面和开始菜单创建快捷方式。
macOS:
curl -L -o /tmp/bridge.dmg https://github.com/git-liu835/code-cn-bridge/releases/latest/download/code-CN-Bridge-latest.dmg
hdiutil attach /tmp/bridge.dmg -nobrowse
# 手动拖入 Applications 文件夹Linux:
curl -L -o code-cn-bridge.AppImage https://github.com/git-liu835/code-cn-bridge/releases/latest/download/code-CN-Bridge-latest.AppImage
chmod +x code-cn-bridge.AppImage && ./code-cn-bridge.AppImage# 或 deb 包
curl -L -o code-cn-bridge.deb https://github.com/git-liu835/code-cn-bridge/releases/latest/download/code-CN-Bridge-latest.deb
sudo dpkg -i code-cn-bridge.deb也可以从 Releases 页面手动下载安装。
Windows Defender 提示? 项目已开源,因未购买代码签名证书,Defender 可能误报。点击「更多信息」→「仍要运行」即可。安装后打开软件 → 配置模型和 API Key → 启动代理。
配置 code CLI 连接代理:
export OPENAI_BASE_URL="http://localhost:8765/v1"
export OPENAI_API_KEY="any-value"
适合开发者,直接 clone 源码运行:
# 1. 克隆
git clone https://github.com/git-liu835/code-cn-bridge.git
cd code-cn-bridge
# 2. 安装 Python 依赖
pip install -e .
# 3. 配置 API Key(复制模板并填入真实 key)
cp example.env .env
# 编辑 .env 填入你的 API 密钥
# 4. 启动桌面应用(需要 Node.js)
cd desktop && npm install && npm run electron:dev
# 或者纯命令行模式
code-cn-bridge start关闭主窗口后,代理继续在系统托盘运行。
code-cn-bridge init --provider qwen
export QWEN_API_KEY="your-api-key"
code-cn-bridge start配置文件默认路径:~/.code-cn-bridge.yaml(CLI 和桌面版共用)
server:
host: 127.0.0.1
port: 8765
providers:
qwen:
adapter: qwen
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
api_key_env: QWEN_API_KEY
deepseek:
adapter: deepseek
base_url: https://api.deepseek.com/v1
api_key_env: DEEPSEEK_API_KEY
model_mapping:
"gpt-5-code": "qwen-plus"
"gpt-5-code-light": "qwen-turbo"| 模型 | 适配器 | 功能调用 | 流式输出 |
|---|---|---|---|
| 通义千问 | qwen | ✅ | ✅ |
| DeepSeek | deepseek | ✅ | ✅ |
| Kimi | kimi | ✅ | ✅ |
| 豆包/火山 | doubao | ✅ | ✅ |
| 智谱 GLM | zhipu | ✅ | ✅ |
code-cn-bridge start # 启动代理
code-cn-bridge start -v # 启动代理(调试模式)
code-cn-bridge init # 初始化配置
code-cn-bridge validate # 验证配置
code-cn-bridge list-adapters # 列出适配器| 页面 | 功能 |
|---|---|
| 仪表板 | 代理状态、请求统计、模型健康卡片 |
| 模型配置 | 添加/编辑/删除模型、测试连接、高级选项 |
| 全局设置 | 端口、日志级别、配置导入/导出 |
| 监控日志 | 实时 WebSocket 推送、状态码、耗时、错误高亮 |
| 关于 | 版本信息、项目链接 |
桌面应用通过以下端点控制代理(localhost:8765/admin/api):
| 方法 | 路径 | 描述 |
|---|---|---|
| GET | /status |
代理运行状态 |
| GET/POST | /models |
模型列表/添加 |
| PUT/DELETE | /models/{name} |
更新/删除模型 |
| POST | /models/{name}/test |
测试连接 |
| GET/PUT | /settings |
全局设置 |
| GET | /logs |
请求日志 |
| WS | /logs/stream |
实时日志流 |
| GET | /config/export |
导出配置 |
| POST | /config/import |
导入配置 |
| POST | /shutdown |
安全关闭 |


