Claude Code 怎么安装，第一次会话怎么跑？

开始之前

需要准备三样东西：一个终端、一个项目文件夹，以及一个包含 Claude Code 的账号。第一次会话用任何代码文件夹都行。还没有项目也没关系，Anthropic 的终端指南说，Claude 可以帮你新建一个。没用过终端的话，同一份指南也教怎么打开。

账号是最容易卡住人的一步。按安装页面，Claude Code 需要 Pro、Max、Ultra、Team 或 Enterprise 套餐，或者 Claude Console 账号，或者通过 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 使用。免费的 claude.ai 账号不在这份名单里。

下面的数字是最低要求。Linux 方面，页面列的是 Ubuntu 20.04、Debian 10 和 Alpine Linux 3.19 及更新版本，而且安装全程都要联网。

安装 Claude Code 并开始第一次会话

Anthropic 把原生安装器标为推荐方式，所以这里用它。只复制和你系统对应的那一段，粘贴到终端，按回车。

安装器下载时不显示进度。窗口别关，等它提示 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

1. 打开终端。macOS 按 Cmd + Space，输入 Terminal 再按回车。Linux 按 Ctrl + Alt + T。Windows 按 Win + X，选 Windows PowerShell 或终端。
2. 把你系统对应的安装命令粘贴进去，按回车，等安装完成的提示出现。
3. 新开一个终端窗口，运行 claude --version。安装成功会打印一个版本号，后面跟着“(Claude Code)”，例如 2.1.211 (Claude Code)。
4. 用 cd /path/to/your/project 进入项目文件夹，路径换成你自己的，然后运行 claude。
5. Claude Code 提示登录时照做。浏览器会打开，用你的 Claude 账号登录，凭据会被保存下来，下次不用再登录。
6. 输入第一个问题，比如 what does this project do?。Claude 会按需读取文件，你不用自己贴内容。
7. 请它做一个小改动，比如 add a hello world function to the main file。Claude Code 会找到文件并显示修改。如果它在改之前先问你，选 Yes 批准。
8. 用 /exit 退出，或者在空白提示符下连按两次 Ctrl + D。

该选哪种安装方式

除非你平时本来就用包管理器装软件，否则选原生安装器。原生安装会在后台自动更新，Homebrew、WinGet、apt、dnf 和 apk 装的默认不会，要自己升级。

Homebrew 通过 cask 名称选更新通道。claude-code 跟随稳定通道，Anthropic 说它通常比最新版晚大约一周，并且会跳过有重大问题的版本。claude-code@latest 一发布就能拿到新版本。

npm 方式是 npm install -g @anthropic-ai/claude-code，装的是同一个原生程序。它要求 Node.js 22 或更高，不过版本更低时 npm 只打印 EBADENGINE 警告，安装照样完成。前面别加 sudo。Claude Code 自己更新时运行 npm 不用 sudo，需要 sudo 才能装的安装，没法自动更新。如果 npm --version 以 12 开头，装之前先看下面的常见问题，因为 Anthropic 为这个版本单独写了修复办法。

原生安装下，claude update 会立刻应用更新。claude doctor 不开启会话，只打印只读的诊断信息，包括安装状况和设置文件的错误。

第一个小时会用到的命令

登录之后，提示符上方会显示版本、当前模型和工作目录。终端里不能用鼠标点，用方向键移动。Claude 工作时按 Esc 可以打断它。按 Shift+Tab 切换权限模式，它决定 Claude 不问你就能做哪些事，第 2 课专门讲它。

快速入门说，输入 / 会列出你能用的命令和技能，Tab 可以补全命令。其余的日常命令都在下面这张表里。

Claude Code 的作者自己怎么配置

Boris Cherny 是 Claude Code 的作者，在 Anthropic 做 Claude。他 2026 年 1 月 2 日在 X 上分享了自己的配置，说它可能“出奇地朴素”。他写道，Claude Code 开箱就很好用，所以他自己很少改。对刚装好的你来说，这一课里的默认设置完全可以先用着，边用边学。

同一串帖子里，他的第 10 条讲批准。他不用 --dangerously-skip-permissions，而是用 /permissions 预先允许那些他确定安全的常用 bash 命令，这些规则大多写在 .claude/settings.json 里，提交到 git，和团队共享。如果你的会话总为同一条安全命令反复要你批准，就在这个对话框里一次性允许它。

X 官方嵌入卡片的截图，拍摄于 2026 年 11 月 5 日，时间为 UTC。X 在第一条帖子处用“Show more”截断了后面的内容。点击截图可到 X 上打开原帖。

常见错误

最常见的安装失败，是装好了但 claude 找不到。安装器把程序放在 macOS 和 Linux 的 ~/.local/bin，或 Windows 的 %USERPROFILE%\.local\bin，这个文件夹必须在你的 PATH 里。安装器发现问题时，会在“Setup notes”下说明并给出修复命令，但它自己不会改你的 PATH。完整步骤见 Anthropic 的安装故障排查页面。

运行你所用 shell 对应的那组命令，然后新开一个终端窗口。已经开着的窗口还是旧的 PATH。

# macOS with Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Linux with Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

• 混淆 Windows 的两种 shell。出现 'irm' is not recognized，说明你在 CMD 里，请改开 PowerShell，或者用 CMD 的命令。出现 The token '&&' is not a valid statement separator，说明你在 PowerShell 里运行了 CMD 的命令。提示符以 PS 开头的就是 PowerShell。
• 在 Windows 上运行 macOS 和 Linux 的命令。PowerShell 里的 curl 是另一个命令的别名，不认 -fsSL 这些参数。请改用 PowerShell 的命令。
• 拿到的是网页而不是脚本。出现 syntax error near unexpected token '<'，说明地址返回了 HTML。如果那个页面写着“App unavailable in region”，就是 Claude Code 没有在你所在的国家提供。否则再运行一次命令，或者改用 Homebrew 安装。
• 在 shell 配置文件里留着旧的 ANTHROPIC_API_KEY。Anthropic 把前一份工作或旧项目遗留的密钥，列为“组织已被停用”这类错误的原因之一，因为这个密钥会盖过你的订阅。
• 照着旧教程做。搜索结果里有些教程还把 Node.js 18 写成最低版本，或者一上来就让你 sudo npm install -g。安装页面现在只对 npm 方式要求用 Node.js，明确警告不要用 sudo，并把原生安装器排在最前面。
• 登录时浏览器没打开就放弃了。按 c 复制登录地址，粘贴到浏览器里即可。登录无缘无故失败时，先 /logout，再运行 claude，可以从头登录。

动手试试

• 在普通终端里运行 claude --version 和 claude doctor，两个都应该没有报错地结束。
• 在一个项目里打开 Claude Code，问快速入门里的三个问题：这个项目是做什么的，用了哪些技术，主入口在哪里。
• 请它在一个临时文件里改一行。如果 Claude 先问你，批准之前先读一遍它提出的修改。然后在下一个请求进行中按 Esc，确认你随时能打断它。
• 退出，在同一个文件夹里运行 claude -c，检查之前的对话是否回来了。

下一课：计划模式

Claude Code 装好了，也完成了第一次修改。改之前它问没问你，取决于会话的权限模式。第 2 课讲这些模式，并教你怎样让 Claude 先出计划，在你点头之前一个文件都不改。

安顿下来的这段时间，可以配着读 Mindket 的两篇文章。项目里那份常驻说明文件，见 CLAUDE.md 指南，怎么把 Claude Code 连到外部工具，见另一篇讲添加 MCP 服务器的文章。

常见问题

资料来源

1. Claude Code docs: Quickstart (2026年11月4日 查阅)https://code.claude.com/docs/en/quickstart
2. Claude Code docs: Advanced setup (2026年11月4日 查阅)https://code.claude.com/docs/en/setup
3. Claude Code docs: Terminal guide for new users (2026年11月4日 查阅)https://code.claude.com/docs/en/terminal-guide
4. Claude Code docs: Troubleshoot installation and login (2026年11月4日 查阅)https://code.claude.com/docs/en/troubleshoot-install
5. Boris Cherny on X: his Claude Code setup, 2 January 2026 (2026年11月5日 查阅)https://x.com/bcherny/status/2007179832300581177
6. Boris Cherny on X: tip 10, permissions, 2 January 2026 (2026年11月5日 查阅)https://x.com/bcherny/status/2007179854077407667