Claude Code 最佳实践指南

type

Post

status

Published

date

Feb 27, 2026

slug

claude-code-best-practices-guide

summary

本文档的核心目标：帮助团队成员高效使用 Claude Code。内容以官方最佳实践为主线，穿插 Claude Code 之父 Boris Cherny 在 X 上分享的真实工作流（标注为 Boris Pro Tip），并从团队实践中提取实用模板。 一个核心约束贯穿全文：Claude 的上下文窗口（~200K tokens）会快速填满，而填满后性能会下降。几乎所有最佳实践都围绕这个约束展开。

前言

本文档的核心目标：帮助团队成员高效使用 Claude Code。

内容以官方最佳实践为主线，穿插 Claude Code 之父 Boris Cherny 在 X 上分享的真实工作流（标注为 Boris Pro Tip），并从团队实践中提取实用模板。

一个核心约束贯穿全文：Claude 的上下文窗口（~200K tokens）会快速填满，而填满后性能会下降。几乎所有最佳实践都围绕这个约束展开。

1. Claude Code 的核心交互模型 🟢

当你给 Claude 一个任务时，它会经历三个阶段：收集上下文、采取行动和验证结果。这些阶段相互融合。Claude 始终使用工具，无论是搜索文件以了解你的代码、编辑以进行更改，还是运行测试以检查其工作。

你的角色：

你做什么	Claude 做什么
通过 @ 引用文件，帮 Claude 看见正确的上下文	阅读文件、搜索代码、理解架构
用自然语言描述需求，帮 Claude 思考正确的方向	分析问题、规划方案、评估风险
配置权限，让 Claude 能够行动	编辑文件、运行测试、执行命令

@ 和 ! 速览

符号	作用	示例
@	感知：将文件/资源注入上下文	解释 @src/auth.ts 的逻辑
!	行动：在提示框中直接执行 Shell	! git log --oneline -5（结果注入上下文）

2. Effort Level 🟢

Opus 4.6 引入了 Adaptive Thinking（自适应思考）——Claude 会根据任务复杂度自动决定是否以及多少使用深度推理。你通过 effort level 来控制推理深度，而不再需要在提示词中写 think hard 或 ultrathink 等关键词。

三个等级：

Effort Level	推理行为	适用场景
High（默认）	Claude 几乎总是进行深度思考	复杂架构设计、多文件重构、疑难 Bug
Medium	适度思考，简单问题可能跳过	日常编码、跨文件修改、中等复杂度任务
Low	最小化思考，优先速度	简单问答、格式化、小修改

💡 API 层面还支持 max 等级（仅 Opus 4.6），思考无上限。Claude Code CLI 目前暴露 low/medium/high 三级。

配置方式（三选一）：

3. 项目目录结构全景 🟢

一个完整的 Claude Code 项目配置结构：

新手提示：刚开始只需要 CLAUDE.md 和 .claude/settings.json。其他配置随着需求逐步添加。

4. 快速验证配置 🟢

5. 你的第一次对话 🟢

安装完成后，试试这些命令快速上手：

6. 提示词结构图 🟡

一个高质量提示词的结构：

7. 结构化提示模板 🟡

功能开发模板

Bug 修复模板

代码审查模板

8. 采访模式：让 Claude 采访你 🟡

对于大型功能，让 Claude 先采访你以明确需求，而不是一开始就写代码。

AskUserQuestion：采访模式的秘密武器

AskUserQuestion 是 Claude Code 内置的一个交互工具。当 Claude 需要你做决策时，它会弹出结构化的选择题界面——不需要你打字组织语言，只需点击选项即可。

这个工具有时会被 Claude 自动触发，但你也可以显式要求使用它。

实战演示：用苏格拉底式提问对齐需求

假设你要做一个「与众不同的小游戏」，在 Claude Code 中输入：

9. 编写有效的 CLAUDE.md 🟢

CLAUDE.md 是一个特殊文件，Claude 在每次会话开始时读取它。写入 Bash 命令、代码风格、工作流规则等Claude 无法从代码中推断的信息。

什么该写，什么不该写

该写 ✅	不该写 ❌
Claude 猜不到的 Bash 命令	Claude 读代码就能知道的信息
与默认不同的代码风格规则	标准语言规范（Claude 已知）
测试指令和首选测试框架	详细的 API 文档（链接即可）
仓库约定（分支命名、PR 格式）	频繁变化的信息
项目特有的架构决策	长篇教程或解释
开发环境怪癖（必需的环境变量）	逐文件的代码库描述
常见陷阱和非显而易见的行为	"写干净的代码"之类的废话

格式自由但保持精炼，例如：

CLAUDE.md 模板集 🟢

最小可用模板

通用项目模板

前端项目模板

10. 配置权限 🟡

默认情况下，Claude Code 对可能修改系统的操作请求权限。这很安全但频繁打断你。

前言