Skip to content

git-liu835/codex-cn-bridge

Repository files navigation

code CN Bridge

本地代理工具,将 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"
screenshot

方式二:源码运行

适合开发者,直接 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

CLI 命令

code-cn-bridge start        # 启动代理
code-cn-bridge start -v     # 启动代理(调试模式)
code-cn-bridge init         # 初始化配置
code-cn-bridge validate     # 验证配置
code-cn-bridge list-adapters # 列出适配器

桌面应用功能

页面 功能
仪表板 代理状态、请求统计、模型健康卡片
模型配置 添加/编辑/删除模型、测试连接、高级选项
全局设置 端口、日志级别、配置导入/导出
监控日志 实时 WebSocket 推送、状态码、耗时、错误高亮
关于 版本信息、项目链接

管理 API

桌面应用通过以下端点控制代理(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 安全关闭

效果展示: image 配置步骤; image 监控日志: image

About

一个让新版codex用国产模型的工具,目前适配国内主流模型,编程没有问题,codex cil,codex桌面,vs插件都可以

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors