Claude Code 教程：从零安装到完成第一个任务

这篇 Claude Code 教程带你从零走到第一次成功运行的会话：一条安装命令、用 Claude 账号登录、在你自己的项目里完成第一个任务，以及让智能体记住项目规则的 CLAUDE.md 文件。你需要一个终端、任意一个代码项目，以及付费的 Claude 套餐（Pro、Max、Team 或 Enterprise），或者一个有 API 额度的 Claude Console 账号。整个过程大约一刻钟。

我是以用户的身份来写的：这个网站从代码到发布文章，都是用 Claude Code 来维护的。下面所有命令都来自官方文档。

Claude Code 是什么

Claude Code 是 Anthropic 推出的编程智能体，运行在终端里。和聊天不同，它不只是回答问题：它会读取仓库里的文件、修改文件、运行命令、编写测试，还会提交 commit。你描述想要达成的目标，Claude 会自己找到相关文件并提出修改方案。

同一个引擎也能在终端之外运行：VS Code 和 JetBrains、桌面应用、浏览器里的 claude.ai/code，以及移动应用。这篇教程里我只讲终端，因为在那里能看到的东西最多。

Claude Code 教程：一条命令完成安装

推荐的方式是原生安装程序，它会在后台自动更新。

macOS、Linux 和 WSL：

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

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

安装程序不会显示进度。完成后，打开一个新的终端窗口检查一下：

claude --version

如果看到版本号后面跟着 (Claude Code)，就说明一切正常。如果提示无法识别 claude，通常是安装目录没有加入 PATH；文档里有一个专门的章节讲这个问题。

其他方式：macOS 上用 brew install --cask claude-code，Windows 上用 winget install Anthropic.ClaudeCode。这两种方式不会自动更新。在没有 WSL 的 Windows 上，建议安装 Git for Windows，这样 Claude 就能使用 Bash。

登录和第一次会话

进入项目目录，启动智能体：

cd /path/to/project
claude

第一次启动时，Claude Code 会要求你在浏览器里登录。你可以用 Claude 账号（Pro、Max、Team 或 Enterprise 套餐）登录，也可以用 Claude Console 账号，也就是预付额度的 API 访问。登录信息会被保存，所以只需要登录一次。如果你设置了环境变量 ANTHROPIC_API_KEY，Claude 会询问是否使用它，并跳过登录。

登录后，你会看到一个提示符，上面显示版本号、模型名称和工作目录。输入 /help 查看可用命令。

第一个任务

在让智能体改动任何东西之前，先从提问开始。Claude 会自己读取文件，你不需要把文件内容粘贴进来：

这个项目是做什么的？
主入口在哪里？
解释一下目录结构

然后做一个小改动：

在主文件里添加一个 hello world 函数

Claude 会找到合适的文件并展示 diff。如果它请求许可，批准即可。智能体在哪些操作上需要征求同意，由权限模式决定，用 Shift+Tab 切换。在较新的版本中，默认是 auto 模式：由一个单独的分类器模型检查操作，只拦截有风险的那些。

Git 也可以用自然语言来操作：

我改了哪些文件？
用描述清楚的提交信息做一次 commit
创建一个名为 feature/quickstart 的分支

CLAUDE.md：项目的记忆

每次会话都从空白的上下文开始。为了不用每次都解释项目怎么构建、你们遵循哪些约定，把这些写进仓库根目录下的 CLAUDE.md 文件里。Claude 在每次对话开始时都会读取它。

最快的起步方式是 /init 命令：Claude 会分析仓库，生成一个文件，里面包含它自己发现的构建命令、测试和约定。之后你再补充那些从代码里看不出来的内容。

根据文档，值得写进去的有：

• Claude 猜不到的命令（构建、测试、lint），
• 与默认习惯不同的代码风格规则，
• 仓库礼仪（分支命名、PR 约定），
• 架构决策和项目特有的坑。

不该写的：Claude 自己能从代码里读出来的东西，以及“写干净的代码”这类空话。文档建议把文件控制在 200 行以内。文件越长，越占上下文，也越不容易被遵守。

几个能帮你省去搜索的事实：

• ~/.claude/CLAUDE.md 是你适用于所有项目的个人规则，./CLAUDE.md 是与团队共享的项目规则，./CLAUDE.local.md 是针对某个仓库的私人笔记（记得把它加进 .gitignore）。
• 文件可以用 @path/to/file 语法引入其他文件。
• 如果仓库里已经有给其他智能体用的 AGENTS.md，Claude Code 会读取它来代替 CLAUDE.md。
• /context 会显示加载了哪些记忆文件。

值得掌握的命令

命令	作用
claude	启动交互式会话
claude "任务"	带着第一条指令直接启动
claude -p "问题"	不开会话的单次查询，结果输出到终端
claude -c	继续当前目录下的上一次对话
claude -r	选择之前的某次对话来恢复
/init	生成初始的 CLAUDE.md
/clear	在不相关的任务之间清空上下文
/compact	总结对话以释放上下文
/rewind（或按两次 Esc）	把对话和文件改动回退到选定的节点
/permissions	受信任工具列表，减少确认提示
Shift+Tab	切换权限模式，包括计划模式
/exit	退出

-p 模式在脚本里特别好用：cat error.log | claude -p "解释这个错误" 会把文件直接发给模型。

五个带来差别的习惯

官方最佳实践里的大部分建议都归结于一个限制：上下文窗口很快就会被填满，质量也会随之下降。

1. 先探索和计划，再写代码。 做较大的改动时，打开计划模式（按 Shift+Tab 直到出现 plan mode on）。Claude 会读取文件并提出计划，但在你批准之前不会做任何改动。如果只是一行的修复，计划就是多余的负担。
2. 说得具体。 不要只说“修复登录 bug”，而是说明症状是什么、原因大概在哪里，以及怎样才算“修好了”。用 @文件名 指定文件。
3. 给智能体一个检查自己工作的办法。 测试、构建、lint，或者一张用来对比的截图。没有这些，“看起来完成了”就是唯一的信号，而测试员就成了你自己。
4. 清理上下文。 在不相关的任务之间使用 /clear。如果你已经在同一个问题上纠正了 Claude 两次，就用更好的提示词重新开始。
5. 放心回退。 每条提示词都会创建一个检查点。实验失败时，/rewind 会恢复对话和文件。它不能代替 git，但能鼓励你做更大胆的尝试。

常见问题

Claude Code 免费吗？

不免费。文档要求付费的 Claude 套餐（Pro、Max、Team 或 Enterprise），或者按 API token 付费的 Claude Console 账号。当前的套餐价格见 claude.com/pricing。

Claude Code 能在 Windows 上运行吗？

能，既可以原生运行（PowerShell 或 CMD），也可以在 WSL 里运行。在原生 Windows 上最好装上 Git for Windows，这样智能体会使用 Bash；没有的话，它会使用 PowerShell。

一定要用终端吗？

不一定。同一个智能体还提供 VS Code 和 JetBrains 扩展、桌面应用和浏览器版本。CLAUDE.md 文件、设置和 MCP 服务器在这些平台上的表现都一样。

Claude Code 和 Claude 聊天有什么区别？

聊天负责回答问题。Claude Code 在你的仓库里干活：读取和修改文件、运行命令和测试、提交 commit、发起 pull request。所以它接收的是任务，而不是问题。