claude_codex_bridge

环境要求

• Node.js / npm 环境（用于 npm 全局安装）
• Python 3.10+（仅原生 Windows x64 beta 要求）
• Windows beta 还需 WezTerm、Git Bash 和 Herdr 0.8.0 或更高版本
• 本机已安装要调度的 CLI 编程代理（如 Codex、Claude、Gemini 等）

安装与启动步骤

1. 1npm 安装 CCB

   README 推荐普通用户使用 npm 包安装或更新 CCB，全局安装后即可使用 ccb 命令。

   npm install -g @seemseam/ccb@latest

   复制

2. 2确认版本

   安装后打印版本号，确认 CCB 已正确安装到全局环境。

   ccb --print-version

   复制

3. 3更新 CCB

   GitHub 发布包或源码安装的用户，用 CCB 自带的事务化更新器升级；npm 安装会提示等价的 npm 命令。

   ccb update

   复制

4. 4更新代理 CLI

   可选：让 CCB 检查并更新已安装的提供商 CLI，all 为非交互更新，check 仅报告，none 跳过。

   ccb update --providers all

   复制

5. 5发布包安装法

   npm 不方便时，从 Releases 下载对应 ccb-*.tar.gz 解压后执行安装脚本。

   tar -xzf ccb-*.tar.gz
   cd ccb-*
   ./install.sh install

   复制

6. 6源码安装法

   仅用于开发或临时回退：克隆仓库后执行安装脚本，会把全局 ccb / ask 链接回检出目录。

   git clone https://github.com/SeemSeam/claude_codex_bridge.git
   cd claude_codex_bridge
   ./install.sh install

   复制

7. 7Windows 原生 beta

   下载 ccb-windows-x86_64.zip 及 .sha256 校验摘要后解压，运行 PowerShell 安装脚本，会创建本地托管的 Python 运行时。

   .\install.ps1 install -Yes
   ccb --print-version

   复制

如何确认成功

执行 ccb --print-version 能正常打印出版本号，说明 CCB 已安装成功。

常见问题

注意事项

• 普通用户优先使用 npm 包安装，源码安装仅用于开发或临时回退。
• Windows beta 二进制未签名，且在该支持层级下 ccb update 仅做诊断，需重新运行校验过的 install.ps1 升级。
• CCB 管理的提供商面板会抑制提供商自带的启动更新提示，接受的更新在该面板下次启动或显式重启时生效。
• 更新流程不会重启正在运行的提供商面板。