Claude Code 实践集锦:从入门到高效开发

Claude Code 不只是一个代码补全工具,它是一个能真正理解你的代码库、帮你思考、帮你执行的 AI 开发伙伴。本文从安装配置出发,逐步覆盖核心工作流、命令技巧、高级用法,最后落脚到 AI 时代程序员的成长路径——希望帮你从”会用”走向”用好”。


Claude Code 是如何工作的

在动手之前,先理解它的运作方式,会让后续所有操作更有依据。

当你给 Claude Code 一个任务,它始终经历三个阶段:

  1. 收集上下文 — 搜索文件、阅读代码、定位相关模块
  2. 采取行动 — 编辑文件、执行命令、调用工具
  3. 验证结果 — 运行测试、检查输出、确认无误

这三个阶段并非严格线性,而是交织推进的。Claude Code 始终通过工具与环境交互——它不是在”猜”你的代码,而是真正在读、在改、在测。理解这一点,你就能更好地引导它,而不是跟它博弈。


安装与启动

安装

1
curl -fsSL https://claude.ai/install.sh | bash

验证安装

1
claude --version

首次登录

首次运行会引导你完成登录,支持三种方式:

方式 适合谁
Claude Max/Pro 订阅 个人开发者,通过 claude.ai 授权
Anthropic Console API Key 企业或自定义集成场景
第三方提供商(AWS Bedrock / Google Vertex) 需要私有化部署或合规要求的团队

如果你需要在多个 API 提供商之间切换,可以使用 cc switch 命令快速管理。


选择你的运行环境

Claude Code 支持多种运行环境,不同场景各有侧重:

环境 适用场景 特点
终端 CLI 日常开发主力 功能最完整,直接操作文件系统
VS Code 扩展 偏好 IDE 内操作 内联 Diff、@ 引用文件、计划审查
JetBrains 插件 IntelliJ/PyCharm 用户 交互式 Diff、精细选择上下文
Desktop 应用 多任务并行 可视化 Diff 审查,多窗口管理
Web 版 无需本地安装 云端运行,适合长时间后台任务
Chrome 扩展 UI 测试与调试 直接操作浏览器,验证前端行为

实用建议:终端 CLI 是功能最完整的入口,推荐作为主力。VS Code 扩展适合习惯在 IDE 内操作的开发者。两者并不冲突,可以同时启用。


初始化项目配置

进入项目目录,启动 Claude Code:

1
2
cd your-project
claude

第一件事,运行 /init 让 Claude 自动扫描代码库,生成 CLAUDE.md 项目配置文件:

1
/init

CLAUDE.md 是 Claude Code 的”项目说明书”,它会在每次会话开始时自动加载,告诉 Claude 这个项目的技术栈、约定、注意事项。花时间维护好这个文件,是整个使用过程中 ROI 最高的单次投入。

其他初始化命令:

1
2
3
4
/config      # 查看或修改全局配置
/permissions # 查看或修改文件操作权限规则
/cost # 查看当前会话的 token 用量
/context # 查看上下文消耗分布

完成这些配置后,后续每次会话都能直接进入状态,无需重复交代背景。


核心工作流:先探索,再计划,再编码

Claude Code 官方推荐的最佳实践,也是从”凑合能用”到”高效使用”最关键的一步。

核心原则:将研究与规划和实现分离,避免一开始就在错误的方向上写代码。

四阶段工作流

阶段 模式 做什么 操作
探索 Plan Mode(只读) 理解代码库结构,定位相关文件和逻辑 Shift+Tab 进入 Plan Mode
计划 Plan Mode(只读) 制定实施方案,确认改动范围和边界 Ctrl+G 在编辑器中编辑计划
编码 Normal Mode 按计划逐步实现,边写边运行测试 Shift+Tab 切回 Normal Mode
提交 Normal Mode 提交代码,创建 Pull Request /commit-push-pr

Plan Mode 是只读的—— Claude 在这个模式下只会分析和规划,不会修改任何文件。这让你可以安全地让它”先看看”,等计划对齐后再动手。

进阶技巧:双会话审计

有经验的用户(如 Boris)会把 Plan Mode 当作基础操作而非可选步骤。他的日常流程是:

  1. 第一个 Claude 会话在 Plan Mode 下理解代码、生成实施计划
  2. 打开第二个独立的 Claude 会话,专门用来审计第一个会话的计划是否合理
  3. 两个会话都认可计划后,才切换到 Normal Mode 开始编码

这种双会话审计模式的好处是:两个会话之间没有上下文共享,能给出更独立客观的判断,有效避免单一视角下的方向性错误。


常用命令速查

熟悉这些命令,能大幅减少重复操作:

命令 用途
/compact 压缩上下文历史,释放 token 空间
/clear 清空当前会话,重新开始
/rewind 打开回退菜单,撤销上一步操作
/code-review 对当前改动进行代码审查
/simplify 内置简化技能,精简复杂实现
/mcp 管理 MCP 工具与外部连接
/agent 管理子代理任务
/skills 查看已安装的技能列表
/exit 退出 Claude Code

关于回退

Claude Code 在每次操作前都会自动创建检查点。如果某次修改结果不满意,按两次 Esc 或运行 /rewind 即可进入回退菜单,选择回到任意历史状态——这让你可以大胆尝试,出错了也随时能回头。

内置技能

  • /simplify 与 /batch:用于简化冗长实现或批量执行重复任务
  • /btw:子代理的逆操作——当子代理完成子任务后,用这个命令将结果合并回主上下文

让 Claude Code 表现更好的实用技巧

Claude Code 的输出质量,很大程度上取决于你给它的上下文质量。

指令要具体,不要模糊

模糊的指令会让 Claude 做很多猜测,增加出错概率。好的指令应该包含:

  • 背景和约束(”这个函数被三个地方调用,不能改签名”)
  • 预期行为(”输入空字符串时应该返回 null,而不是抛出异常”)
  • 参考文件(使用 @文件名 直接引用)

用苏格拉底式提问对齐需求

在开始写代码前,先让 Claude Code 反问你几个问题:

“在实现之前,你有哪些不确定的地方需要我澄清?”

这个步骤能暴露你自己都没意识到的隐藏假设,避免编码方向从一开始就跑偏。

上下文窗口是最重要的资源

上下文窗口是有限的,管理好它是高效使用 Claude Code 的关键:

  • 任务切换时用 /clear 重置,避免旧上下文干扰新任务
  • 长会话中用 /compact 压缩历史,节省 token
  • 把最重要的信息放在对话最前面或 CLAUDE.md 中,确保 Claude 的注意力集中在关键内容上

配置是一次性投入,收益是长期的

CLAUDE.md、权限规则、自定义子代理——这些配置一旦建立,每次会话都自动生效。别跳过这些设置,它们是真正的效率杠杆。


扩展能力

推荐安装的 Plugins

Plugin 用途
playwright UI 自动化测试,让 Claude 直接操作浏览器验证前端行为
superpowers 增强型能力扩展,解锁更多工具调用
feishu 飞书集成,将开发动作与团队协作工具打通
context7 通读当前最新文本和代码

创建自定义子代理

对于复杂任务,可以将不同职责拆分给多个子代理并行处理:

  • 主 Claude 负责协调和决策
  • 子代理负责具体的执行任务(如:一个负责写测试,一个负责写实现)
  • 用 /btw 将子代理的结果合并回主上下文

这种模式能显著加快复杂任务的完成速度,同时保持各部分的独立性。

自定义状态栏(Status Line)

在终端 CLI 中,可以配置状态栏实时显示:token 用量、当前模式(Plan/Normal)、活跃工具列表等信息。养成随时关注这些指标的习惯,有助于掌控会话节奏。


AI 时代程序员的成长路径

在掌握 Claude Code 的使用技巧后,下一个问题自然浮现:AI 会写代码了,那程序员的价值在哪?

答案不是”AI 替代程序员”,而是”AI 让不同能力的差距被放大”。能驾驭 AI 工具的工程师,生产力会远超那些只会堆砌 CRUD 的人。

需要补齐的技术广度

方向 核心内容
前端 现代框架(React/Vue)、UI/UX 设计感知、浏览器渲染原理
后端 API 设计、数据库性能优化、并发与分布式基础
架构 系统设计、微服务拆分、可观测性、安全边界

需要建立的认知深度

方向 核心内容
通用知识 算法与数据结构、网络协议、操作系统原理
业务场景 理解产品逻辑、用户需求分析、成本与工程的权衡
行业发展 跟踪 AI 工具演进、评估技术趋势、形成独立判断框架

真正无法被替代的能力

AI 能写代码,但以下这些它做不了:

  • 定义正确的问题 — 知道该解决什么,比知道怎么解决更重要
  • 系统级思维 — 理解改动的连锁影响,看到组件间的隐性依赖
  • 审查与判断 — 识别 AI 输出中的错误、风险、和过度设计
  • 沟通与协作 — 与团队对齐目标,推动方案真正落地

程序员的核心价值正在从”会写代码”转向”能定义问题、审查方案、把握方向”。Claude Code 是杠杆,而你是决定这根杠杆撬动什么的人。

CLAUDE.md

最后分享下我的全局 CLAUDE.md,有需要的可以自行修改后取用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# 全局开发规范

## 技术栈
- 后端:Java
- 前端:Vue
- 具体框架版本、构建工具等以各项目自身的 README / 项目内 CLAUDE.md 为准,本文件只约定跨项目通用的协作习惯。

## 工作方式
- 涉及较大改动(新功能、架构调整、跨多个模块或文件的修改)前,先说明实现计划/思路,经确认后再动手。
- 明确、范围小的修改(修 bug、调样式、改文案等)可以直接处理,不必每次都先确认。

## 代码风格
- 遵循 Java、Vue 社区通用的开发规范与最佳实践(如命名规范、代码分层、常见设计模式、Vue 官方风格指南等)。
- 若项目已有明确的风格/Lint/格式化配置,优先遵循项目规范,保持与现有代码一致;没有明确规范时按通用规范执行。

## 验证要求
- 完成代码改动后,必须运行相应测试(单元测试或项目现有测试套件)进行验证,确认没有引入问题后才算完成。
- 若项目暂无可用测试,需说明情况,并尽量通过编译、lint 等方式做基本验证。
- 全局测试覆盖率要求:新增/修改的代码测试覆盖率不低于 80%,未达标时需说明原因或补充测试。

## TDD 倾向
- 涉及核心逻辑或 Bug 修复时,优先采用“写测试 → 验证失败 → 编写代码 → 测试通过”的流程:先写出能复现问题/覆盖需求的测试用例,确认测试先失败,再编写实现代码,最后跑测试确认通过。

## Git 操作
- 不要自动执行 `git commit` 或 `git push`。
- 代码改完后交由用户自行决定提交时机,Claude 只负责改代码。

## 禁止事项
- 不要删除文件或数据,除非用户明确要求。
- 不要修改配置文件或环境文件(如 `.env`、系统/部署配置等),除非用户明确要求。
- 不要安装新的依赖或第三方包,除非用户明确同意。

## 沟通风格
- 使用中文回复。
- 关键决策、权衡取舍、潜在风险需要适度说明原因,但不过度展开、不啰嗦。
- 代码本身的注释、变量/方法命名保持英文习惯,符合行业惯例;日常交流用中文。

总结

回顾整个流程:

  1. 安装 Claude Code,选择适合你的运行环境
  2. 初始化项目,写好 CLAUDE.md,配置权限和插件
  3. 养成四阶段工作流,探索 → 计划 → 编码 → 提交,在 Plan Mode 下充分对齐再动手
  4. 管理好上下文窗口,用 /compact、/clear、/rewind 掌控会话节奏
  5. 持续扩展技术广度和认知深度,让 AI 工具放大你的判断力,而不是代替它

Claude Code 的价值,不在于让你少写代码,而在于让你把精力集中在真正需要人类判断的地方。从这个角度来看,学会用好它,本身就是一种核心竞争力。


个人备注

此博客内容均为作者学习所做笔记,侵删!
若转作其他用途,请注明来源!