夜雨聆风终端里的 AI 编程助手，5 分钟上手，1 小时成为日常工具。
先说结论
Claude Code 是 Anthropic 推出的智能编程工具。它运行在终端中，理解你的代码库，通过自然语言命令帮助你编码。
核心能力：
- 理解整个项目的代码结构
- 执行 Bash 命令、编辑文件、Git 操作
- 网络搜索、网页抓取
- 支持 VS Code、JetBrains IDE、Chrome 扩展
适合谁用：
- 日常写代码的开发者
- 需要重构遗留代码的人
- 想快速理解陌生代码库的人
不适合谁：
- 期望完全自动化、不看代码就发布的人
- 不愿意审查 AI 输出的人
一、安装
系统要求
• macOS、Linux 或 Windows 11
• Claude Pro 订阅（$20/月）或更高
• 终端应用
安装方式
macOS / Linux：
curl -fsSL https://claude.ai/install.sh | bash
Homebrew（macOS）：
brew install --cask claude-code
Windows：
irm https://claude.ai/install.ps1 | iex
WinGet（Windows）：
winget install Anthropic.ClaudeCode
注意：npm 安装方式已弃用，请使用上述官方推荐方式。
验证安装
claude --version
二、第一次使用
启动会话
cd ~/projects/my-app
claude
第一次启动会索引项目文件，可能需要几秒钟。
第一个任务
输入自然语言：
> 这个项目是做什么的？总结一下技术栈和目录结构。
Claude 会分析项目，给出回答。
第二个任务
> 在注册表单添加输入验证。邮箱需要验证格式，密码至少 8 个字符。
Claude 会：
1. 找到相关文件
2. 展示修改内容
3. 等你批准
4. 执行修改
三、常用命令
| 命令 | 作用 |
|---|---|
claude |
启动会话 |
/help |
显示所有命令 |
/plan |
先规划再执行 |
/clear |
清除上下文，重新开始 |
/cost |
查看 token 用量和费用 |
/compact |
压缩对话历史 |
/model |
切换模型 |
最重要的三个命令：
- /plan — 复杂任务先规划
- /clear — 上下文太多时清理
- /help — 忘了命令就看它
四、核心概念
权限系统
Claude Code 不会自动执行任何操作。每次文件修改、命令运行，都需要你批准。
批准前仔细看变更，尤其是不熟悉的代码。
安全建议：
- 在受信任的目录中使用
- 仅在沙箱环境中使用 --dangerously-skip-permissions
上下文管理
Claude Code 有 200K token 的上下文窗口。用多了会"遗忘"之前的内容。
| 上下文使用 | 建议 |
|---|---|
| 0-50% | 自由工作 |
| 50-70% | 准备压缩 |
| 70-90% | 立即运行 /compact |
| 90%+ | 必须运行 /clear |
模型选择
| 模型 | 速度 | 适用场景 |
|---|---|---|
| haiku | 最快 | 简单任务、快速响应 |
| sonnet | 平衡 | 大部分日常任务 |
| opus | 最强 | 复杂架构、多文件重构 |
切换模型：
/model opus
/model sonnet
/model haiku
经验法则：80% 用 sonnet，最难的 20% 切 opus。
五、Plan Mode：复杂任务的保险
什么时候用
• 涉及多个文件的重构
• 不熟悉的代码库
• 需要了解影响范围的操作
怎么用
> /plan
> 重构认证模块，从 session cookie 改成 JWT。
Claude 会：
1. 分析代码库
2. 制定方案
3. 展示推理过程
4. 等你批准
批准后才执行，避免"改错了再改回来"。
六、CLAUDE.md：项目配置文件
为什么需要
让 Claude 从第一条提示就遵循你的编码规范。
放在哪里
项目根目录，文件名 CLAUDE.md。
写什么
## 技术栈
- Next.js 14 + App Router
- TypeScript（严格模式）
- Tailwind CSS
- PostgreSQL + Prisma
## 编码规范
- 使用函数组件和 hooks
- 所有函数必须有 TypeScript 返回类型
- 使用命名导出，不用默认导出
- 新工具函数必须写测试
## 测试
- 运行测试：npm run test
- 单元测试用 Vitest
## Git
- 提交格式：feat()、fix()、refactor()
- 功能开发在新分支
好处
Claude 会严格遵守这些规范，不需要每次提醒。
七、实用工作流
理解陌生代码库
> 这个项目是做什么的？核心模块有哪些？
调试性能问题
> 用户反馈仪表盘加载需要 15 秒。检查仪表盘页面的 API 调用，
> 找出性能瓶颈。
添加新功能
> 添加深色模式切换。用户偏好存在 localStorage，
> 页面加载时应用，不要有闪烁。
重构遗留代码
> /plan
> 这个文件用回调模式。重构成 async/await，保持外部 API 不变。
Git 工作流
> 创建新分支 feat/dark-mode，提交刚才的修改，
> 打开 PR 并描述改动内容。
八、新手常见错误
1. 过早信任
Claude 生成的代码可能有逻辑错误。每个输出都要验证，尤其是边缘情况。
2. 忽略上下文压力
上下文超过 70%，Claude 开始"遗忘"。及时 /compact 或 /clear。
3. 提问太模糊
不要说"把代码改好一点"。要说：
"重构 processPayment 函数，处理 Stripe 支付失败的情况，指数退避重试最多 3 次。"
4. 不用 Plan Mode
复杂任务直接执行，改错了再改回来，浪费时间。先用 /plan。
5. 随意批准 MCP
MCP 可以扩展 Claude Code 的能力，但也带来风险。批准前检查来源，不要安装未知来源的 MCP。
九、安全须知
数据收集
Claude Code 会收集：
- 使用数据（代码接受/拒绝）
- 相关对话数据
- 通过 /bug 命令提交的用户反馈
隐私保护：
- 敏感信息有限的保留期限
- 对用户会话数据的受限访问
- 不使用反馈进行模型训练
MCP 服务器风险
MCP（Model Context Protocol）可以扩展 Claude Code 的能力，但也带来风险。
检查清单：
- 来源验证：>50 stars，最近 30 天有提交
- 权限检查：无 --dangerous-* 标志
- 版本锁定：不用 "latest" 或 "main"
- 哈希验证
开始简单
不要一开始就配置一堆东西。建议顺序：
1. 第一阶段：基础配置 + CLAUDE.md
2. 第二阶段：如需要，添加命令和 hooks
3. 第三阶段：如需要多上下文，添加 agents
4. 第四阶段：如真正需要，添加 MCP 服务器
十、IDE 和 GitHub 集成
VS Code 集成
在 VS Code 中可以直接调用 Claude Code，无需切换到终端。
JetBrains IDE 集成
支持 IntelliJ、PyCharm、WebStorm 等 JetBrains 系列 IDE。
GitHub 集成
在 GitHub PR 或 Issue 中用 @claude 标签，让 Claude 帮你审查代码或回答问题。
Chrome 扩展
浏览器中也能使用 Claude Code 的能力。
十一、学习路径
第一天
1. 安装 Claude Code
2. 在小项目上试用
3. 创建第一个 CLAUDE.md
4. 学习 /plan 和 /clear
第一周
1. 在日常项目使用
2. 尝试不同类型的任务
3. 注意上下文管理
4. 习惯批准前审查变更
第一月
1. 配置 hooks 自动化常见任务
2. 创建自定义命令
3. 尝试 Agent Teams（如果你用 Opus）
参考
• Claude Code 官方文档 — https://code.claude.com/docs
• Claude Code GitHub — https://github.com/anthropics/claude-code
• Claude Code Ultimate Guide — https://github.com/FlorianBruniaux/claude-code-ultimate-guide
