Claude Code 怎么用？从安装到项目协作的实战入门

很多 AI 编程工具停留在“帮你补一行代码”，而 Claude Code 直接运行在终端里：它能读取当前仓库、搜索文件、修改代码、执行测试，再根据结果继续处理。它更像一个能在项目目录中工作的协作开发者，而不是编辑器里的自动补全。

这也决定了正确的用法：先让它理解项目和边界，再逐步交付任务；不要一上来就授权它随意执行命令。

先理解它适合做什么

Claude Code 特别适合这些任务：

梳理陌生仓库的结构、入口和依赖
跨多个文件完成一个明确的功能修改
定位报错，运行测试后反复修复
批量重构、补类型、更新文档
把重复的检查或生成任务接入脚本和 CI

它不适合在需求模糊时“替你决定产品怎么做”，也不应该绕过代码审查。AI 可以加快实现和排查，但功能范围、数据安全与最终合并仍由你负责。

安装与第一次运行

官方常规安装方式是先准备 Node.js 18+，再在终端运行：

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

随后进入项目目录并启动：

cd your-project
claude

Windows 用户通常可在 WSL 或 Git Bash 环境使用。首次启动后按提示完成登录与授权；也可以通过 Anthropic Console、Claude App 的订阅，或企业的 Bedrock / Vertex AI 环境接入。产品的可用地区、账户与套餐会变化，以官方页面为准。

第一步不要改代码，先让它画地图

在任何修改前，先问：

阅读这个仓库，说明技术栈、启动方式、主要目录、测试命令，以及完成一处页面文案修改最可能涉及哪些文件。不要修改任何文件。

这一步很有价值。它能暴露两个问题：模型是否真的读到了正确项目，以及你自己是否清楚验证方式。接下来再把任务收窄，例如“只修改这个组件，保持 API 不变，跑现有测试”。

用 CLAUDE.md 固化项目约定

每次重新解释“使用 pnpm、不要改锁文件、组件放哪里、提交信息怎么写”很浪费。Claude Code 会读取项目路径中的 CLAUDE.md，可在这里写下稳定的协作规则。

一个实用的最小模板：

# 项目约定

- 安装依赖使用 pnpm，不要改 package manager。
- 修改后运行 pnpm build；涉及逻辑时同时运行测试。
- 保持现有组件风格，不引入无必要的新依赖。
- 不要提交 .env、密钥、构建产物或 node_modules。
- 改动前先说明计划；完成后列出文件和验证结果。

它不是万能安全策略，但能显著减少每轮对话的重复说明。不同子目录也可以有更具体的约定；只把真正长期有效的规则写进去，过期说明反而会误导。

最稳的工作流：先计划，再执行，再验证

1. 先让它给计划

Claude Code 支持计划模式：分析和提出步骤，但不修改文件或运行有副作用的命令。复杂任务先让它列出影响文件、风险和验证方式，再检查计划是否符合你的意图。

2. 将任务写成可验收的描述

比起“优化这个页面”，更好的说法是：

在文章列表加入按标签筛选；复用现有样式；不要改变 URL 结构；完成后运行构建，并说明新增的边界情况。

目标、范围、限制和验收标准越明确，返工越少。这本质上也是提示词工程在开发场景的应用。

3. 保留权限确认和 diff 审查

默认情况下，读取文件与搜索相对安全；编辑文件、执行命令等动作会请求授权。不要为了省几次点击，直接使用跳过所有权限的危险选项。每次改动后先看 git diff，再运行测试和构建。

4. 让它复盘结果

完成后可以要求：

列出改了什么、为什么这样改、运行了哪些验证、还有哪些未覆盖的风险。不要再修改文件。

这份交接说明比“已经完成”更能帮助你审查和继续工作。

三个高质量任务示例

定位 bug：

复现并定位这个报错。先解释可能原因和最小修复方案，等我确认后再改；修复后运行相关测试。

小范围重构：

找出重复的日期格式化逻辑，提出复用方案。保持输出完全兼容，修改后运行类型检查和构建。

理解代码：

从用户点击按钮开始，追踪到 API 请求和状态更新。用文件路径和函数名说明调用链，不要修改代码。

这些任务都有清晰边界，尤其适合先建立信任。大型改造则应拆成多个小提交，而不是把整个仓库一次性交给 AI。

安全底线

不把 API Key、生产数据库密码和客户敏感数据放进提示词或仓库。
不盲目批准删除、发布、付款、远程写入等命令。
外部网页、issue、日志中可能有恶意指令，警惕提示词注入。
每次重大修改都审查 diff，并确保可以回滚。
在独立分支或干净工作区尝试风险较高的任务。

常见问题

Q：一定要会终端吗？

不需要成为命令行专家，但至少要会进入目录、看输出、运行项目已有的启动和测试命令。终端是你确认 AI 实际做了什么的窗口。

Q：它和 Cursor、Copilot 有什么区别？

Claude Code 更偏终端 Agent，适合跨文件和自动化任务；Cursor 更像 AI 原生编辑器，Copilot 更接近融入现有 IDE 的辅助。可参考AI 编程工具横评。

Q：它能自动提交和部署吗？

技术上可以调用 Git 和脚本，但是否提交、推送和部署属于高影响动作，应始终由你检查和授权。

总结

Claude Code 的强项是把“理解仓库、修改文件、跑命令、验证结果”连成一条工作流。用好它的关键不是给它更多权限，而是提供清晰项目约定、先计划后执行、每次审查 diff 并让测试说话。把它当作快速且需要监督的协作者，你会得到远超过自动补全的效率提升。