ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Pilot Shell License 系统完整指南:激活、7天试用与机器绑定一次讲透

Pilot Shell License 系统完整指南:激活、7天试用与机器绑定一次讲透 Pilot Shell License 系统完整指南激活、7天试用与机器绑定一次讲透【免费下载链接】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-shellPilot Shell 是一款面向 Claude Code 与 OpenAI Codex 的上下文工程与开发规范增强工具AI coding harness。它的 License 系统决定了你的解锁层级7 天免费试用Trial、Solo 单人订阅、Team 团队订阅并内置机器绑定与失效恢复机制。本文基于仓库源码与官方文档带你快速看懂激活、试用与机器绑定的完整原理。 只需记住三条命令pilot trial --start领试用、pilot activate key激活订阅、pilot status查状态其余细节看下文。一、Pilot Shell License 系统是什么三种访问层级一图看懂Pilot Shell 的 License 共三种层级安装时自动检测当前机器处于哪一种层级价格适用对象核心权益 Trial试用免费任何新机器完整功能 7 天每台机器仅限一次 Solo$14/月1 名开发者规则/钩子/LSP/MCP、Pilot 工作流、持久记忆、浏览器控制台、跨机器技能同步 Team$35/席位/月多人团队Solo 全部 扩展共享、项目记忆共享、内置技能定制、席位管理、优先支持 所有订阅方案均可在多台个人设备上使用——一份订阅全设备通行无需为每台电脑单独付费。二、免费试用指南如何领取 7 天 Trial 并查看剩余天数试用是 Pilot Shell License 系统对新用户最友好的入口两台核心命令如下pilot trial --check # 检查本机是否还有试用资格 pilot trial --start # 启动试用每台机器一次关键规则源码里写得很明确机器绑定试用记录与本机绑定trial --start在用过一次的机器上会返回trial_already_used错误无法重置自动流程安装器会自动完成「检查资格 → 启动试用 → 显示剩余天数」成功后你会看到7-day free trial activated — X days remaining剩余天数可见试用天数实时显示在终端 statusline状态栏和 Console 控制台中到期前一目了然。试用与激活的完整安装期流程见 installer/cli.py 中的_handle_license_flow函数。三、许可证激活步骤pilot 命令速查表所有 License 操作都集中在pilot二进制位于~/.pilot/bin/pilot官方命令清单如下摘自 docs/docusaurus/docs/features/cli.md命令作用pilot activate key在本机激活 License Keypilot deactivate解除本机与 License 的绑定pilot status [--json]查看当前 License 状态与层级pilot trial --check / --start检查试用资格 / 启动试用pilot portal [--no-browser]打开客户门户席位、发票、支付方式、找回 Key两个值得注意的细节安装期最多重试 3 次若 License 无效安装器会提示输入 Key每次输入都会调用pilot activate key --json在线校验见 installer/cli.py3 次失败后才放弃并给出订阅入口门户 ≠ 登录pilot portal使用结账时的邮箱登录License Key 本身不能打开账单——因此队友机器上的 Key 无法访问你的支付信息这是刻意设计的安全边界。四、机器绑定原理~/.pilot 下的授权文件与运行时校验Pilot Shell License 系统采用「本地文件 远程校验缓存」双层机器绑定核心文件都在~/.pilot/目录下该目录在所有 Claude 配置间共享文件作用~/.pilot/.license本机授权文件是 Pilot 各钩子能否执行的第一道门~/.pilot/.license-access.json「访问中断」标记出现后所有付费钩子立即静默停跑pilot verify --json会话级校验带24 小时 TTL 缓存正常路径零网络延迟具体机制在两份钩子源码中一目了然钩子门控pilot/hooks/run_if_licensed.py每个 Pilot 钩子执行前先检查.license是否存在、.license-access.json是否出现。有效则通过os.execv替换为真实钩子继续跑无效则直接跳过不产生任何副作用。会话校验pilot/hooks/license_check.py作为SessionStart钩子在每次会话开始时调用pilot verify --json复核状态走 24h 缓存不拖慢启动。这套设计的巧妙之处校验状态存在本地校验逻辑却是「先跑再核对」既保证响应速度又让失效能被及时感知。五、License 失效会怎样不阻塞的降级设计与恢复方法⚠️ 这是新手最关心的问题License 失效后Pilot Shell不会锁死你的终端。官方采用 fail-open故障放行设计Claude Code 与 Codex 本身保持可用只是 Pilot 托管的规则、工作流、质量钩子、Console 与状态栏指标被暂停statusline 变为一条平静的恢复提示Console 只打开License 恢复屏提示激活新 Keypilot activate、pilot status、pilot portal、版本更新与安全卸载器始终可用——不想继续用 Pilot随时可以干净卸载不会带走你的 AI 编码代理和用户数据输入一个新的有效 Key 即可立刻恢复全部功能。会话级通知区分四种失效状态见 pilot/hooks/license_check.pydeactivated被停用、trial_expired试用结束、validation_required无法在线验证、invalid无有效授权。六、多台设备与团队订阅License Key 找回与席位管理换电脑/重装系统在新机器执行pilot activate your-license-key重新绑定即可同一 Key 可在多台个人设备上先后激活忘记 Keypilot portal打开客户门户用结账邮箱登录即可找回 License Key、查看发票、增删团队席位门户能力见 installer 文档 与pilot portal说明团队扩容Team 层级在门户中集中管理席位新成员拿到自己的 Key 后在各自机器上pilot activate即可扩展与项目记忆通过仓库共享。七、常见 License 错误速查表现象 / 错误含义解决方法trial_already_used本机已用过试用购买订阅或换机器试用Trial has expired7 天试用结束输入 License Key 激活deactivated访问被远程停用联系支持或激活新 Keyvalidation_requiredKey 无法在线验证常因断网联网后等待缓存刷新expired订阅Solo/Team 订阅到期在门户续费后自动恢复结语为什么这套 License 设计值得参考Pilot Shell License 系统的精髓可以概括为三点试用机器绑定防白嫖每台机器一次、运行时校验零延迟本地文件 24h 缓存、失效体验不粗暴降级提示而非锁死。如果你正在为自己的 AI 工具设计授权体系installer/cli.py、pilot/hooks/run_if_licensed.py 与 pilot/hooks/license_check.py 是三个最值得精读的文件。延伸阅读 官方文档License auth 章节docs/docusaurus/docs/features/cli.md 安装与重新激活指南docs/docusaurus/docs/getting-started/installation.md 订阅方案与权益源码docs/site/src/components/PricingSection.tsx 钩子生命周期License 钩子挂载点pilot/hooks/hook-lifecycle.json【免费下载链接】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),仅供参考
返回列表