AI Tool Guide
Claude Code 教程：从第一次使用到真实改仓库
面向工程师的 Claude Code 入门：适合什么任务，怎么写需求，如何让它改文件、跑测试和复盘。
先说结论
Claude Code 的价值在于让模型进入你的工程现场。它不适合只问概念，适合修 bug、读仓库、补测试、做小型重构。
免费/付费价格
通常依赖 Claude 账号或 API 能力。真实成本取决于模型、上下文和任务长度。
中文可用性
需求可以中文写，但文件名、错误日志、测试命令建议原样贴出。
网络和合规
需要稳定访问模型服务。公司环境要确认代码和日志是否允许上传。
工具是什么
Claude Code 是命令行里的编程代理。它可以读取本地项目，按任务修改文件，并配合测试命令验证结果。
适合谁
- 熟悉命令行的开发者
- 维护中大型仓库的人
- 经常需要读陌生项目的人
- 想把 AI 放进开发流程的人
实测优点
- 适合多文件修改
- 能围绕测试闭环工作
- 比复制粘贴代码片段更接近真实开发
需要留意
- 需求太散会跑偏
- 大改动仍需人工审查
- 对终端和 Git 习惯有要求
替代品表格
| 替代品 | 最适合 | 为什么可选 | 注意点 |
|---|---|---|---|
| Codex CLI | 本地仓库协作 | 适合代码修改、审查、测试和自动化开发任务。 | 需要给清楚边界。 |
| Cursor | 编辑器内开发 | 适合边看边改，尤其是前端和应用代码。 | 长任务可控性不如命令行流程。 |
| Gemini CLI | 大上下文阅读 | 适合读大量文件、做分析和生成计划。 | 具体编码效果要按项目实测。 |
| Aider | Git 风格代码修改 | 围绕补丁和提交工作，适合老派工程流程。 | 配置和模型选择需要经验。 |
真实使用场景
让它先读 README 和目录结构
定位一个报错对应的文件
补一个回归测试
把重复逻辑抽成函数
常见问题
Claude Code 适合新手吗？
可以用，但最好先学会 Git、测试命令和基本终端操作，否则很难判断它改得对不对。
一次任务要写多长？
短一点更好。一个任务只解决一个问题，先让它分析，再允许它修改。
怎么减少它乱改？
明确禁止范围，比如不要改配置、不要动数据库迁移、只改某几个文件。