Claude Code 不只是一个代码补全工具,它是一个能真正理解你的代码库、帮你思考、帮你执行的 AI 开发伙伴。本文从安装配置出发,逐步覆盖核心工作流、命令技巧、高级用法,最后落脚到 AI 时代程序员的成长路径——希望帮你从”会用”走向”用好”。
Claude Code 是如何工作的
在动手之前,先理解它的运作方式,会让后续所有操作更有依据。
当你给 Claude Code 一个任务,它始终经历三个阶段:
- 收集上下文 — 搜索文件、阅读代码、定位相关模块
- 采取行动 — 编辑文件、执行命令、调用工具
- 验证结果 — 运行测试、检查输出、确认无误
这三个阶段并非严格线性,而是交织推进的。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 | cd your-project |
第一件事,运行 /init 让 Claude 自动扫描代码库,生成 CLAUDE.md 项目配置文件:
1 | /init |
CLAUDE.md 是 Claude Code 的”项目说明书”,它会在每次会话开始时自动加载,告诉 Claude 这个项目的技术栈、约定、注意事项。花时间维护好这个文件,是整个使用过程中 ROI 最高的单次投入。
其他初始化命令:
1 | /config # 查看或修改全局配置 |
完成这些配置后,后续每次会话都能直接进入状态,无需重复交代背景。
核心工作流:先探索,再计划,再编码
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 当作基础操作而非可选步骤。他的日常流程是:
- 第一个
Claude会话在Plan Mode下理解代码、生成实施计划 - 打开第二个独立的
Claude会话,专门用来审计第一个会话的计划是否合理 - 两个会话都认可计划后,才切换到
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 | # 全局开发规范 |
总结
回顾整个流程:
- 安装 Claude Code,选择适合你的运行环境
- 初始化项目,写好
CLAUDE.md,配置权限和插件 - 养成四阶段工作流,探索 → 计划 → 编码 → 提交,在 Plan Mode 下充分对齐再动手
- 管理好上下文窗口,用
/compact、/clear、/rewind掌控会话节奏 - 持续扩展技术广度和认知深度,让 AI 工具放大你的判断力,而不是代替它
Claude Code 的价值,不在于让你少写代码,而在于让你把精力集中在真正需要人类判断的地方。从这个角度来看,学会用好它,本身就是一种核心竞争力。
个人备注
此博客内容均为作者学习所做笔记,侵删!
若转作其他用途,请注明来源!