Claude Code

工具定位

Claude Code 是 Anthropic 推出的 coding agent CLI，定位在"项目目录内运行的工程系统"，而不是单纯的聊天式编码助手。它既可直接作为开发者的工作流产品使用，也成为社区理解和复刻"Agent Harness"的教学对象。Wiki 已收录从"使用 Claude Code 做项目"到"理解其内部机制"的多份中文资料。

核心能力

• 项目级指令文件 CLAUDE.md：把目标、目录、技术栈、命令、限制等长期信息写入项目根目录，Agent 每次会话自动遵守。该机制与 Codex CLI 的 AGENTS.md 同构但属于不同工具的实例。
• 计划模式（Plan Mode）：先让 Agent 产出实施计划再开始写代码，避免直接进入不可控的实现流程。
• 上下文工程（Context Engineering）：通过 CLAUDE.md、任务拆分、Subagents 分工等手段管理有限的上下文窗口。
• 权限与安全沙箱：对外部门令、文件写入、网络访问保留显式边界。
• MCP 集成：通过 Model Context Protocol 接入外部工具与服务。
• Hooks：在 Agent 生命周期事件上挂接自定义脚本，实现自动化质检或流程控制。
• Skills：可复用的能力包，把重复工作沉淀为命名入口。
• Subagents / 多 Agent 协作：把复杂任务拆给多个子 Agent，由主计划维持统一目标。
• Slash Commands：项目级命令封装机制，把高频操作固化为可复用命令。

在 droidHZ 网站出海复盘中的角色

• 与 ChatGPT Pro、Cursor、v0、Lovable、Bolt 一起组成 MVP 构建工具链
• 用于在发现热词后快速产出可上线 MVP
• droidHZ 在 AI 网站出海复盘中将其作为 MVP 构建工具链的一环，自报订阅价格为 20 美元/月

适合哪些情况

• 希望从零开始使用 coding agent 交付真实软件（浏览器扩展、iOS App、内容流水线）。
• 已积累零散提示词，希望升级为稳定、可复现的项目工作流。
• 项目需要在长期上下文里被多个会话反复执行同一组规则。
• 任务结构复杂，需要计划—执行—验证的闭环，并需要外部分工（Subagents / MCP）。

限制与检查点

• 价格、额度与功能状态可能随 Anthropic 政策变化（droidHZ 自报订阅价格为 20 美元/月）
• 与通用对话型 Claude 产品的能力与定位不同
• 在多工具组合中应避免重复付费
• 版本时效：橙皮书教程中描述的命令与界面基于 HuaShu 橙皮书 v260411（2026-04-11），Claude Code 后续版本可能调整。
• 作者经验 ≠ 工具保证：橙皮书教程中提到的项目成果与应用商店排名属作者公开自述，本 Wiki 未独立核验。
• 权限边界即风险：MCP 凭证、Hooks 脚本、Slash Commands 都可能带来权限过宽、凭证泄露的实质风险，详见 Claude Code 在 MCP / Hooks / Slash Commands 上的权限与凭证暴露风险。
• 不适合纯手写深度调试或性能优化路径：橙皮书作者明确定位为"非传统编程路径"，对需要精细控制底层实现的场景，Claude Code 不应被包装成唯一正确路径。

中文资源矩阵

使用侧

• claude-code-orange-book（Claude Code 橙皮书仓库）：HuaShu（花叔）维护的中文 Claude Code 橙皮书仓库，覆盖项目级指令、计划模式、Hooks、Subagents、MCP 等使用方式。
• HuaShu《Claude Code 橙皮书》教程摘要：橙皮书教程摘要。
• HuaShu 借助 Claude Code 走"非传统编程路径"的独立产品制作者案例：HuaShu 借助 Claude Code 走"非传统编程路径"的独立产品制作者案例。

Vibe Coding 工作流

• vibe-coding-cn（中文 Vibe Coding 工作流仓库）：TradeCat Labs 维护的中文 Vibe Coding 工作流仓库。
• 案例：LingyiChen-AI 用 Claude Code 从零开发 AI 漫剧生成系统：用 Claude Code 从零开发 AI 漫剧生成系统的案例。

理解内部机制

• learn-claude-code（从最小循环到完整 Harness 的中文教学仓库）：shareAI-lab 维护的 learn-claude-code 教学仓库，通过 20 个阶段的可运行 Python 代码解释 Agent Harness 如何从最小循环拼出来。
• Learn Claude Code——从最小循环到完整 Harness（shareAI-lab 教学仓库教程摘要）：该仓库的中文教程摘要。
• 渐进式 Agent Harness 工程化（最小循环 → 工具 → 上下文 → 计划 → 子 Agent → Skills → MCP → 团队 → worktree）：渐进式 Harness 工程化方法。

关联方法

• CLAUDE.md 项目级指令文件（Claude Code 项目宪法）：Claude Code 版项目级指令文件方法。
• Claude Code 计划模式工作流（Plan Mode）：计划模式工作流。
• 通过 MCP 接入外部工具（Model Context Protocol）：MCP 接入外部工具。
• 用 Hooks 在 Claude Code 生命周期事件上挂接自动化脚本：Hooks 自动化。
• Claude Code Subagents 多 Agent 协作与统一主计划：Subagents 多 Agent 协作。
• 渐进式 Agent Harness 工程化（最小循环 → 工具 → 上下文 → 计划 → 子 Agent → Skills → MCP → 团队 → worktree）：渐进式 Harness 工程化方法（来自 learn-claude-code 教学仓库）。

风险与边界

• 权限与凭证暴露：MCP 凭证、Hooks 脚本、Slash Commands 都可能带来权限过宽、凭证泄露的实质风险，详见 Claude Code 在 MCP / Hooks / Slash Commands 上的权限与凭证暴露风险。
• 沙箱与权限误配：详见 risks/risk-coding-agent-sandbox-and-permission-misconfig。
• 上下文漂移与业务跑偏：详见 risks/risk-coding-agent-context-drift-and-business-miss。
• 教学实现的局限：learn-claude-code 教学代码并不等同于生产可用的 Agent 实现，详见 教学版 Agent 代码与生产系统缺失的治理能力差距。
• 教学 ≠ 官方源码：需区分 learn-claude-code 这类教学 Harness 与 Claude Code 真实内部实现的差异，详见 把教学实现的协议与结构误认为 Claude Code 官方源码或架构。

关联产品（用于组合与对照）

• ChatGPT Pro
• Cursor
• v0
• Lovable
• Bolt
• tools/Codex-CLI：同类 coding agent CLI，可用于跨工具对照。

来源

• sources/25-08-development-automation--35-src-dev-002-claude-code-orange-book--1m81cqu（HuaShu 橙皮书教程）。
• SRC-DEV-005：Learn Claude Code——从最小循环到完整 Agent Harness（learn-claude-code 教学仓库来源）。
• SRC-DEV-003：Vibe Coding 从入门到精通（中文工作流仓库）（Vibe Coding 工作流来源）。
• droidHZ AI 网站出海复盘中将 Claude Code 列为 MVP 构建工具链一环，自报订阅价格为 20 美元/月。