pilotfish 是一个面向 Claude Code 的多模型编排配置方案，不是传统运行时代码库。它通过修改全局 ~/.claude 配置，让主会话使用高端模型负责规划、决策和审查，同时把搜索、批量修改、机械性实现、验证等任务委派给更便宜的子代理模型执行，以降低 Claude Code 使用成本并提升复杂编码任务的稳定性。项目主要由安装说明、Claude Code agents 模板和全局策略配置组成，采用 MIT 许可证，适合重度使用 Claude Code 的开发者、独立开发者和团队进行成本优化。
适用领域
AI 编程助手 / Claude Code 工作流优化 / 多模型编排 / AI Agent 配置 / 开发者效率工具 / LLM 成本优化 / 代码审查与验证自动化
配置难度
中等。普通开发者可以按提示词安装，但要安全使用需要理解 Claude Code 全局配置、模型别名、agents、fallback 策略以及远程配置安装的信任风险。对于已经熟悉 Claude Code 的重度用户，落地难度较低；对于新手，建议先阅读 templates 和 install 文档再安装。
商业价值
该项目的商业价值主要体现在 AI 编程成本优化和开发效率提升。对于频繁使用 Claude Code 的个人或团队，pilotfish 可能显著降低高端模型额度消耗，把昂贵模型用于规划和关键判断，把低价值高 token 工作交给更便宜的模型。同时，全局配置方式降低了多项目重复配置成本，fresh-context 验证机制也有助于提升交付质量。其直接变现空间可能有限，因为项目本身是配置模板而非 SaaS，但作为团队内部 AI 工程规范、Claude Code 最佳实践或企业级 AI 开发工作流的一部分，具备较高实用价值。
01
技术亮点
- 核心价值清晰：用高端模型做规划与审查，用便宜模型做大量执行任务，以降低 Claude Code 额度和成本消耗。
- 不需要项目级接入，全部安装在 ~/.claude/，一次配置可作用于所有项目。
- 没有复杂运行时代码，主要是三类配置文件，理解和回滚成本较低。
- 提供明确的角色划分：侦察、探索、机械执行、判断型执行、验证、安全执行。
- 强调 fresh-context verifier，让验证代理在独立上下文中审查结果，比单个会话自我反省更可靠。
- 提供 fallbackModel 降级策略，在高端模型不可用或过载时仍可继续工作。
- 安装流程要求先展示变更计划再写入，降低误改配置风险。
- README 中对安全信任边界有明确提示，建议 pin release tag 或 commit SHA，而不是盲目从 main 安装。
- MIT 许可证，便于个人和团队采用、修改和再分发。
02
目标用户
- 重度使用 Claude Code 的个人开发者
- 希望降低 Claude 订阅额度消耗的开发者
- 使用 Opus、Sonnet、Haiku 等多模型组合的 AI 编程用户
- 需要在多个项目中统一 Claude Code 全局配置的团队
- 关注 AI Agent 工作流、子代理委派和自动验证机制的开发者
- 有一定安全意识、愿意审查全局配置变更的高级用户
03
配置要求
- 需要 Claude Code，并建议使用较新版本，否则 best 模型别名、effort 和 tools frontmatter 可能不被支持或被忽略。
- 需要能够访问 GitHub raw 文件，或将仓库 clone 到本地后从本地安装。
- 会写入全局 Claude Code 配置目录 ~/.claude/，包括 settings.json、agents 目录和 CLAUDE.md。
- 主模型配置会倾向设置为 model: "best"，并添加 fallbackModel: ["opus", "sonnet"]。
- 会安装 6 个角色代理：scout、Explore、mech-executor、executor、verifier、security-executor。
- 如果用户已有 availableModels 限制，安装器可能会扩展其可用模型列表。
- Windows 原生环境可能需要注意 POSIX shell 片段兼容性；README 表示安装 agent 会回退到自身文件工具处理。
- 不同平台如 Bedrock、Vertex、Foundry 上模型别名解析可能不同，必要时需要通过 ANTHROPIC_DEFAULT_*_MODEL 环境变量固定模型版本。
04
适用场景
- 让 Claude Code 的主会话负责高层规划，把大量搜索、重构、文档更新等任务交给更便宜的模型
- 在复杂编码任务中使用 verifier 子代理进行独立新上下文验证，减少自我确认偏差
- 通过 scout 或 Explore 子代理执行只读代码查找、符号定位、配置查询等低成本任务
- 将批量机械性修改交给 Sonnet 级别的 mech-executor，节省高端模型额度
- 对安全相关任务使用 security-executor，避免高端前沿模型在防御性安全场景中的过度拒答
- 为所有项目统一配置 Claude Code 的 agent 角色、模型别名和 fallback 策略
- 在高端模型不可用或额度耗尽时，通过 fallbackModel 自动降级到 Opus 或 Sonnet
05
部署与配置
- 确保已安装并能正常使用较新版本的 Claude Code。
- 在任意 Claude Code 会话中粘贴项目提供的一键安装提示词：读取 GitHub 上的 install/AGENT-INSTALL.md 并按说明安装到全局 Claude Code 配置。
- 要求 Claude 在写入任何文件前展示完整变更计划，并在人工批准后再修改。
- 建议不要直接使用 main 分支安装生产配置，而是将 URL 中的 main 替换为已审查过的 release tag 或完整 commit SHA。
- 安装过程会合并或创建 ~/.claude/settings.json、~/.claude/agents/*.md 和 ~/.claude/CLAUDE.md 中的 orchestration 策略块。
- 安装完成后重启 Claude Code 会话，因为 agents 目录和 model 设置通常在会话启动时加载。
- 升级时重新运行安装提示词即可，安装器设计为幂等，会尽量跳过未变化文件并替换 pilotfish 管理的策略块。
06
风险与注意事项
- 这是全局 Claude Code 配置，会影响未来所有 Claude Code 会话；如果策略不符合个人习惯，可能导致意外委派或额外上下文开销。
- 安装方式类似让 Claude 读取远程 runbook 后修改本地配置，信任链依赖 GitHub 内容和用户审查，不能盲目执行。
- 如果从 main 分支安装，远程内容可能在审查后发生变化，存在供应链和配置漂移风险。
- 项目依赖 Claude Code 的模型别名、agents 机制、fallbackModel 等行为，这些能力如果被 Anthropic 改动，效果可能变化。
- README 中引用了未来日期和模型名称，例如 Fable 5、Claude Code v2.1.198 等；需要开发者自行确认当前环境中是否真实可用。
- 便宜模型执行复杂任务时可能质量不足，虽然 verifier 可缓解，但无法完全消除错误。
- 过度委派可能增加任务拆分、上下文传递和验证轮次，简单任务未必节省时间。
- 覆盖 built-in Explore 为自定义 Explore 可能改变默认行为，并可能加载用户记忆，带来额外隐私或上下文开销。
- 对企业环境而言，修改全局 AI 编程助手策略可能需要安全审查和统一管控。
2026-07-15
第19名
新收录 · github_search
2026-07-14
第17名
新收录 · github_search
2026-07-13
第19名
新收录 · github_search
2026-07-12
第23名
新收录 · github_search
2026-07-11
第30名
新收录 · github_search
