Claude Code 完全指南：使用方式、技巧与最佳实践

最近在深度使用 Claude Code，发现真的很香！即整理了一份全面的指南，从零开始逐步了解 Claude Code 的核心功能、高级特性和最佳实践。这篇博客实际上更像是一本工具书，让我自己在使用时也能随时参考其内容，更好的使用这个强大的 AI 工具。

• 一、Claude Code 简介
• 二、安装与配置
• 三、核心概念详解
• 四、高级功能
• 五、实用技巧与快捷操作
• 六、最佳实践
• 七、实战案例
• 八、常见问题与解决方案
• 九、高级集成与扩展

---

Claude Code(CC)是由 Anthropic 开发的系统级 AI Agent,它不仅是一个代码编写工具,更是一个可以通过自然语言指令完成各种电脑任务的智能助手。

核心特性:

核心差异:

• 传统工具:单一功能,需要人工操作多个工具完成复杂任务
• Claude Code:系统级 AI Agent,通过自然语言指令即可完成全流程任务

---

必需工具:

验证安装:

全局安装(推荐):

验证安装:

Claude Code 支持多种模型配置方式,你可以根据自己的需求选择合适的模型。

方式一:手动配置(通用方式)

手动配置适用于所有兼容 Anthropic API 的模型。配置方式如下:

Windows:

macOS/Linux:

常用国内模型配置示例:

配置示例(以智谱GLM为例):

注意: 配置环境变量后需要重启终端或运行 使配置生效。

方式二:使用自动化助手(仅适用于智谱GLM)

如果选择使用智谱GLM系列模型,还可以使用自动化配置助手:

按照交互式提示完成配置:

1. 选择界面语言
2. 设置 Coding 套餐
3. 配置 API 密钥
4. 选择编码工具

这种方式可以自动完成智谱GLM模型的配置,适合不想手动设置环境变量的用户。

国内模型对比

基本启动:

危险模式(跳过权限确认):

Headless 模式(非交互式):

---

了解了 Claude Code 的安装配置后，深入了解一下它的一些核心概念。这些概念是充分发挥 Claude Code 能力的基础。

什么是 Skills?

Skills 是预封装的工作流,就像游戏中的”技能包”,用完即走,不占用上下文。它是别人已经编写好的、可直接使用的功能模块。

官方 Skills 库: https://github.com/anthropics/skills (32k+ Stars)

Skills 的类型

常用官方 Skills

如何使用 Skills

查看可用 Skills:

调用 Skill:

如何编写自己的 Skills

Skill 目录结构:

skill.json 示例:

skill.md 示例:

安装本地 Skill:

什么是 Hooks?

Hooks 是在特定事件触发时自动执行的脚本,用于自定义工作流、拦截危险操作、自动格式化代码等。

核心价值:

Hook 事件类型

Hook 配置方式

方式一:通过 /hooks 命令

方式二:通过配置文件

在 或项目 中配置:

Hook 实战示例

拦截危险命令:

自动格式化代码:

发送通知:

自动格式化代码(PostToolUse Hook):

来自创始人的实战经验 – 彻底消灭 CI 里的格式报错:

工作原理:

1. 每次 Claude 使用 或 工具后自动触发
2. 运行格式化命令(这里是 )
3. 确保即使格式化失败也不阻塞流程
4. 虽然 Claude 已经写得很规范,但这最后 10% 的自动化处理能彻底解决格式问题

效果:

• ✅ CI 中不再有格式报错
• ✅ 代码风格始终一致
• ✅ 无需手动运行格式化
• ✅ Git diff 更清晰

什么是 Plugins?

Plugins 是打包在一起的扩展集合,可以包含:

• 5 个 Skills
• 10 个斜杠命令
• 3 个 MCP 服务器配置
• 2 个 SubAgent 定义
• 若干 Hooks

Plugins vs Skills:

Plugin 安装与使用

哪里获取已有 Plugins?

官方插件市场:

添加插件市场:

常用官方插件:

安装 Plugin

从市场安装:

从本地安装:

从GitHub安装:

查看 Plugins

查看已安装 Plugins:

浏览可用插件:

卸载 Plugin:

创建自定义 Plugin:

plugin.json 示例:

什么是 MCP?

MCP (Model Context Protocol) 是 AI 的扩展接口标准,通过添加 MCP 服务器可以扩展 Claude Code 获取claude code 教程外部工具、资源、服务的能力。

核心概念:

常用 MCP 服务器

MCP 安装方式

方式一:命令行安装

方式二:配置文件安装

编辑 :

验证安装:

Chrome DevTools MCP 实战

安装:

使用示例:

26个内置工具包括:

• : 导航到指定 URL
• : 截取页面截图
• : 点击元素
• : 填写表单
• : 选择元素
• : 执行 JavaScript
• 等等…

什么是 Subagents?

Subagents 是可以并行处理任务的独立 AI 代理,每个子代理拥有独立的 200K 上下文窗口,可以分配不同任务以提高效率。

核心理念： 把常用工作流看作自动化运行的”子智能体”,就像圣诞老人分派任务给精灵一样,每个子智能体专注于特定领域。

核心优势:

Subagent 配置

方式一:通过 /agents 命令

方式二:配置文件

在 或项目 中配置:

Subagent 使用示例

场景:完成一个功能开发

Claude Code 会自动:

1. 创建三个独立的子代理
2. 分配各自的上下文(200K × 3)
3. 并行执行任务
4. 汇总结果返回

实战子代理案例

来自 Claude Code 创始人 Boris Cherny 的实际使用案例:

code-simplifier:

verify-app:

使用方式:

什么是 CLAUDE.md?

CLAUDE.md 是 Claude Code 的”项目记忆文件”,记录项目结构、构建命令、代码规范、架构决策等信息,让 Claude Code 快速理解项目上下文。

CLAUDE.md 的作用

CLAUDE.md 最佳位置

优先级: 特定规则 > 模块配置 > 项目配置 > 用户配置

CLAUDE.md 示例

完整示例:

生成 CLAUDE.md 的方式

方式一:使用 /init 命令

Claude Code 会自动扫描项目并生成初始 CLAUDE.md,包含:

• 构建和测试命令
• 目录结构说明
• 代码规范和架构决策
• 技术栈信息

方式二:手动创建

方式三:模块化规则

方式四:Memory Updates – 动态更新记忆

CLAUDE.md 的 AI 进化机制

来自 Claude Code 创始人团队的实战经验:

核心理念: 让 Claude 在 Code Review 中自我迭代,越用越聪明

实战流程:

1. 在 PR 中发现问题

2. 让 Claude 记住教训

3. Claude 自动更新

4. 团队共同维护

价值体现:

• 🧠 集体智慧: 每个团队成员的反馈都让 AI 更聪明
• 🔄 持续进化: Claude 不会重复犯同样的错误
• 📚 知识沉淀: 项目规范自动文档化
• 🤝 团队协作: 统一的 AI 助手理解团队偏好

实际案例:

---

实际上CC还有一些高级功能，这些功能将帮助更高效地完成复杂任务。

什么是 Plan 模式?

Plan 模式是一种”先规划、后执行”的工作模式,Claude 会先分析项目架构、依赖关系并起草实现方案,确认后才开始编写代码。

Anthropic 开发者关系负责人 Ado Kukic 有 90% 的时间都在使用这个模式。

核心价值: 在这个模式下,Claude 会阅读代码、分析架构、起草计划,但绝不修改代码。直到你批准计划,它才会动手。你是架构师,它是执行者。

核心价值:

进入 Plan 模式

快捷键:

命令方式:

Plan 模式工作流程

1. 探索阶段

• 读取相关文件
• 分析代码结构
• 理解依赖关系

2. 规划阶段

• 设计实现方案
• 列出具体步骤
• 识别潜在风险

3. 确认阶段

• 展示完整计划
• 等待用户反馈
• 根据反馈调整

4. 执行阶段

• 按计划实施
• 实时反馈进度
• 处理异常情况

Plan 模式最佳实践

适合场景:

• ✅ 复杂功能开发(多文件、多步骤)
• ✅ 架构重构
• ✅ 性能优化
• ✅ 代码迁移
• ✅ 不熟悉的项目

不适合场景:

• ❌ 简单 bug 修复
• ❌ 单行代码修改
• ❌ 文档查询
• ❌ 快速原型验证

使用技巧:

什么是 Sandbox 模式?

Sandbox 模式通过定义允许的操作范围,拦截危险操作,提高安全性。

核心机制:

配置 Sandbox 模式

方式一:通过 /permissions 命令

方式二:配置文件

编辑 :

Sandbox 最佳实践

最小权限原则:

特定项目配置:

什么是 Headless 模式?

Headless 模式是非交互式运行方式,输出结果直接流向标准输出,可集成到 Shell 脚本或 CI/CD 流程中。

使用场景:

Headless 模式使用

基本用法:

CI/CD 集成示例:

脚本自动化示例:

启用 Vim 模式

Vim 常用快捷键

什么是 Slash Commands?

Slash Commands 是将高频工作流封装成可复用的斜杠命令,将复杂的”人机对话”变成简单的”命令行指令”。

来自 Claude Code 创始人的实战经验:为了避免重复输入相同的 Prompt,他将高频工作流封装成了 Slash Commands。

创建自定义命令

方式一:通过 /commands 命令

方式二:手动创建

在 目录创建 Markdown 文件:

示例1:自动提交并创建 PR

使用:

示例2:生成每日站会日报

使用:

实战案例

完整的部署工作流:

价值:

• ✅ 一键执行复杂流程
• ✅ 减少人为错误
• ✅ 团队共享最佳实践
• ✅ 可以签入 Git 版本控制

ultrathink 深度思考模式

当你需要设计复杂的缓存层或重构架构时,在提示词中加上 。

效果:

• Claude 会分配高达 32k 的 Token 进行内部推理
• 虽然反应慢一点,但逻辑准确率大幅提升
• 适合架构设计、复杂重构等关键任务

Extended Thinking API

通过 API 调用时,开启 Extended Thinking 可以看到 Claude 的逐步推理过程(Thinking Blocks)。

价值:

• 透明化思考过程
• 便于调试复杂逻辑
• 理解 Claude 的决策路径
• 教学和学习工具

---

了解了 Claude Code 的高级功能后，分享一些实用的技巧和快捷操作，可以更高效地使用这个工具。

项目初始化(/init)

快速引用上下文(@提及)

即时执行 Bash 命令(!前缀)

回退操作(双击 ESC)

选项:

• 仅回退对话
• 仅回退代码
• 同时回退对话和代码

注意: 已执行的 Bash 命令无法回退

反向搜索历史提示词(Ctrl+R)

提示词暂存(Ctrl+S)

类似 Git stash,但用于提示词

智能提示补全(Prompt Suggestions)

Claude 甚至能预测你接下来想问什么:

价值:

• 减少打字量
• 发现隐藏功能
• 学习最佳实践

会话管理高级技巧

Continue & Resume – 无缝续关

Named Sessions – 会话命名

Claude Code Remote – 跨设备传送

自定义状态栏(/statusline)

可显示信息:

• Git 分支
• 当前模型
• Token 用量
• 上下文占比
• 任务进度

配置示例:

可视化上下文(/context)

显示:

• 当前 token 使用情况
• 上下文占用百分比
• 各文件占用大小
• 建议优化方向

使用统计与监控

查看使用习惯:

价值:

• 了解自己的使用模式
• 监控费用消耗
• 晒 Claude Code 统计(现在比晒 GitHub 提交记录更流行)

工作空间隔离

最佳实践:

快速启动:

拖拽文件

支持操作:

• 拖拽单个文件
• 拖拽整个文件夹
• 拖拽多个文件

使用场景:

文本粘贴

注意:

• CC 中不能用 Ctrl+V 粘贴文本
• CC 中不能用 Ctrl+A 全选
• 图片必须在打开状态复制,预览状态无法粘贴

---

继续。提供并建立一些最佳实践以提升团队协作和开发效率。

目录结构规范

CLAUDE.md 层级配置

探索-规划-编码-提交工作流

这是一个完整的开发工作流程,需要配合特定的Skills和MCP使用。

前置准备 – 安装必要工具:

详细工作流程:

第1步:探索阶段 – 理解项目

第2步:规划阶段 – 使用Plan模式

第3步:编码阶段 – 实施计划

第4步:提交阶段 – 使用commit skill

测试驱动开发(TDD)工作流

前置准备 – 安装测试相关工具:

TDD工作流程:

代码审查工作流

前置准备 – 创建和配置代码审查子代理:

方式1:使用 /agents 命令创建

方式2:手动配置文件

使用代码审查工作流:

共享 CLAUDE.md

场景:团队项目

实施步骤:

1. 在项目根目录创建 CLAUDE.md
2. 团队共同维护
3. 定期更新
4. 版本控制

示例:

GitHub 集成

安装 GitHub App:

使用 PR 评论:

极致的并行处理(Parallelism)

来自 Claude Code 创始人 Boris Cherny 的核心理念:不要让 AI 等你,也不要让你等 AI

1. 终端里的”多线程”操作

就好比你雇了 5 个初级程序员同时干活,你只需要负责 Review 和分配任务,效率直接翻倍。

2. 本地与云端的”混合双打”

3. 跨设备同步工作流

效果对比:

上下文管理

策略:

Token 优化

模型选择策略

Claude Code 创始人的独家见解: 只用最强的模型:Opus 4.5 + Thinking

很多人为了省钱或追求速度会用 Haiku 或 Sonnet,但 Boris Cherny 只用 Opus 4.5,并全程开启 Thinking(思考)模式。

理由:

• 虽然 Opus 4.5 更贵、更慢,但它不需要你频繁纠正(Steer less)
• 工具使用能力更强,一次就能做对
• 从”任务完成总耗时”来看,聪明的大模型反而比”快但笨”的小模型更快
• 一次做对,永远比反复修改更省时间

土豪专属了属于是。

国外模型选择策略:

国外模型使用建议:

• 快速查询/格式化: Haiku 4.5 – 最快最便宜
• 日常开发/代码编写: Sonnet 4.5 – 性价比平衡
• 架构设计/复杂重构: Opus 4.5 + Thinking – 最高质量(创始人首选)

国内模型选择策略:

国内模型使用建议:

模型切换策略:

成本优化建议:

混合使用策略:

Sandbox 配置

Hooks 安全检查

敏感信息保护

来自 Claude Code 创始人的最重要的一条技巧：永远给 Claude 一种验证自己工作的方法

核心原理

如果 Claude 能看到自己代码的运行结果(报错信息、测试通过与否),它的代码质量会提升 2-3 倍。

实践方法

1. 简单的任务:运行 Bash 命令验证

2. 复杂的 UI:使用浏览器自动化

3. 端到端验证流程

效果对比

为什么验证循环如此重要?

人类开发流程:

1. 写代码
2. 手动测试
3. 发现 bug
4. 修复 bug
5. 重复测试

Claude + 验证循环流程:

1. Claude 写代码
2. Claude 自己测试
3. Claude 看到错误
4. Claude 立即修复
5. Claude 再次验证
6. 循环直到完美

关键差异:

• Claude 能立即看到错误信息
• Claude 不需要等待人工反馈
• Claude 可以在几秒内完成多个修复循环
• 最终代码质量远超人工编写

最佳实践建议

✅ 推荐做法:

❌ 避免做法:

---

简单几个案例看看如何运用到实际工作中。

需求:将文件夹中所有文件名改为规范的英文名称

实现:

需求:抓取公众号多页文章数据并导出 Excel

实现:

效果对比:

需求:审查 PR 的代码变更

实现:

需求:为新功能编写测试

实现:

需求:在 PR 创建时自动审查代码

实现:

---

在使用 Claude Code 的过程中,你可能会遇到一些常见问题。本章节收集了最常见的问题及其解决方案,帮助你快速排除故障。

Q1: npm install 失败

问题:

解决方案:

Q2: claude 命令未找到

问题:

解决方案:

Q3: 模型配置不生效

问题:配置后仍显示默认模型

解决方案:

Q4: MCP 服务器无法连接

问题:

解决方案:

Q5: 上下文超出限制

问题:

解决方案:

Q6: 代码生成质量差

问题:生成的代码不符合项目规范

解决方案:

Q7: 响应速度慢

问题:Claude Code 响应延迟高

解决方案:

Q8: Token 消耗过快

问题:费用增长过快

解决方案:

启用调试模式

使用 /doctor 诊断

检查项:

• ✅ 安装版本
• ✅ 配置文件
• ✅ API 连接
• ✅ MCP 服务器
• ✅ 权限设置
• ✅ 环境变量

---

Claude Code 的真正强大之处在于它的可扩展性。通过 LSP 集成和 Agent SDK，甚至可以构建自己的智能开发环境。

什么是 LSP?

LSP (Language Server Protocol) 是语言服务器协议，通过集成 LSP，Claude Code 现在的代码理解能力达到了 IDE 级别。

LSP 的强大能力

效果对比:

实战案例:

配置 LSP

Claude Code 会自动检测项目中的 LSP 服务器:

手动配置 LSP:

什么是 Agent SDK?

Claude Agent SDK 将 Claude Code 的核心能力(Agent Loop、工具管理、上下文管理)作为一个 SDK 开放了。可以用几十行代码构建一个像 Claude Code 一样强大的自定义智能体。

核心能力

实战案例

案例1:自动化测试生成器

案例2:代码审查机器人

案例3:自动化部署助手

Agent SDK 的核心优势

1. 完整的 Agent Loop

2. 强大的上下文管理

3. 灵活的工具系统

4. 可观测性

使用场景

---

核心命令速查

官方资源

• Claude Code 官网: https://code.claude.com
• 文档: https://code.claude.com/docs
• GitHub: https://github.com/anthropics/claude-code
• Skills 库: https://github.com/anthropics/skills
• MCP 服务器: https://github.com/modelcontextprotocol

---

Claude Code 真的很强，是一个强大的系统级 AI Agent，用好这个工具能为自己提高很多工作效率。

• ✅ Skills: 预封装的工作流,快速复用专业能力
• ✅ Hooks: 事件驱动的自动化,打造个性化工作流
• ✅ Plugins: 完整解决方案,一键安装多功能套件
• ✅ MCP Servers: 外部服务集成,无限扩展能力边界
• ✅ Subagents: 并行处理复杂任务,提升团队协作效率
• ✅ CLAUDE.md: 项目记忆系统,让 AI 理解你的项目,并支持自我进化
• ✅ Plan 模式: 先规划后执行,减少返工提高质量(90% 时间都在用)
• ✅ Slash Commands: 复杂工作流一键执行,团队共享最佳实践
• ✅ Extended Thinking: ultrathink 深度思考模式,解决复杂问题
• ✅ Sandbox 模式: 安全防护机制,保护你的工作环境
• ✅ Headless 模式: CI/CD 集成,实现自动化工作流
• ✅ LSP 集成: IDE 级代码理解,实时错误检测
• ✅ Agent SDK: 构建自定义智能体,几十行代码创造强大工具

来自 Claude Code 创始人和 Anthropic 团队的实战经验:

1. 并行处理是效率倍增的关键

• 同时运行 5 个终端实例 + 5-10 个网页会话
• 利用系统通知和多设备协作
• 效率提升可达 1900%+

2. AI 进化机制让工具越用越聪明

• 在 PR 评论中直接 @claude 反馈
• 自动将教训写入 CLAUDE.md
• 整个团队的 AI 助手持续进化

3. 验证闭环是质量保证的基石

• 永远给 Claude 验证自己工作的方法
• 代码质量提升 2-3 倍
• 返工率降低到 5%

4. 选择合适的工具

• 简单任务: Haiku 4.5 或国产模型
• 日常开发: Sonnet 4.5
• 复杂任务: Opus 4.5 + Thinking(创始人首选)
• 追求极致效率:聪明的大模型比”快但笨”的小模型更快

5. 先规划后执行

• 90% 的时间使用 Plan 模式
• 你是架构师,Claude 是执行者
• 一次做对,永远比反复修改更省时间

看完这些技巧会发现 Claude Code 的设计哲学非常有意思:

• 通过 Plan Mode,它尊重人的决策权
• 通过 Hooks 和 Sandbox,它给人提供了控制权
• 通过 Subagents 和 Automation,它帮人分担了繁琐的执行工作
• 通过 LSP 和 Agent SDK,它提供了无限的扩展可能

正如 Ado Kukic 所说:”用得最好的开发者,不是那些把所有事情都丢给 AI 的人,而是那些懂得何时使用计划模式、何时开启深度思考、如何设置安全边界的人。”

Claude Code 不仅仅是一个工具,它是一个可编程、可扩展、可进化的智能开发环境。你的创造力决定了它的上限。