Pilot Shell pilot CLI 命令完整参考：从激活 License 到更新升级的 8 个核心指令-二趣网

Pilot Shell pilot CLI 命令完整参考：从激活 License 到更新升级的 8 个核心指令

【免费下载链接】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 的专业上下文工程系统，其pilotCLI 是唯一的"管理入口"：激活 License、查看授权状态、启动试用、检查更新升级，全部通过它完成。本文带你快速掌握从pilot activate激活许可证到pilot update更新升级的完整命令清单，让你安装后 5 分钟内跑通全部授权流程。

💡重要前提：Pilot 不会"包裹"你的 Agent——运行claude或codex时 Pilot Shell 会自动加载，无需 wrapper 命令。pilotCLI 只负责管理、诊断与配置，位于~/.pilot/bin/pilot。绝大多数命令都支持--json输出，方便脚本化。

快速了解：pilot CLI 能做什么

类别	典型命令	用途
授权管理	`activate`/`deactivate`/`status`	激活、停用、查询 License
账户门户	`portal`	打开客户门户（席位、发票、密钥找回）
试用资格	`trial --check`/`trial --start`	检查并启动一次性试用
版本更新	`update`/`--version`	检查并升级 Pilot Shell

官方命令参考文档在 docs/docusaurus/docs/features/cli.md，CLI 的实现源码位于 launcher/cli.py。

第一步：激活 License（pilot activate）

购买后你会获得一个 License Key，在机器上执行激活即可：

pilot activate <your-license-key>

激活成功后，Pilot 的工作流、托管 Skills/Rules、记忆捕获、质量自动化等授权功能全部解锁
想查看当前机器的授权状态与等级（tier），随时运行：

pilot status pilot status --json # 结构化输出，适合脚本判断

停用与换机

在旧机器上释放授权席位：

pilot deactivate

当授权处于停用状态时，Pilot 会保持"安静降级"：

✅ Claude Code / Codex 本身完全正常，原生命令、计划、模型不受影响
⏸️ Pilot 工作流、记忆、Console 功能暂停；statusline 变为温和的恢复提示
激活一个有效的新 Key 即可恢复全部功能

忘记密码 / 找回 License Key？

pilot portal pilot portal --no-browser # 不打开浏览器，只打印门户 URL

门户（pilot portal）是找回 License Key、查看席位、发票与支付方式的地方。请用结账时使用的邮箱登录——Pilot 不会用 License Key 帮你登录，因此别人机器上的 Key 无法访问你的账单。

第二步：免费试用（pilot trial）

还没有 License？先试试 21 天免费试用：

pilot trial --check # 检查本机是否符合试用资格 pilot trial --start # 启动试用（每台机器仅一次机会） pilot trial --check --json

⚠️ 注意：trial --start是每台机器一次性的，确认资格通过后再启动。试用源码见 launcher/trial.py。

第三步：更新升级（pilot update）

pilot update # 交互式确认后更新 pilot update --yes # 跳过确认，直接升级 pilot update --json # 输出结构化结果 pilot --version # 查看当前 Pilot Shell 版本

三个常见疑问：

pilot upgrade是什么？它是pilot update的别名，效果完全相同
会更新 Claude Code / Codex 吗？不会——pilot update只升级 Pilot Shell 本身，Claude Code 和 Codex CLI 需通过它们各自的安装器独立更新
遇到问题想回退？重新运行安装脚本并设置export VERSION=11.0.1即可降级到指定版本（安装脚本见 install.sh）

更新器实现位于 launcher/updater.py，相关测试在 launcher/tests/unit/test_cli.py。

进阶：其他实用命令速查

命令	说明
`pilot spec init --type feature --title "..."`	生成符合规范的计划文件骨架
`pilot spec validate <plan> --json`	校验计划文件格式（errors/warnings/info 三级）
`pilot skills validate [path]`	校验技能清单与安装树完整性
`pilot worktree create --json <slug>`	创建隔离的 git worktree（`/spec`、`/fix`工作流使用）
`pilot customize install <source>`	团队/企业级自定义覆盖层安装
`pilot check-context --json`	查看当前上下文占用百分比（内部命令）

🧩worktree系列命令支持--lane <id>，让多个子代理并行处理不同任务时互不干扰——详见官方文档的"Orchestration lanes"章节。

常见场景：重置与刷新（Reset & Refresh）

运行几周后，会话日志与缓存积累可能拖慢速度。建议定期执行完整重置，核心步骤：

# 1. 若使用 Claude Code，先执行 /logout 登出 # 2. 备份现有配置 mv ~/.claude.json ~/.claude.json.bak mv ~/.pilot ~/.pilot.bak # 3. 用官方安装脚本重新安装 # 4. 重新激活 License，然后启动你的 Agent pilot activate <your-license-key> claude # 或 codex

忘记 License Key 时，用pilot portal到会员区找回即可。

常见问题 FAQ

Q1：pilot 命令找不到？确认安装已完成——pilot位于~/.pilot/bin/，检查该目录是否在PATH中；不在则新开一个终端再试。

Q2：激活失败怎么办？先运行pilot status查看当前状态；确认 Key 抄写无误；仍失败时用pilot portal登录门户核对授权信息。

Q3：pilot update失败或新版有 Bug？通过设置VERSION环境变量指定旧版本后重新运行安装脚本即可安全降级。

Q4：退出 Pilot 会删掉我的项目吗？不会。官方卸载脚本 uninstall.sh 会保留 Claude Code、Codex、项目文件与用户数据；--remove-tools与--purge-data两个选项均需要你显式确认。

总结

场景	命令
激活授权	`pilot activate <key>`
查看状态	`pilot status [--json]`
试用	`pilot trial --check`→`pilot trial --start`
找回 Key	`pilot portal`
更新升级	`pilot update --yes`
查看版本	`pilot --version`
停用授权	`pilot deactivate`

掌握这组pilotCLI 命令，你就拿到了 Pilot Shell 的"总开关"：授权、试用、升级、恢复，全部一行命令搞定。更多命令细节请参阅 docs/docusaurus/docs/features/cli.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析