安装 Claude Code：跑通第一次会话

装软件这一步，是大多数零基础读者的第一道坎：不是装不上，而是看到一屏英文报错就以为自己搞坏了电脑。

先给你吃一颗定心丸：Claude Code 的安装只有一条命令，而且官方文档把每种常见报错都对应好了解法。 这一课带你一步一步做，同时告诉你每一步「正常应该看到什么」，这样你能判断自己有没有走偏。

动手前：确认三件事

1. 有账号。 Claude Code 需要 Claude 的 Pro、Max、Team 或 Enterprise 订阅，或者一个 Claude Console（按量付费的 API）账号。官方明确说，免费版 claude.ai 不含 Claude Code。订阅价格见上一课，以官网为准。
2. 系统够新。 官方要求：macOS 13.0 及以上，Windows 10 版本 1809 及以上，或 Ubuntu 20.04、Debian 10、Alpine 3.19 及以上；内存 4 GB 以上；需要联网。
3. 所在地区受支持。 官方要求使用地在其支持的国家和地区内。请先看支持列表，并遵守服务条款。

终端是什么，怎么打开

终端（terminal）就是一个用文字给电脑下命令的窗口。你平时用鼠标双击打开文件夹，在终端里是输入一行命令来做同样的事。它看起来像黑底白字的聊天框，但你不是在跟人聊，而是在和操作系统对话。

怎么打开：

打开后你会看到一个闪烁的光标，前面有一串提示符，比如 yourname@mac ~ % 或 PS C:\Users\yourname>。意思是「我在等你输入命令」。

三个最基本的命令，能让你在里面不迷路（macOS、Linux 和 Windows PowerShell 通用）：

• pwd：我现在在哪个文件夹？
• ls：这里面有什么？
• cd 文件夹名：进入某个文件夹。cd .. 是回到上一级。

几条保命常识：

• 终端里不能用鼠标点，光标移动用方向键；
• 命令跑起来后想打断它，按 Ctrl + C；
• 命令是回车才执行的，粘贴一行命令后别忘了按回车；
• 敲命令时大小写和空格都有意义，能复制粘贴就别手打。

安装

在终端里粘贴下面对应你系统的一条命令，回车。官方推荐这种「原生安装」，它会在后台自动更新。

注意两点。第一，安装过程中看不到进度条，终端像是卡住了，其实是在下载，耐心等到出现安装成功的提示。第二，装完后要关掉这个终端窗口、重新开一个，再验证：

# macOS / Linux 示例
$ curl -fsSL https://claude.ai/install.sh | bash
  （等待下载，无进度显示……）
  Claude Code successfully installed!
# 关掉窗口，重新打开一个终端，再运行：
$ claude --version
  2.1.211 (Claude Code)

版本号会随时间变化，能打印出「数字 + (Claude Code)」就说明安装成功。

其他安装方式：macOS 可用 Homebrew（brew install --cask claude-code），Windows 可用 WinGet（winget install Anthropic.ClaudeCode），Linux 有 apt、dnf、apk 仓库。这些方式不会自动更新，需要自己定期升级。零基础读者建议直接用上面的原生安装。

关于 Windows 上的 Git：官方推荐在原生 Windows 上装 Git for Windows，这样 Claude Code 能使用 Bash 工具；不装的话它会改用 PowerShell。安装时一路点「下一步」保持默认即可。第 6 课我们也会用到 git，所以装一下不亏。

登录与第一次会话

先建一个练习用的文件夹并进去。macOS、Linux 和 Windows PowerShell 都可以这样做：

$ mkdir claude-hello
$ cd claude-hello
$ pwd
  /Users/yourname/claude-hello
$ claude

输入 claude 回车后：

1. 工作区信任：第一次在一个文件夹里启动，它会问你是否信任这个文件夹。这是安全机制：确认这是你自己的文件夹再选信任。
2. 登录：浏览器会自动打开，登录你的 Claude 账号并授权。若浏览器没弹出来，终端里按 c 复制登录链接，自己粘贴到浏览器。登录成功后终端会显示 Login successful，按回车继续。
3. 进入会话：你会看到版本、当前模型、当前文件夹，下面是输入框。

之后的凭据会保存在本机，不用每次登录。想换账号用 /login，退出登录用 /logout。

关于「它会不会乱改我的电脑」

会话里的权限模式决定了它不问你就能做什么。官方当前的设计是这样的：

• 手动模式（Manual）：默认只能读。要改文件、跑命令都先问你，你选允许一次或始终允许；
• 自动模式（Auto）：由另一个模型审查它要做的动作，只拦下它认为有风险的。较新版本在终端里默认从自动模式开始，较旧版本只在部分订阅上默认如此；
• 接受编辑（Accept edits）、计划（Plan） 等其他模式。

你可以随时按 Shift + Tab 在几种模式间切换，状态栏会显示当前模式。刚入门时，我建议你把它切到手动或接受编辑，看着它每一步要做什么，培养对它行为的直觉。如果你看到的第一次会话没有一直弹确认，不用担心，那是自动模式在工作。权限的细节在权限管理一课展开。

问出第一个问题

在空文件夹里先让它做件无害的事：

它会运行类似 git --version 的命令，这时留意它请求权限的提示。这是你第一次看到智能体的「读、想、做、验」。没装 git 或 Node.js 也不要紧，后面的课程里会处理。

常用的几个命令和按键

你不需要现在记住所有，下面这些够你用一个星期。

在终端里（启动前）

在会话里（斜杠命令）

按键

• Esc：中途打断它，已完成的工作保留，你可以改口；
• 输入框为空时连按两次 Esc：打开回退菜单；
• Shift + Tab：切换权限模式；
• 输入多行：先输入 \ 再回车，或用 Ctrl + J。

装不上怎么办：排错思路

遇到报错，先别慌，按这个顺序想：报错是在安装阶段、启动阶段，还是登录阶段？ 然后对照下表。每一项都来自官方排错文档。

还有两个通用的诊断工具：

• 在终端运行 claude doctor，它会不启动会话就打印安装和设置的诊断；
• 在会话里输入 /doctor，让 Claude 帮你检查并提出修复建议。

网络问题（客观说明）

安装脚本要从 downloads.claude.ai 下载程序，登录和使用时还要连接 Anthropic 的服务。网络不通时，你可能看到连接超时、Could not resolve host、下载中断，或者 403。

官方给出的诊断办法是在终端执行 curl -sI https://downloads.claude.ai/claude-code-releases/latest（Windows PowerShell 里用 curl.exe），第一行出现 200 说明能连通；403 通常是网络过滤或地区不受支持；5xx 是服务暂时问题，等几分钟再试；没有任何输出或超时说明你的网络挡住了这条连接。

官方排错文档对「地区网络限制」给出的建议是换一个网络或使用 VPN。需要提醒你的是：地区是否受支持由服务条款决定，不是技术上能不能连上就算数。 请你自行评估并遵守相关规定，本站不推荐任何具体的网络服务。如果试过以后仍然无法使用，不如回到上一课，选一个你所在地区能稳定使用的工具，学习路径中的方法同样适用。

动手试一试