夜雨聆风最近Claude Code火得很，但网上的教程要么太浅，要么太散。
这篇文章我把所有内容整理成一个体系，从是什么、怎么装、怎么用、怎么用好，全部覆盖。
认真读完，60分钟，够了。
一、Claude Code是什么
先说清楚定位，避免你用错方向。
Claude Code是Anthropic推出的命令行AI编程工具，直接跑在你的终端里。
它和你平时用的AI工具最大的区别是：
- ▸ChatGPT/Claude网页版 → 你贴代码给它看，它给你建议，你自己去改
- ▸GitHub Copilot → 在编辑器里帮你补全代码
- ▸Claude Code → 直接读你的项目文件，理解整个代码库，然后帮你改、帮你跑命令、帮你提交git
简单说：它是一个住在你终端里的程序员搭档，能看到你的整个项目，随叫随到。
适合谁用：
- ▸独立开发者，一个人干多个人的活
- ▸想提效但觉得Copilot不够聪明的程序员
- ▸需要快速读懂陌生代码库的人
- ▸非程序员想用AI帮自己搭工具的人
二、安装与配置
▸ 环境要求
- ▸Node.js 18及以上
- ▸系统：macOS、Linux、Windows（需要WSL）
- ▸一个Anthropic账号（Claude Pro/Max订阅，或者API key）
▸ 安装步骤
# 安装npm install -g @anthropic-ai/claude-code# 验证安装成功claude --version# 进入任意项目目录，启动cd 你的项目目录claude首次启动会让你登录，两种方式：
- ▸Claude订阅用户：直接OAuth登录，省事
- ▸API用户：输入你的API key
登录完成，就可以开始用了。整个过程不超过5分钟。
三、基础用法
进入项目目录后输入claude，就进入了交互模式，直接用中文说你要做什么就行。
▸ 读代码
帮我看看这个项目的整体结构，入口文件在哪解释一下 src/middleware/auth.ts 这个文件在做什么帮我找到所有调用了 database.query 的地方▸ 写代码
写一个用户注册的API接口，用Express，要有参数校验和错误处理给 src/utils.ts 里的 formatDate 函数写单元测试帮我写一个脚本，批量把 /images 目录下的图片压缩到1MB以内▸ 改代码
把 src/utils.ts 里的 getUserName 函数改名为 getUsername，所有引用都要改给所有API接口加上统一的错误处理中间件把 src/legacy/ 目录下的回调函数全部改成 async/await它会先展示要改哪些文件、改什么内容，你确认后才会真正写入。不会悄悄改你的代码。
▸ 跑命令
跑一下测试，看看有没有挂的帮我安装 axios 和 zod 这两个依赖构建一下项目，看看有没有报错▸ Git操作
把刚才的改动提交一下，commit message写清楚改了什么创建一个新分支叫 feature/user-auth帮我看看最近5次提交都改了什么四、进阶用法
▸ 非交互模式
不想进入对话，直接一次性执行：
# 单次提问claude -p "解释一下这个项目的目录结构"# 管道输入，分析报错日志cat error.log | claude -p "分析这个报错，告诉我怎么修"# 分析git diff，自动生成commit messagegit diff | claude -p "根据这个diff帮我写一个commit message"# 输出结果给其他命令用claude -p "列出所有需要重构的函数名" | grep "TODO"这个模式特别适合集成到脚本和CI流程里。
▸ CLAUDE.md：项目级别的规则文件
在项目根目录创建CLAUDE.md，写上你的项目规范：
## 技术栈- TypeScript，严格模式- 测试框架：Vitest- 样式：Tailwind CSS## 代码规范- 所有函数必须写 JSDoc 注释- commit message 用中文- 变量命名用驼峰，常量用全大写## 注意事项- 不要修改 src/legacy/ 目录下的文件- 数据库操作统一走 src/db/index.ts写好之后，每次启动Claude Code它都会自动读取，不用你每次重复交代背景。
这个文件是提效的关键，强烈建议每个项目都建一个。
▸ 多个CLAUDE.md
不只是根目录，子目录也可以放CLAUDE.md，用来给特定模块设置规则：
项目根目录/├── CLAUDE.md # 全局规则├── src/│ ├── api/│ │ └── CLAUDE.md # API模块专属规则│ └── components/│ └── CLAUDE.md # 组件模块专属规则▸ 权限控制
Claude Code默认每次操作都会问你确认，你可以根据信任程度调整：
# 允许自动编辑文件，不用每次确认claude --allowedTools "edit,write"# 只读模式，不允许修改任何文件claude --allowedTools "read"五、实战案例
▸ 案例1：快速搭建项目框架
帮我用 Next.js 14 + Prisma + PostgreSQL 搭建一个博客系统的基础框架。需要有：用户注册登录、文章CRUD、评论功能。先帮我规划目录结构，我确认后再开始写代码。它会先给你规划，你觉得没问题了再让它动手，一步步来。
▸ 案例2：分析和修复bug
用户反馈说登录后偶尔会被踢出来，我怀疑是token刷新逻辑有问题。帮我检查 src/auth/ 目录下的所有文件，找到可能的原因，给出修复方案。它会通读相关代码，定位问题，给出具体的修改建议，你确认后直接帮你改。
▸ 案例3：重构遗留代码
src/legacy/ 目录下的代码是3年前写的，全是回调地狱。帮我逐个文件改成 async/await，保持功能不变。每改完一个文件就跑一下对应的测试，确认没问题再继续。▸ 案例4：代码审查
我刚写完 src/payment/ 模块，上线前帮我做一次代码审查。重点看：安全漏洞、边界情况处理、错误处理是否完整。▸ 案例5：写文档
帮我给 src/api/ 目录下的所有接口生成 API 文档，格式用 Markdown，包含接口路径、请求方法、参数说明、返回值示例。六、使用技巧
1. 先让它读，再让它写
不要上来就说"帮我写个XX功能"，先说"看看现有代码里类似的功能是怎么实现的"。它写出来的东西会更贴合你的项目风格，不会和现有代码打架。
2. 给具体约束
"写一个函数"不如"写一个函数，入参是string数组，返回去重后的结果，用Set实现，加上JSDoc注释，用Vitest写两个测试用例"。越具体，结果越准。
3. 大任务拆步骤
让它一次性做完一个大功能，容易跑偏。拆成小步骤，每步确认后再继续，质量更稳。
4. 用管道喂数据
报错日志、测试结果、git diff，都可以直接管道给它分析，不用手动复制粘贴。
5. 让它写测试
写完功能后说"给这个模块写单元测试"，它会根据实现逻辑生成覆盖率很高的测试，比自己写省很多时间。
6. 出错了让它自己修
跑测试挂了，直接说"测试挂了，帮我看看哪里有问题"，把报错信息贴给它，让它自己定位修复。
七、费用说明
建议： 先用Pro试一个月，如果发现额度不够用再升级Max。API计费适合偶尔用或者集成到自动化流程的场景。
八、和其他工具怎么配合
很多人纠结"用了Claude Code还需要Copilot吗"，其实不冲突：
- ▸GitHub Copilot / Cursor：写代码时的实时补全，逐行建议，适合日常编码
- ▸Claude Code：处理复杂任务，理解整个项目，适合重构、调试、搭框架
两个一起用，日常写代码靠Copilot补全，遇到复杂问题切到Claude Code处理，效率最高。
九、常见问题
代码会上传到云端吗？
会发送到Anthropic的API处理。Anthropic声明不会用API数据训练模型。公司项目使用前建议评估一下安全合规要求。
能处理大型项目吗？
可以。它不会一次性把整个项目塞进上下文，而是智能选择读取相关文件。大型项目建议每次聚焦在一个模块上，效果更好。
支持哪些编程语言？
没有限制，Python、TypeScript、Go、Rust、Java都可以，本质上是理解文本，语言不是障碍。
能离线用吗？
不能，需要联网调用API。
Windows能用吗？
需要通过WSL（Windows Subsystem for Linux）使用，原生Windows终端暂不支持。
十、完整文档在哪里
官方文档地址：docs.anthropic.com/claude-code
文档里包含：
- ▸完整的CLI命令参考
- ▸所有配置项说明
- ▸SDK集成文档
- ▸安全与权限详细说明
建议收藏，遇到具体问题直接查。
总结
用一句话概括Claude Code的价值：把你从执行层解放出来，让你把时间花在思考和决策上。
它不是替代你，是让你一个人能干三个人的活。
关键是学会和它协作的方式：给清晰的指令、分步骤推进、让它先理解再动手。用好CLAUDE.md，把项目规范沉淀进去，长期收益很大。
