Claude Code实战指南①｜什么是Claude Code，为什么它比Copilot更适合做项目？

新系列来了：Claude Code实战指南。Bolt.new系列已完结，从今天开始我们用7篇文章，把Anthropic官方出品的AI编程工具Claude Code彻底讲透。

一、Claude Code是什么？

Claude Code是Anthropic推出的命令行AI编程助手。简单来说，它把Claude大模型装进了你的终端，你可以用自然语言让它：

• 阅读和理解整个代码库
• 修改多个文件
• 运行测试和命令
• 查找和修复Bug
• 生成新功能和文档

它的定位不是"代码补全"，而是"代码库级智能体"。Copilot帮你写一行代码，Claude Code帮你完成一个需求。

二、Claude Code vs 其他工具：该怎么选？

工具	形态	核心能力	适合场景
Claude Code	终端	全代码库理解、多文件编辑、任务执行	复杂项目、重构、Bug修复、功能开发
GitHub Copilot	IDE插件	代码补全、聊天问答	日常编码、快速补全、简单问答
Cursor	AI原生IDE	Composer多文件、Agent模式	新项目开发、心流编码
Bolt.new	浏览器IDE	快速原型、全栈生成	原型验证、小项目、Demo

一句话总结：做大型项目改造用Claude Code，日常开发用Copilot，新想法快速实现用Cursor或Bolt.new。

三、安装与基础配置

1. 安装要求

• macOS、Linux或Windows（WSL2）
• Node.js 18+
• Git
• Anthropic API Key

2. 安装命令

npm install -g @anthropic-ai/claude-code

3. 初始化

cd your-project-directory
claude

首次运行会要求输入Anthropic API Key，然后Claude Code会扫描整个项目，建立代码库索引。

4. 配置建议

# 设置模型（推荐Claude 3.5 Sonnet或Claude 4 Sonnet）
claude config set model claude-sonnet-4

# 开启自动运行测试
claude config set auto-run-tests true

# 设置最大并发编辑文件数
claude config set max-files 10

四、第一个实战：让Claude Code自我介绍

进入项目后，输入第一个提示词：

请分析这个项目的整体结构，告诉我：
1. 这是什么类型的项目？
2. 主要技术栈是什么？
3. 入口文件在哪里？
4. 有没有明显的代码异味或需要改进的地方？

Claude Code会：

1. 读取项目根目录的文件（README、package.json、pyproject.toml等）
2. 分析目录结构
3. 给出结构化的总结

这是一个很好的"热身"动作，让你了解它如何理解项目。

五、Claude Code的工作模式

模式1：问答模式

你问它答，类似ChatGPT。适合理解代码、查文档、解释报错。

这个函数为什么要用递归而不是循环？

模式2：编辑模式

你让它修改代码，它会直接编辑文件。适合重构、改Bug、加功能。

把用户登录逻辑从回调函数改成async/await，
并确保所有调用处同步更新。

模式3：执行模式

你让它运行命令，它会在终端中执行。适合测试、构建、部署。

运行所有单元测试，并告诉我哪个测试失败了。

模式4：混合模式

最常用：先理解代码，再修改代码，最后运行测试验证。

我需要给这个项目添加用户密码重置功能。
请先查看现有的用户认证模块，然后设计实现方案，
修改相关文件，并运行测试确保没有破坏现有功能。

六、基础提示词技巧

技巧1：给上下文

❌ "帮我优化这段代码"

✅ "这个函数处理电商订单的库存扣减，在高并发下可能有问题。请帮我优化性能和正确性。"

技巧2：指定范围

❌ "重构项目"

✅ "只重构 src/services/auth/ 目录下的代码，保持API不变"

技巧3：要求验证

❌ "实现这个功能"

✅ "实现功能后，运行 npm test 并确保所有测试通过。如果失败，先修复再汇报。"

技巧4：分步推进

对于复杂任务，先让它给方案，确认后再执行：

我想把项目从JavaScript迁移到TypeScript。
请先给出迁移计划和需要修改的文件清单，
我确认后再开始执行。

七、安全与注意事项

• API Key成本：Claude Code按Token计费，大型项目操作可能消耗较多额度。重要修改前先让它给出预计影响范围
• 代码审查：AI生成或修改的代码必须人工审查后再提交，尤其是涉及权限、支付、数据库等关键逻辑
• 备份：在让Claude Code执行大规模修改前，确保代码已提交到Git
• 权限边界：Claude Code可以执行命令，默认不要给它超出项目目录的权限

---

下一篇，我们将进入实战：如何用Claude Code读懂一个陌生代码库，并在30分钟内完成第一次有效修改。