SmarAgents BridgeCodex CLI · Codex Desktop

智界 SMARAGENTS · WINDOWS 10 / 11 · X64

SmarAgents Bridge

一键准备 Codex CLI 与 SmarAgents 模型配置，在本地安全管理线路、凭据与对话内生图。

下载 0.8.15 查看本次更新

Windows · 稳定版 0.8.15 · EXE

自动检测未完成时，可直接下载 0.8.15：Windows EXE · macOS PKG

DOWNLOAD & SETUP

Windows 安装包

稳定频道 · Windows 10/11 · x64 · EXE

版本
0.8.15
发布时间
2026/11/04
文件大小
当前发布
SHA-256
后台核对中
下载 Windows 版

从下载到可用 · Windows

  1. 01

    运行 Windows 安装程序

    下载后双击 EXE，按照系统提示运行。安装程序先准备命令行与本机设置页，无需手动解压。

  2. 02

    在浏览器完成配置

    运行 Bridge 后会打开本机设置页。若浏览器没有自动弹出，运行窗口会显示 127.0.0.1 的完整地址，复制到浏览器即可。在「对话凭据」填写 Base URL 与 API Key，选择模型及思考强度，再选择 SmarAgents 中转或 OpenAI 官方线路。本机地址只用于设置页，模型请求通过 Codex 原生配置直接连接上游。

  3. 03

    保存并启动使用

    点击“保存并应用”，然后按页面显示的命令启动 Codex。以后也能从开始菜单重新打开设置。

先安装 Codex CLI 并完成设置。Desktop 是可选项，点击设置页“桌面版（可选）”后再按 Windows 引导安装。安装程序尚未签名，系统可能显示安全提示。

WHAT IT MANAGES

安静地管理复杂配置

一个 Key，多种模型读取中转返回的模型并写入 Codex 配置，思考强度按上游声明显示，缺少声明时标记为未确认。Windows Desktop 请选择 Windows native，沿用本机保存的设置。
只用 SmarAgents / 两条线路并存可以让 codex 直接走 SmarAgents，也可以保留官方 codex 并新建一个走中转的 cx-smar，两条线路的配置互不污染。
对话里直接出图Bridge 写一张 MCP 表，进程由 Codex 自己拉起——Bridge 关掉也能继续生图。不必自己配 MCP 或另找图片 Key。
凭据只留在本机Windows 使用 DPAPI 保护本机凭据；凭据不写入发布包或 Git 仓库。

LINUX / CODEX ROUTING

Linux 命令行兼容与多供应商别名

Windows 与 macOS 提供图形化安装包；Linux 提供 x64 二进制压缩包。Linux 版本需要另行准备官方 Codex CLI，并用 SHA-256 校验下载文件。

01 · Linux CLI

手工配置一条中转线路

Linux x64 压缩包自带 Bridge runtime，不需要另装 Node.js；先准备官方 Codex CLI。解压后运行终端入口，它会依次引导 API Key、模型能力清单、模型和思考强度，再启动 Codex。

./smar-start.sh

推荐入口：Linux 终端入口不会打开浏览器或后台 Bridge 服务；需要重新选择配置时运行 ./smar-start.sh --reconfigure。下面的命令适合需要逐项控制路径和配置的高级场景。

高级手工路径

export SMAR_CODEX_BRIDGE_HOME="$HOME/.local/share/SmarCodexBridge"
node bridge-cli.mjs secret-store init --mode passphrase
node bridge-cli.mjs secret set chat
node bridge-cli.mjs configure \
  --base-url "https://<relay-host>/v1" \
  --chat-model "<model-id>"
node bridge-cli.mjs install-client-config \
  --codex-home "$HOME/.codex"
node bridge-cli.mjs settings --no-open

设置页：Linux 下使用 --no-open 后，把终端打印的 127.0.0.1 地址复制到浏览器。Linux 二进制包自带 Bridge 运行时，不需要另装 Node；Codex CLI 仍需单独准备。

02 · Alias isolation

codex-ds / codex-cc

每个别名固定自己的供应商、模型、Key 引用和 CODEX_HOME。这样会话、认证文件与本地状态也分开，达到类似 ccmux 的启动隔离效果。

codex-ds  →  ~/.codex-profiles/deepseek
             provider = deepseek
             keyRef   = codex-ds-key

codex-cc  →  ~/.codex-profiles/cc
             provider = <second-provider>
             keyRef   = codex-cc-key
  • 包装器启动前清理继承的 OPENAI_*、CODEX_* 与 CC Switch 路由变量。
  • 配置使用 wire_api = "responses"，Key 通过安全存储按引用读取，不写入仓库。
  • 不要用同一个 CODEX_HOME 加 --profile 冒充额度隔离；那仍共享会话和认证状态。

验证：分别运行 codex-ds --version、codex-cc --version 和一次 exec --json，核对请求的 provider、模型、Key 身份与会话目录都不同。

RELEASE NOTES

0.8.15 稳定版 · Windows

2026-11-04

本次更新（0.8.15）

  • 自动验证 Codex 原生 Responses 连接，也可手动选择协议后验证；不支持的协议会停止配置，Bridge 不进行协议转换。
  • Codex CLI、Desktop 与 Bridge 在同一板块检测版本；有更新时可分别更新，也可一键全部更新。
  • 思考强度读取上游模型声明，未声明时显示未确认；模型与思考强度保留自定义下拉，运行日志支持脱敏 ZIP 导出。
  • 配置直接连接上游。关闭或卸载 Bridge 后，保留原生配置、认证、会话与独立客户端，继续使用 Codex。

历史版本

  • 0.8.13：新增 Chat 协议兼容、模型能力检测与脱敏运行日志。
  • 0.8.10：卸载保留自行修改的 Codex 配置，提供原生安装包与 CLI 更新入口。
  • 0.8.2：修复官方账号与中转之间切换可能失效，并自动清洗被污染的历史配置备份。
  • 0.8.1：中转线路下也能用 Codex 桌面版的 Fast；安装时 Codex 命令行保持最新；修复 Windows 卸载程序与设置页若干问题。
  • 0.8.0：模型列表、思考强度（含 Ultra）和 Fast 改为直接读取平台数据。
  • 0.7.62：生图默认直连中转的图片接口，更快更稳；也支持 SmarAgents 以外的中转。

已知限制

  • Codex 桌面版的 Fast 需要登录 ChatGPT 账号；免费账号是否可用尚未验证。
  • 安装包尚未做代码签名。
  • Codex Desktop 改用 WSL agent 时，Bridge 不会同步 WSL 里的配置。
  • 重新打开设置页：从开始菜单打开「SmarAgents Bridge - 快速启动」。