Claude Code 快速入门

把整个代码仓库交给 Claude,让它像资深工程师一样帮你读、改、解释代码。

这是什么?适合谁?

Claude Code 是 Anthropic 推出的编程辅助模式,跑在终端里,直接和你本地或远端的代码仓库对话。它不是普通的代码补全插件,而是面向”项目级”工作的 AI 工程师:你给它一个仓库,告诉它要做什么,它会自己读文件、查依赖、改代码、跑命令,然后给你一份清晰的修改说明。

它适合几类人:第一类是接手陌生代码库的开发者,需要在短时间内搞清楚一个项目的结构;第二类是想给开源项目提 PR 的贡献者,希望快速理解别人代码;第三类是在做代码审查、找 bug、重构老代码的工程师;第四类是想体验前沿 AI 编程能力、愿意在命令行里折腾的人。完全不会写代码的小白不建议直接上手,先掌握基础命令和 Git 更稳妥。

准备工作

• 账号:准备一个能访问 Claude 的账号(订阅 Pro、Team 或 API 均可),未登录状态下功能受限。
• Node.js:本机安装 18 以上的 Node.js,Windows、macOS、Linux 都行。
• Git:本地至少装好 Git,后面所有操作都依赖 Git 工作流。
• 终端:macOS 终端、iTerm2、Windows Terminal 都可以,不推荐用 CMD。
• 项目:准备一个你想让 Claude 帮忙的代码仓库,先 git init 或 git clone 下来。

3 步快速上手

第 1 步:安装 Claude Code

在终端里执行安装命令,推荐用官方提供的安装器:

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

安装完成后,运行 claude --version 看到版本号就算成功。如果是 macOS 用户,也可以用 Homebrew:

brew install claude-code

第 2 步:登录并初始化

第一次启动需要登录:

claude login

按提示在浏览器里完成授权。登录成功后,进入你想分析的项目目录:

cd my-project
claude

进入交互式界面后,先用 /init 命令让 Claude 扫描项目并生成 CLAUDE.md 上下文文件,这个文件会帮助它后续理解你的代码规范。

第 3 步:跑第一个任务

直接在命令行里用自然语言提问,比如:

请阅读 src/ 目录,告诉我这个项目主要做什么,使用了哪些核心依赖。

Claude 会自动读文件,给你一段总结。你也可以让它直接改代码:

请在 utils.py 里加一个 format_date 函数,把时间戳格式化为 YYYY-MM-DD。

完成后用 /diff 查看本次修改,确认无误后输入 /commit 让它帮你写提交信息并 git commit。

常见踩坑

1. 没装 Node.js 直接跑命令:看到 command not found 通常是没装 Node,先去 https://nodejs.org 下载 LTS 版本。
2. 在错误的目录启动:Claude Code 默认只看当前目录的代码,跑到上一层去不会自动扫描子项目。
3. 没建 Git 仓库就上手:很多命令(/diff、/commit)依赖 Git,没有仓库时会报错。
4. 一次问太多事:Claude 上下文有上限,把项目拆成几个小任务分步问,效果比一次性扔一堆问题好。
5. 忽略权限确认:执行写文件、跑命令前它会询问,直接按回车可能错过关键信息,养成看清再确认的习惯。
6. 网络受限地区访问慢:Anthropic 官方 API 在部分地区需要国际网络连接,企业用户可以联系销售开通专线。

初级用法

• 项目速读:进项目后输入 “请用 200 字介绍这个项目”,快速拿到概览。
• 解释一段代码:选中代码块按 Ctrl+K(macOS 是 Cmd+K)让它逐行解释。
• 生成单元测试:对某个函数输入 “为它写 pytest 单元测试,覆盖正常和异常情况”。

高级玩法

• 自定义 CLAUDE.md:在项目根目录写一份 CLAUDE.md,描述编码规范、禁止操作、常用命令,Claude 会一直遵守。
• 管道式调用:用 claude -p "任务描述" --output-format json 在脚本里调用 Claude Code 做批处理。
• 多仓库协作:用 claude --add-dir ../other-project 临时加入另一个目录,做跨项目重构。

小技巧

• 用 /clear 随时清空对话历史,避免上下文太长导致响应变慢。
• 用 /resume 找回上次未完成的会话。
• 改完代码后输入 /review 让 Claude 自己 review 一次,双保险。
• 长任务拆成几个短指令,效果往往比一段大而全的 prompt 更好。
• 开启 --verbose 标志可以看到它每一步读了哪些文件,方便排查。
• 用 /cost 实时查看 token 消耗,防止一次任务烧掉太多额度。
• 在 CLAUDE.md 里写”不要修改 migration 文件”,可以避免 AI 误改数据库迁移。
• 用 claude -c 在已有会话上继续,不用每次都重新讲背景。
• 跑测试用 npm test 这类命令前,先在 CLAUDE.md 写明”测试不需要网络”,AI 不会傻乎乎去装数据库。
• 大文件读取用 claude --file big.log 比直接贴文本快。
• 多窗口并行:开两个终端,一个让 Claude 改 A 模块,另一个改 B 模块,效率翻倍。
• 调试时让 Claude 输出”假设和推理过程”,而不只是结论,有助于你判断它是否真的懂了。

与其他工具的对比

很多人会把 Claude Code 和 Cursor、GitHub Copilot、Windsurf 放在一起比较,其实它们的定位不一样。Cursor 是”AI 编辑器”,你离不开它写代码;Copilot 是”补全插件”,适合日常边写边补;Claude Code 是”AI 工程师”,适合大改、重构、读陌生代码、生成 PR。如果你只是想打字时快一点,Cursor 更顺;如果你想”整个项目交给 AI 打理”,Claude Code 更合适。两者也可以搭配:在 Cursor 里写代码,遇到大改任务时打开 Claude Code 协调。

适合的开源项目

Claude Code 在开源世界非常受欢迎,很多明星项目都用它做维护:

• Next.js 仓库:Vercel 团队用 Claude Code 帮忙处理 issue,提升维护效率。
• Anthropic 内部:Claude Code 本身就是用 Claude Code 维护的,MetaAI 称之为”自举”。
• Hugging Face transformers:社区贡献者用 Claude Code 帮忙加新模型支持。
• LangChain:文档团队用 Claude Code 维护示例代码。

如果你做开源,Claude Code 可以成为”不知疲倦的维护者”,在 issue 涌入时帮你做 triage、写回复、生成补丁。

学习路径建议

零基础到熟练使用 Claude Code,可以按以下顺序走:

1. 第 1 周:只让它解释代码,熟悉 claude 命令和 /init、/clear、/resume。
2. 第 2 周:开始用它改小文件,比如加个工具函数、改个注释。
3. 第 3 周:尝试生成完整的 PR 流程,让它读 issue、生成代码、跑测试、写 commit。
4. 第 4 周:自定义 CLAUDE.md,把团队规范写进去,体验”自动化团队守门员”的感觉。
5. 第 2 个月:用 --mcp 接入公司内部工具,把 Claude Code 变成”超级外挂”。

坚持一个月,你会发现 Claude Code 不只是一个工具,更像是”和你一起 coding 的伙伴”。

参考链接

• Claude Code 官方文档:https://docs.claude.com/en/docs/claude-code/overview
• Anthropic 官方博客:https://www.anthropic.com/news
• Claude 主站:https://claude.ai
• Node.js 官网:https://nodejs.org
• Git 官方教程:https://git-scm.com/doc

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。