pilot-shell

让 Claude Code 和 Codex 按工程规范干活，产出生产级代码

pilot-shell 是一个面向 Claude Code 和 Codex 的工程化智能体工作流框架，旨在解决 AI 编程助手在真实项目中难以稳定产出高质量代码的问题。它通过规范驱动的规划、强制测试驱动开发（TDD）、持久化记忆以及多层级质量检查，让 AI 编码代理具备生产级可靠性。核心能力包括：自动生成并执行规格说明、在编码前强制编写测试、跨会话保存项目上下文和决策记录，以及从语法到架构的多层质量门禁。项目采用 JavaScript 实现，深度集成 Anthropic Claude 和 OpenAI Codex 等主流编码代理，帮助开发团队将 AI 从“代码生成器”升级为“受控的工程协作者”，减少人工审查负担，提升交付一致性。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2078

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队maxritter

所属国家

官网地址https://pilot-shell.com

GitHubhttps://github.com/maxritter/pilot-shell

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言JavaScript

技术栈/模型agent-skills,agentic-engineering,ai-coding,anthropic,claude-code,code-quality,code-review,codex,codex-cli,coding-agents,context-engineering,developer-tools,harness-engineering,mcp,openai,persistent-memory,software-engineering,spec-driven-development,tdd,test-driven-development

GitHub 星标★ 2078

30天Star增速

HF 下载量

上线时间2025-10-18 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 2 分钟部署方式：命令行工具 7 步

环境要求

macOS、Linux 或 Windows（需通过 WSL2）
已安装并会使用 Claude Code 或 Codex CLI / ChatGPT 桌面端
可访问 raw.githubusercontent.com 的网络环境
具备 bash 与 curl，能执行管道命令

安装与启动步骤

1确认运行环境

在 macOS/Linux 终端或 Windows 的 WSL2 中操作。Windows 原生终端不在支持范围内，安装会写入全局环境。
2安装 Pilot Shell

执行官方安装脚本，全局安装，集成 Claude Code 与 Codex CLI 的内置概念（rules、hooks、skills、subagents、MCP）。
```
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash
```
3启动 Claude Code

安装完成后无需额外配置，直接在任意已有项目目录下运行 claude，Pilot Shell 会自动加载。
```
claude
```
4启动 Codex 客户端

使用 Codex CLI 时直接运行 codex；macOS 上也可重启 ChatGPT 桌面端并在其中打开项目。
```
codex
```
5检查更新

随时运行该命令检查是否有新版本，按提示升级即可。
```
pilot update
```
6回退旧版本

新版出现问题时，先指定 VERSION 环境变量，再重跑同一个安装脚本即可降级。版本号见 releases 页面。
```
export VERSION=11.0.2
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash
```
7卸载 Pilot Shell

卸载会移除运行时、Console、状态栏、hooks、托管的 skills/rules/agents、MCP 条目等，保留 Claude Code、Codex 与项目文件。
```
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/uninstall.sh | bash
```

关键配置

配置项	必填	说明	示例
`VERSION`	否	指定要安装/降级到的 Pilot Shell 版本号	`11.0.2`

如何确认成功

安装后能直接运行 claude 或 codex 启动代理；执行 pilot update 能正常检查更新，即安装生效。

常见问题

Q：Windows 原生系统可以直接安装吗？

A：README 说明支持 macOS、Linux 和 Windows (WSL2)，因此 Windows 需要在 WSL2 环境中执行安装脚本，原生终端未列为支持环境。

Q：安装最新版后遇到 bug 想回退怎么办？

A：在 releases 页面找到目标版本号，先执行 export VERSION=11.0.2，再重新运行官方安装脚本即可回到该版本。

Q：如何彻底卸载？

A：运行 uninstall.sh 即可，交互式卸载会分别询问是否删除 Pilot 安装的外部工具、是否清除 Pilot 数据；也可用 --remove-tools 或 --purge-data 参数显式清理。

Q：卸载会删除我的项目或 Claude Code 吗？

A：不会。卸载只移除 Pilot 自己的运行时、hooks、托管技能规则、MCP 条目与别名，Claude Code、Codex、项目文件与用户数据都会保留。

注意事项

安装是全局的，安装完成后在任意已有项目中运行 claude 或 codex 都会自动加载 Pilot Shell。
安装脚本为 curl 管道执行方式，请确认访问的是官方 raw.githubusercontent.com 地址。
降级时必须先 export VERSION 再执行同一条安装命令，否则仍会装最新版。
安装过程中还会一并安装 Open Claude Design 与 Impeccable 等配套工具，如不需要可在卸载时单独选择清除。

核心亮点

强制 TDD 流程，先写测试再实现，显著提升代码正确性
持久化记忆跨会话保留项目上下文，减少重复沟通成本
多层级质量检查覆盖语法到架构，拦截低级错误

不足之处

文档/社区待观察
依赖特定编码代理，迁移到其他工具需适配

适用场景

团队引入 AI 编码助手但需保证代码质量的生产环境
大型项目需要跨会话维护上下文和决策记录
对测试覆盖率有严格要求的合规开发流程

替代项目

Claude Code、Codex、Aider

项目介绍

pilot-shell 是智能体领域的开源项目，由 maxritter 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,078）位列前 30%，在智能体分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,804 增加到 2,078，净增 274。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：团队引入AI编码助手但需保证代码质量的生产环境。同类可对比的替代方案包括 Claude Code、Codex、Aider。

上一篇：HippocampAI

下一篇：jargo