Skip to content

快速开始

本页帮助你从零到可用,尽快启动一个多面板协作会话。

前置条件

依赖作用安装方式
tmux(或 WezTerm)提供分屏终端布局brew install tmux / apt install tmux
Claude Code主操作界面npm install -g @anthropic-ai/claude-code
Codex CLI(推荐)默认最适合做审查与实现协作npm install -g @openai/codex
Gemini CLI(可选)适合头脑风暴和替代思路参考 Gemini CLI 文档
OpenCode CLI(可选)补充实现视角参考 OpenCode 文档

安装 CurdX Bridge 之前,先确认你计划使用的 Provider CLI 都能单独启动,并且已经完成认证。

快速自检

先分别运行一次你要用的工具:

bash
claude
codex
gemini
opencode

如果这里就报错,优先修复 Provider 本身。CurdX Bridge 是调度层,不会替你完成底层环境初始化。

安装

bash
curl -fsSL https://raw.githubusercontent.com/curdx/curdx-bridge/main/install.sh | bash

安装脚本会下载适合你平台的最新发行版,并将 curdx 放到 ~/.local/bin

如果 ~/.local/bin 还没加入 PATH,请补上:

bash
export PATH="$HOME/.local/bin:$PATH"

首次启动

bash
curdx

默认会启动 claudecodexgemini

常见启动模式:

bash
curdx claude codex                     # 精简组合:实现 + 审查
curdx claude codex gemini opencode     # 四 Provider 全开
curdx --no-auto                        # 关闭自动审批,适合高风险仓库

启动后,你通常会看到:

  1. 终端被切成多个面板
  2. 每个 Provider 在自己的面板中启动
  3. Claude 位于左侧主面板
  4. 你从 Claude 开始对话

前五分钟应该怎么用

一个更真实的首轮会话通常像这样:

text
你:     先扫一下这个仓库,告诉我认证流程里最危险的部分。
Claude: [本地阅读代码并总结]

你:     让 Codex 审一下你的结论,并给修复方案打分。
Claude: [异步发送给 Codex]
        Codex processing...

你:     在 Codex 处理时,再问 Gemini 两种替代 API 方案。
Claude: [发送第二个异步请求]

你:     汇总这两个结果,并推荐一个方向。
Claude: [整合 Codex 审查和 Gemini 的发散建议]

核心心智模型很简单:你始终和 Claude 对话,其余 Provider 由 Claude 负责调用。

恢复会话

bash
curdx -r
curdx -r claude codex gemini

当你希望保留之前的 pane 上下文时,使用 -r。尤其适合:

  • 多步骤功能开发
  • 长时间审查循环
  • 跨多个终端或多个提交的排障任务

如果你只想给某个 Provider 一个全新上下文,可以改用 命令参考 中的会话命令。

推荐的入门组合

单人实现

bash
curdx claude codex

适合需要主实现与一位强审查者的日常开发。

设计探索

bash
curdx claude codex gemini

适合需要评审者和一个发散型模型的场景。

广角调查

bash
curdx claude codex gemini opencode

适合迁移、架构决策、复杂调试等需要多视角的任务。

常用自然语言指令

这些说法之所以有效,是因为它们能稳定映射到内置 Skill:

  • “让 Codex 在写代码前先审一下这个方案。”
  • “让 Gemini 给三个更轻量的备选方案。”
  • “让 Codex 检查这个 diff 是否有回归和测试缺口。”
  • “把各个 Provider 的结论汇总一下,并推荐下一步。”
  • “从上次中断的地方继续,执行下一步。”

参数

参数说明常见用途
-r恢复上次会话持续性任务
--no-auto关闭自动审批行为陌生仓库或高风险变更

从源码构建

bash
git clone https://github.com/curdx/curdx-bridge.git
cd curdx-bridge
./scripts/build-all.sh

最佳实践

  • 第一轮会话先保持简单。两到三个 Provider 比四个更容易管理。
  • 审查请求要写清标准。“按安全性和迁移风险审查”比“帮我看看”有效得多。
  • 把 Provider 面板当作可观察的 worker。看到漂移就及时重定向。
  • 恢复会话要有意识。如果仓库变化很大,重新开一局可能比 -r 更干净。

下一步

  • 阅读 工作原理 了解架构和异步模型
  • 配置 中设置默认 Provider 与角色
  • Skills 中了解完整规划与执行流水线