Claude Code 使用指南：从入门到精通
基于实战经验总结，适用于工作编程和日常事务。
一、核心概念
1. Claude Code 能做什么
- 读代码、写代码、改代码、重构
- 搜索项目、解释逻辑、排查 bug
- 执行终端命令（安装依赖、运行测试、git 操作）
- 读取 PDF、图片、Notebook
- 联网搜索、抓取网页
2. 工作模式
- 普通模式：边问边改，直接写代码
- Plan 模式：先规划后执行，适合大任务。用
/plan进入
二、工作中的最佳实践
1. 给出精确的上下文
❌ "改一下这个文件"
✅ "在 src/utils/auth.ts 的 login 函数里，把 token 存储方式从 localStorage 改成 cookie，加上 httpOnly 属性"精确上下文 = 文件路径 + 函数名/行号 + 具体改动描述 + 约束条件
2. 先让 Claude 阅读代码，再让它改
第1步：读取 src/api/user.ts，理解现有的用户接口
第2步：参照现有 pattern，新增 deleteUser 接口
第3步：在 tests/user.test.ts 中补上对应测试不要一上来就让改代码。先确认它理解了上下文。
3. 善用 Plan 模式处理大任务
/plan
我要重构整个认证模块，包括：
- 把 JWT 校验抽成中间件
- token 刷新逻辑改为 refreshToken 双 token 模式
- 所有接口加统一的鉴权 guardPlan 模式会让 Claude 先探索代码库、设计方案，得到你确认后再动手。
4. 把复杂任务拆成小步骤
❌ "帮我写一个电商系统"
✅ "先写商品列表接口 → 写购物车逻辑 → 写下单流程 → 接支付"每步确认无误后，再继续下一步。
5. 提供示例和约束
"仿照 src/components/UserCard.tsx 的写法，
写一个 ProductCard 组件，Props 包括 name/price/image，
用 Tailwind CSS，不要引入新的依赖。"6. 让 Claude 自己检查
"你检查一下刚才写的代码，有没有安全问题？"
"这段代码有没有潜在的性能问题？"
"这个函数还有更好的写法吗？"三、终端操作的注意事项
1. Git 操作最安全的方式
直接说你要干什么，Claude 会处理细节：
"帮我 commit 最近的改动，重点是修复了登录页面的 XSS 问题"2. 安装依赖
"用 pnpm 给我装 axios 和 dayjs"不要自己手写 npm install，让 Claude 执行更安全。
3. 运行测试
"跑一下 auth 模块的单元测试，失败了帮我修"四、常用对话技巧
精读代码
"帮我梳理 src/services/order.ts 的整体逻辑，列出每个函数的输入输出和调用链"理解项目结构
"这个项目用了哪些技术栈？目录结构怎么组织的？路由是怎么分的？"排查 Bug
"POST /api/login 接口返回 500，相关日志在 logs/app.log，
帮我排查原因，先别改代码，只分析。"搜索定位
"项目中哪里用到了 localStorage？全部列出来"
"哪些文件引用了旧的 UserModel 类型？"写文档
"给这个 API 模块写一份接口文档，列出所有 endpoint 的 URL、Method、参数和返回值"解释历史改动
"最近 5 个 commit 改了什么？用中文总结。"五、生活中的用法
1. 文件整理
"扫描 /Users/xxx/Downloads，帮我按文件类型分类整理，生成一个目录结构建议"2. 数据处理
"这个 CSV 里有 1000 条销售记录，帮我统计：每月总销售额、Top 10 商品、退货率"3. 写脚本自动化
"写一个 Python 脚本：监听 Desktop/screenshots 目录，新增图片自动压缩并移到 archive 文件夹"4. 学习新技术
"我想学 Rust，帮我梳理学习路线，列出学习资源"5. 翻译技术文档
"把这篇英文 README 翻译成中文，技术术语保留英文"6. 分析日志
"这 200MB 的 nginx access.log，帮我统计：
- 请求量 Top 10 的 IP
- 响应时间超过 3 秒的请求占比
- 404 最多的 URL 路径"六、进阶技巧
1. 用 Hook 做自动化
在项目根目录创建 .claude/settings.json，可配置：
- 代码提交前自动跑 lint
- 保存文件时自动格式化
- 自定义 slash 命令
2. 记住你的偏好
把常用偏好告诉 Claude，它会记住：
"我的项目默认用 TypeScript strict mode"
"测试框架默认用 vitest"
"代码风格：不使用 class，只用函数式"3. 跨平台工作
如果用了 WSL + Windows 双环境，Claude Code 可以同时操作两边文件，但要明确指定路径。
七、避坑指南
| 坑 | 解法 |
|---|---|
| 一次性要求太多 | 拆成小步骤，逐步验证 |
| 不提供文件路径 | 始终给出精确路径 |
| Claude 改错了 | 说"撤销刚才的改动"或 git checkout |
| 大文件直接读 | 告诉它"只读第 100-200 行" |
| 信任过度 | 重要的改动手动 review 一遍 |
| 没指定模式 | 大任务先用 Plan 模式，得到你的同意再执行 |
| 不会查看 diff | 说"先 show diff，别直接改文件" |
八、一句话总结
Claude Code 是一个能干活的协作者，不是一个问答机器人。 把它当成一个坐在你旁边的资深同事——你告诉他上下文、目标和约束，他帮你执行。 任务说清楚、结果要检查、信任要谨慎。
最后更新：2026年4月