Pilot Shell Claude Code与Codex支持差异完整清单:上下文工程功能归属一篇看懂
【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell
Pilot Shell 是一款面向 Claude Code 与 OpenAI Codex 的专业上下文与测试框架(harness)工程系统,提供规范驱动开发、TDD、持久记忆、质量门禁、代码智能与端到端验证等完整能力。很多人装了 Pilot Shell 后会问:同一个功能,到底在 Claude Code 上能用什么,Codex 上又能用什么?本文用一份完整清单,帮你在 10 分钟内看懂两边的功能归属。
一、先搞懂定位:一个系统,两个代理
Pilot Shell 不是简单的规则包或技能合集,而是围绕 AI 编码代理搭建的一整套工程系统。它对两个代理的定位非常清晰:
- Claude Code(主力代理):功能覆盖最完整,Pilot 的大部分平台级能力都优先落地在这里
- Codex(通过 Codex CLI 或 macOS 上 ChatGPT 桌面应用内置的 Codex 运行时):所有 Pilot 工作流都能跑,但平台特性相对精简
换句话说,日常开发用 Codex 完全够用;而状态行、远程控制、LSP 深度集成等"锦上添花"的能力,目前属于 Claude Code 专属。官方对比页在 getting-started/codex-cli.md,本文所有条目均以此为权威来源。
二、两边都支持的通用能力(放心用)
以下能力在 Claude Code 和 Codex 上完全一致,是 Pilot Shell 的核心底盘:
| 能力 | 说明 |
|---|---|
| 🧩 结构化工作流 | /prd、/spec、/build、/fix(Codex 中把/换成$即可) |
| 🔍 聚焦型工作流 | /investigate、/cleanup、/benchmark、/setup-rules、/create-skill |
| 🖥️ Console 控制台 | 全部 11 个视图,记忆与会话在两个代理之间共享 |
| 🪝 生命周期钩子 | 活跃工作恢复、SessionEnd 收尾、工作流停止守卫(stop guards) |
| ✅ 质量门禁 | 两边都有测试/构建门禁;Claude Code 额外保留编辑期 lint、格式化、类型与 TDD 钩子 |
| 🔌 MCP 服务器 | CodeGraph、Semble、mem-search、web-search 等 |
| 📏 规则与标准 | 项目 rules、编码标准、上下文优化、团队记忆 |
| 👥 审查代理 | spec-review 与 changes-review 独立审查代理 |
相关源码可参考钩子目录 pilot/hooks/ 与工作流文档 docs/docusaurus/docs/workflows/。
三、Claude Code 专属功能清单 🏷️
这部分是差异的重灾区,只有 Claude Code 才有:
- 状态行(Status Line)📊 — 每条回复下方显示实时会话指标:模型、上下文占比、5 小时/7 天用量、增删行数、Git 分支、Pilot 工作流进度。它依赖 Claude Code 专有的 stdin API,Codex 没有这个接口。详见 features/statusline.md
- 远程控制(Remote Control)📱 — 通过 Claude 手机 App 或浏览器接管本地会话,支持 Telegram、Discord、iMessage 频道,全程不出本机。详见 features/remote-control.md
- Language Server 集成💡 — LSP 驱动的实时诊断、悬浮文档、跳转定义。Codex 的替代方案是在验证阶段跑仓库级 lint/type 命令,而不是编辑期文件检查钩子
- 会话内切换模型🔄 —
/model命令中途换模型。Codex 只能用codex --model或修改config.toml /effort ultracode⚡ — Claude Code 的整项目级编排增强模式- 权限模式🔐 —
Shift+Tab循环切换 Normal / Accept Edits / Plan / Auto / Bypass 五种模式,还有 Auto Mode 分类器。Codex 侧对应的是config.toml里的approval_policy - Codex companion 审查🤖 — 在 Claude Code 内直接发起 OpenAI 对抗式审查(用 Claude 审 Codex 风格的问题)
- 扩展团队共享📤 — 通过 git remote 推送/拉取
~/.claude/下的扩展 - 斜杠命令扩展⌨️ —
.claude/commands/命令原语。Codex 目前没有对应的命令原语
四、Codex 侧的专属适配细节
差异不是单向的——Pilot 也为 Codex 做了不少"隐性"适配:
- 任务清单:Codex 0.152.0 起原生任务清单(
update_plan)默认关闭,Pilot 会在~/.codex/config.toml中自动开启(如果你显式写了enabled = false会尊重你的设置) - 子代理:当前 Codex 版本默认启用子代理,Pilot 无需额外配置。但注意:Codex 的独立会话不是共享代理树,做不到 Claude Code 的跨会话点对点消息
- 上下文管理:Codex 0.153.0+ 上,Pilot 默认开启实验性原生上下文管理器,让会话跨上下文窗口保留笔记、可检索历史线程,而不是反复压缩成一段摘要
- 模型目录:安装器会生成
~/.codex/.pilot-model-catalog.json,把新模型抬升到官方上下文上限 - 后台记忆捕获:自动选择可用的低成本模型(Claude 或 Codex 资源均可),单代理环境也能跑,详见 features/knowledge.md
五、Console:两边差异的统一出口
无论用哪个代理,本地 Console(localhost:41777)都能把差异抹平——会话、记忆、规格、变更、用量全部集中展示,数据存在本地 SQLite,永不外传。例如:
- Sessions:跨代理浏览历史会话(复制 session ID 用
/resume跳转仅限 Claude Code) - Memories:两边代理产生的记忆统一检索,支持团队共享开关
- Changes:Git diff + 代码审查标注 + 规格任务关联
完整视图说明见 features/console.md。
六、怎么选?一张决策表
| 你的场景 | 推荐代理 | 原因 |
|---|---|---|
重度/spec长任务 + 想要状态行/远程控制 | Claude Code | 平台特性最全 |
| 日常开发、跑通全部工作流即可 | Codex | 工作流完全一致,够用 |
| 需要 LSP 实时诊断辅助重构 | Claude Code | LSP 编辑期集成 |
| 已有 ChatGPT 订阅(macOS 桌面党) | Codex | 直接复用桌面应用内置运行时 |
| 团队协作、记忆共享 | 任选 | 团队记忆两边都支持 |
📌一句话总结:Pilot Shell 用"平台适配器"模式保证了两代理同一套工程标准——工作流、记忆、质量门禁、Console 全平台共享;状态行、远程控制、LSP、权限模式等平台特性则归属 Claude Code。搞清楚这份清单,你就能按自己的订阅和使用习惯,把每个功能用在对的地方。
【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考