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