十分钟 Claude Code 入门

Claude Code 是一个 AI 编程代理。

它可以在终端里读你的项目、编辑文件、运行命令，也可以接入 VS Code、JetBrains、桌面端、Web 和 CI/CD。

但如果你刚开始用，不需要把这些入口都学一遍。

先从终端开始就够了。

这篇文章只做一件事，用 10 分钟跑通第一次真实使用。

一、安装

macOS、Linux、WSL 推荐用官方安装脚本：

curl -fsSL https://claude.ai/install.sh | bash

macOS 也可以用 Homebrew：

brew install --cask claude-code

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows 也可以用 WinGet：

winget install Anthropic.ClaudeCode

安装完之后，进入项目：

cd ~/projects/my-app
claude

第一次运行会提示你登录。按提示在浏览器里完成就行。

二、第一次不要急着改代码

先让它读项目。

先帮我读一下这个项目，不要改文件。告诉我项目是做什么的，入口文件在哪里，怎么启动，怎么测试。

这个问题很适合第一轮。

因为你可以马上判断它有没有读懂项目，也不会立刻产生改动。

接着你可以问：

这个项目里最适合新手先看的 5 个文件是哪几个？每个文件用一句话解释。

很多时候，Claude Code 最有价值的第一步不是写代码，而是帮你把陌生项目变得可读。

三、让它做一个小改动

等它读完项目后，再给一个小任务。

例如：

帮我把首页按钮的文案从「开始」改成「开始体验」。只改这个文案，不要顺手改样式。改完后告诉我改了哪个文件。

或者：

给 src/lib/date.ts 里的 formatDate 补两个测试，只覆盖正常日期和空值。不要改实现。

刚开始别让它做大范围重构。

Claude Code 能做复杂任务，但你需要先熟悉它怎么计划、怎么请求权限、怎么展示 diff、怎么跑验证。

四、学会看它的动作

Claude Code 修改文件前会让你确认。

你可以批准单次修改，也可以临时打开更宽松的权限模式。

但我建议刚开始保守一点。

尤其是在真实项目里，不要一上来就让它无限制改文件、跑命令。

常用的操作：

你想做的事	命令或动作
查看帮助	`/help`
清空当前上下文	`/clear`
继续最近会话	`claude -c`
恢复某个旧会话	`claude -r`
一次性问完并退出	`claude -p "解释这个函数"`
退出	`exit` 或 `Ctrl+D`
看所有命令和 skills	输入 `/`
切换权限模式	`Shift+Tab`

如果你只想让它回答问题，不想进入完整交互，可以用：

claude -p "解释 src/app/page.tsx 这个文件在做什么"

如果你想让它在项目里完成一个小任务：

claude "修复当前 lint 报错，改完后运行 lint 验证"

五、给项目写 CLAUDE.md

Claude Code 会读取项目里的 CLAUDE.md。

这个文件就像项目说明书，告诉它你希望它怎么工作。

刚开始可以写得很短：

# Project Instructions

- Package manager: pnpm
- Before committing, run `pnpm lint` and `pnpm build`
- Keep changes scoped to the user request
- Do not rewrite unrelated files
- Prefer small, readable changes over broad refactors

这类说明很有用。

因为你不需要每次都重复告诉它用什么包管理器、跑什么命令、不要乱改无关文件。

如果你不知道怎么开始，也可以在 Claude Code 里让它生成：

帮我根据当前项目生成一个简单的 CLAUDE.md，只写真实可验证的项目规则。

生成后你自己再读一遍，不要直接信。

六、一个适合第一次使用的任务流

你可以照着这个顺序跑：

先读项目，不要改文件。总结项目结构、启动命令、测试命令。

然后：

找一个最小的可改进点，先给建议，不要改。

再然后：

只实现第 1 个建议。改动限制在相关文件内。改完运行可用的验证命令，不要提交。

最后：

总结这次改动，列出改了哪些文件、跑了哪些验证、还有什么风险。

这个流程很慢吗？

其实不慢。

它比一上来让 AI 大改，然后你花半小时查它到底动了什么，要省心得多。

七、什么时候适合用 Claude Code

场景	适合程度
读陌生项目	很适合
修明确 bug	很适合
写测试	很适合
整理 README 或文档	很适合
小范围重构	适合
大范围技术迁移	谨慎
产品需求还没想清楚	先别急着写代码

Claude Code 很适合做那些「目标明确，但手工做有点烦」的任务。

比如修 lint、补测试、找入口、解释报错、整理文档、把一段旧代码改成更清晰的版本。

如果你连自己要什么都还没想清楚，它也会很努力，但结果不一定是你真正想要的。

八、我的小建议

第一次用 Claude Code，不要把它当成许愿机。

把它当成一个很勤快、很能读代码、但需要你给边界的同事。

你负责判断方向。

它负责加速执行。

这才是比较舒服的用法。