1| 1|---
2| 2|title: Claude Code 智能体编码实践
3| 3|created: 2026-05-01
4| 4|updated: 2026-05-01
5| 5|type: concept
6| 6|tags:
7| 7| - tooling
8| 8| - workflow
9| 9| - agent
10| 10|sources:
11| 11| - "raw/articles/anthropic-claude-code-agentic-coding-2026"
12| 12|confidence: high
13| 13|---
14| 14|
15| 15|# Claude Code 智能体编码实践
16| 16|
17| 17|Claude Code 是 Anthropic 推出的智能体编码环境，不同于传统聊天机器人，它能够自主读取文件、运行命令、进行代码修改并解决问题。本文档总结了 Anthropic 内部团队和外部工程师验证有效的最佳实践。
18| 18|
19| 19|## 核心原则
20| 20|
21| 21|### 1. 提供验证手段
22| 22|
23| 23|让 Claude 能够自我验证是最高杠杆的做法。包括提供测试用例、截图对比、期望输出等。没有清晰的成功标准时，Claude 可能产出看似正确但实际无效的代码。
24| 24|
25| 25|### 2. 先探索，再规划，再编码
26| 26|
27| 27|推荐四阶段工作流：
28| 28|1. 探索：使用 Plan Mode 让 Claude 阅读代码并回答问题
29| 29|2. 规划：要求 Claude 创建详细实施计划
30| 30|3. 实施：切回 Normal Mode 执行编码
31| 31|4. 提交：提交代码并创建 PR
32| 32|
33| 33|### 3. 提供精确上下文
34| 34|
35| 35|- 用 @ 引用文件而非描述位置
36| 36|- 粘贴图片/截图直接提供视觉上下文
37| 37|- 指向具体文件、约束条件和已有模式
38| 38|- 让 Claude 先查阅 git 历史再回答架构问题
39| 39|
40| 40|## 环境配置
41| 41|
42| 42|### CLAUDE.md 文件
43| 43|
44| 44|每个会话开始时 Claude 都会读取此文件，用于提供持久化上下文：
45| 45|- 包含无法从代码推断的 Bash 命令、代码风格、工作流规则
46| 46|- 支持 @path/to/import 语法引入其他文件
47| 47|- 放置位置：~/.claude/CLAUDE.md（全局）、项目根目录（团队共享）、.claude.local.md（个人）
48| 48|
49| 49|### Skills 系统
50| 50|
51| 51|在 .claude/skills/ 中创建 SKILL.md 文件，为 Claude 提供领域知识和可复用工作流：
52| 52|- Claude 在相关时自动应用
53| 53|- 可通过 /skill-name 直接调用
54| 54|- 适合编码规范、修复流程等场景
55| 55|
56| 56|### 子代理（Subagents）
57| 57|
58| 58|在 .claude/agents/ 中定义专门助手，在独立上下文中运行：
59| 59|- 避免污染主对话上下文
60| 60|- 适合安全审查、代码探索等隔离任务
61| 61|
62| 62|## 会话管理
63| 63|
64| 64|- 及时纠错：用 Esc 停止、Esc+Esc 回退、/clear 重置上下文
65| 65|- 积极管理上下文：不相关任务间使用 /clear，利用自动压缩和手动 /compact
66| 66|- 使用子代理调查：让子代理在独立上下文中探索，保持主对话清洁
67| 67|- 自动化与扩展：非交互模式、多会话并行、文件扇出、Auto Mode 自主运行
68| 68|
69| 69|## 外部链接
70| 70|
71| 71|- Claude Code 最佳实践官方文档
72| 72|- Claude Code 工作原理
73| 73|
来源
暂无来源