ccg_bridge

CCG = Claude Code (skills) + Codex + Gemini CLI.

推荐主路径（A 模式）：Claude Code 通过 skills 调用 ccg ask-async/pend，以异步方式完成跨模型协作（优先追求“快、稳”）。

这个仓库包含 CCG Bridge 的运行时代码与设计文档，并提供基于 MkDocs 的文档站点配置，便于本地预览和后续发布。

安装（全局推荐）

通过 npm 全局安装（需要 Node >=18；并要求本机可用 python3/python 用于创建 venv）：

npm i -g ccg_bridge
ccg version

首次安装会把 Python 运行时安装到 ~/.ccg/npm/ccg_bridge/venv。

A 模式快速开始（推荐：快、稳）

前提：本机已安装并登录 codex 与 gemini CLI，且 Claude Code 可用。

在项目根目录：

# 一键启动：确保 bridge + 安装/更新 Claude Code skills
ccg
# 或：ccg up --project-root .

在 Claude Code 内（分两次发送，异步更快）：

/ccg-ask gemini "Reply with exactly: G-OK"
/ccg-pend gemini --wait 120

/ccg-ask codex "Reply with exactly: C-OK"
/ccg-pend codex --wait 120

说明：

• ccg tmux 是 commander/tmux（B 模式）路径，不是 A 模式必需；A 模式不需要开 tmux 三窗口。
• 结果持久化在 <project>/.ccg/tasks/<task_id>.json；/ccg-pend 默认按 last_submitted 精确等待最新任务。

预览文档站点（MkDocs）

在仓库根目录执行：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-docs.txt
mkdocs serve

然后打开 http://127.0.0.1:8000/。