十分钟 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，不要把它当成许愿机。

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

你负责判断方向。

它负责加速执行。

这才是比较舒服的用法。