SmarAgents BridgeCodex · Claude Code

智界 SMARAGENTS · WINDOWS 10 / 11

SmarAgents Bridge

一键准备 Codex CLI、Claude Code 与 SmarAgents 模型配置，在本地安全管理客户端连接和凭据。

正在检查可用版本 查看本次更新

正在连接官方发布源

DOWNLOAD & SETUP

Windows 安装包

正在读取发布频道清单...

版本
--
发布时间
--
文件大小
--
SHA-256
等待发布清单
下载暂不可用

从下载到可用 · Windows

  1. 01

    解压并运行 CMD

    右键 ZIP 选择“全部解压缩”，进入解压后的完整文件夹，双击 Setup-SmarAgents-Bridge.cmd。

  2. 02

    在浏览器完成配置

    安装后会自动打开本机设置页。若浏览器没有自动弹出，终端里会显示 127.0.0.1 的完整地址，复制到浏览器即可。填写 API Key，再到“启动命令”选择只用 SmarAgents，或保留官方并新建 SmarAgents 命令。

  3. 03

    保存并启动使用

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

完成“保存并应用”前请保持安装窗口打开。Codex Desktop 由 Microsoft 官方渠道独立分发；下载失败不会阻塞 Bridge、Codex CLI 或 Claude Code 安装。

WHAT IT MANAGES

安静地管理复杂配置

一个 Key，多种模型读取中转返回的可用模型并写入 Windows 原生 Codex profile；CLI 配置链路已验证，Desktop 需要选择 Windows native 并在目标机实测。
只用 SmarAgents / 同时保留官方可以让原命令直接使用 SmarAgents，也可以保留官方原命令并新建一个 SmarAgents 命令。
对话直接生成图片同一图片 Skill 自动部署给两个客户端，用户无需配置 MCP 或寻找 Key。
凭据只留在本机Windows 使用 DPAPI；macOS 使用 Bridge 数据目录中的加密文件库，不触发系统钥匙串。凭据不写入发布包或 Git 仓库。

RELEASE NOTES

0.7.60 稳定版 · Windows

2026-09-14

本次更新

  • 修复 Claude Code 走中转线路时每一轮都失败：Bridge 写入的 ANTHROPIC_BASE_URL 末尾带 /v1，而 Claude Code 会自己再拼一次 /v1/messages，请求因此打到 /v1/v1/messages 被服务端拒绝。现在写入时裁掉结尾的版本段；Codex 侧的地址仍保留 /v1，不受影响。
  • Codex 与 Claude Code 现在默认共用一个对话模型，也可以各自单独指定。侧栏 Codex 组与 Claude Code 组各有一个「模型」页，选「跟随通用默认」或「单独指定」；命令行对应 --codex-model / --claude-model，传空值即恢复共用。
  • Claude Code 新增「权限」页，可直接开启绕过权限确认。默认档 Bridge 不写入任何权限键，你自己在 Claude Code 里设的模式原样生效；选择绕过后写入 permissions.defaultMode = "bypassPermissions"，你自己的 deny 与 ask 规则仍然生效，且在 Bridge 里关掉会把该键取回。
  • 设置页正文留白收窄（单边 158px → 48px），「启动命令」页去掉了恒为空的第二列，卡片改为占满宽度。
  • 修复「模型来源」二选一两段高度不等：一条后代选择器把 46px 的最小高度套到了段内补充文字上，把该段撑到 70px。同时补上分段控件此前缺失的键盘焦点环。
  • 修复自定义命令输入框的格式校验从未生效：正则末尾未转义的连字符使整条表达式在浏览器中编译失败。服务端校验一直有效，因此非法命令名从未被存入。
  • 修复中文 Windows 下卸载残留：卸载脚本缺少 UTF-8 BOM，被按系统 ANSI 码页读取，开始菜单「SmarAgents Bridge - 快速启动」快捷方式的中文名变成乱码因而删不掉。
  • 卸载前可以一并关闭正在运行的 Codex / ChatGPT 客户端，确认框会先列出将要关闭的对象。一个客户端通常对应几十个进程，界面按应用聚合显示，不再逐条罗列同名进程。
  • 修复「从中转切回官方后，中转期间创建的对话全部打不开」：那些对话在自己的记录里绑定了中转 provider，切回官方时该定义被一并移除，客户端因此拒绝加载配置。现在切换会保留这段惰性定义，旧对话可以正常打开；卸载仍逐字节还原官方配置。
  • 修复自定义 API 地址被静默替换：连接测试成功后写回模型列表时，会把用户填写的地址换成内置默认地址。使用自建网关的用户第一次保存成功后请求即发往错误地址，且界面没有任何提示。
  • 生成图片改走 /v1/responses 的 image_generation 工具。原先的 /v1/images/generations 在中转线路已不可用（返回 503），因为上游账号走 ChatGPT 登录，不提供该端点。
  • 图片 Skill 不再教模型设置那些上游实际会忽略的参数。此前它会让模型向用户声称「已用某模型高质量生成」，而上游根本没有采纳这些设置——这是不实陈述。
  • 设置页移除「图片模型」选择器与整个「图片服务」分区：上游自行决定图片模型，生成调用由对话模型承载，因此单独的图片地址与图片 Key 必然与对话侧相同。关闭生图与保留官方图片 Skill 改由 smar-codex configure --disable-image / --keep-official-image-skill 控制。
  • 步骤进度面板新增「警告」状态：步骤跑完但没达成目的（例如 Key 无效导致模型列表没拉到、客户端没能自动重启）不再显示为绿色对勾，面板也不会自动关闭，确保提示被看到。上游返回的原始报文与内部原因码不再出现在步骤行里，改写入左侧运行日志。
  • 点击切换线路时也有分步进度展示，与保存设置使用同一套面板。
  • 设置页左侧新增可折叠运行日志栏，记录最近 100 条脱敏的请求、响应、模型刷新和错误事件，支持一键清空，便于现场排查。
  • 修复 Windows 切换回 OpenAI 官方线路时的环境传递问题；设置服务现在沿用当前 Windows 平台与 Path，避免 CC Switch 残留把命令路由到错误位置。
  • 设置页遇到临时服务断连时不再只显示英文 Failed to fetch，会提示重新运行 smar-codex start-settings 恢复设置页。
  • 修复新版 Codex Desktop 对自定义 provider 的认证判断：配置会声明 requires_openai_auth = true，让客户端复用现有 auth.json API Key 并发送 Bearer Token。
  • Windows 和 macOS 共用同一套 Bridge 核心；Windows 继续使用 Setup-SmarAgents-Bridge.cmd，macOS 继续使用 ./start.sh。
  • Codex 配置完成后直接读取独立 profile 和 SmarAgents API Key，日常对话不再要求 Bridge 网关或 Node 进程持续运行；Bridge 仍负责安装和修改配置。
  • Claude Code 配置完成后由官方客户端直接读取受管 settings 并访问 SmarAgents，日常对话不再要求 Bridge 网关或 Node 进程持续运行。
  • Claude Code 使用 modelPicker.behavesAs 兼容自定义模型校验，真实请求仍发送所选 SmarAgents 模型；Windows 安装包更新到 Claude Code 2.1.263。
  • Windows 新安装默认让图片和对话共用同一个 API Key；只有显式选择独立图片 Key 才会额外要求填写。
  • 修复 Claude Code 同时注入两种 Anthropic 凭据的警告；升级会清理旧配置残留，并保留切回官方模式时的精确恢复能力。
  • Claude Code 的 /v1/messages 云端适配已完成最小真实请求验证，gpt-5.6-sol 正常返回 OK。
  • Windows 原生 Codex CLI 与 Desktop 共用同一个 `%USERPROFILE%\\.codex` profile；当前已验证 CLI 读取模型和中转 Key，Desktop 仍需在目标机选择 Windows native、重启 App 后实测。
  • 客户端明确选择的模型名称会原样转发给中转，不再被默认模型覆盖；图片模型不会混入对话模型列表。
  • 新增开始菜单 SmarAgents Bridge - 快速启动。安装后可随时重新打开设置页，并可启动 ChatGPT Desktop 或 Claude Code；Desktop 的实际可用性取决于 App 的 Windows native / WSL agent 选择。
  • 设置服务支持单实例复用，重复点击快速启动不会不断创建新的后台服务。
  • Codex 的 SmarAgents / OpenAI 线路卡可以直接点击切换，保存时仍保持官方登录与中转配置隔离。
  • API Key 区域新增 SmarAgents 获取 Key 和购买订阅入口；没有 Key 或订阅时可以直接前往对应页面。
  • 设置保存失败时会自动定位到缺失的 API Key 或权限确认项，并把内部配置备份错误转换为可读提示。
  • 正式发布包改为只包含编译后的 bridge-cli.mjs 运行产物，不再把完整 src/ 源码交付给用户；安装和更新流程保持不变。
  • 严格移除本地网关、网关自启动和旧兼容入口；配置完成后客户端直接访问远端服务，Bridge 可以退出或卸载。
  • 完全访问确认会随已保存权限状态回填，重新打开设置页不再重复勾选；模型区域新增可点击的可用模型下拉，同时保留手写模型名称。
  • 新增设置页和命令行卸载入口，只清理 Bridge 自己的配置、凭据、别名、图片 Skill、运行时和启动项；官方 Codex/Claude 配置与未识别文件保留。
  • 卸载时如果 shell 配置中的 Bridge PATH 标记不完整，会保留整个配置文件，避免误删标记之后的用户设置。
  • 保留 0.7.2 的覆盖升级、独立更新器、国内镜像回退、图片 Skill、DPAPI 凭据保护和 Claude Code 协议转换。

已知限制

  • Windows 安装包支持 Windows 10/11；Claude Code ARM64 安装流程尚未完成 ARM64 Windows 实机验证。
  • 安装包尚未配置组织代码签名证书，正式推广前仍需完成签名。
  • Claude Code 本轮仍使用单一默认模型；多模型选择仅适用于 Codex CLI 与 Windows 原生 Codex Desktop profile。
  • ChatGPT Desktop 由 Microsoft 官方渠道独立分发；Bridge 安装包不包含桌面客户端。
  • Desktop 默认可使用 Windows native agent 并读取 %USERPROFILE%\\.codex；如果切换到 WSL agent，Bridge 不会自动同步 WSL 的 ~/.codex。设置页会检查 profile 目录并提示边界，但不能替代目标 Windows App 的实际对话验收；CLI 仍可独立使用。
  • Bridge 仍负责安装、配置修改、设置页和图片 Skill；Claude Code 配置完成后由官方客户端直接访问 SmarAgents。