应用安装
检查使用条件
当前官方文档列出的基础要求包括：macOS 13.0 及以上；Windows 10 1809 及以上或 Windows Server 2019 及以上；Ubuntu 20.04、Debian 10、Alpine Linux 3.19 及以上的对应系统环境。设备需具备至少 4 GB 内存，处理器为 x64 或 ARM64，并能够连接所需服务。
此外，还应确认账户所在地区符合 Anthropic 的支持范围。安装工具与项目运行环境也应分别准备：安装 Claude Code 并不会自动使所有 Go、Python 或 Node.js 项目具备运行条件，具体项目仍可能需要相应语言工具和依赖。
Windows 可以原生运行 Claude Code，也可以通过 WSL 使用 Linux 环境。原生方式适合采用 Windows 工具链的项目；WSL 2 适合需要 Linux 工具链或受支持沙箱能力的情况。选择时宜与现有项目所在环境保持一致，避免在不同系统路径和依赖之间反复切换。
执行原生安装
官方推荐使用原生安装，以下方式根据操作系统和终端选择一种即可，不需要逐项执行。
macOS、Linux 与 WSL
在 Bash 或 Zsh 等相应终端中执行：
Windows PowerShell
打开 PowerShell，执行：
如果使用 CMD，执行：
PowerShell 与 CMD 的命令不能直接互换。例如，CMD 不能识别 PowerShell 的 irm；部分 PowerShell 环境也不能按 CMD 的写法处理 &&。遇到此类错误时，应先核对终端类型，不宜反复执行不同系统的命令。
原生安装不要求先安装 Node.js。已有 Homebrew、WinGet 或 npm 使用习惯的用户，也可以选择官方文档列出的对应方式，但应避免在同一设备中重复安装多个来源的版本。
环境变量配置
原生安装完成后，需要确认安装目录已加入环境变量，它用于指定系统查找程序的目录，配置后才能在终端中直接运行 claude 命令。
如果安装结果出现 is not in your PATH 提示，表示程序已安装成功，但安装目录尚未加入命令查找路径。请根据操作系统完成以下配置；如果已经可以正常运行 claude --version，可直接跳到“验证安装结果”。
Windows
安装结果中的 Location 会显示 Claude Code 主程序的完整路径，例如：
配置环境变量时，需要填写的是程序所在的文件夹，因此应去掉末尾的 \claude.exe，得到：
实际操作时，应根据自己安装结果中的 Location 确认路径。默认安装目录也可以写作 %USERPROFILE%\.local\bin ，其中 %USERPROFILE% 表示当前 Windows 用户目录。
按以下步骤配置：
-
在 Windows 开始菜单中搜索并打开「编辑账户的环境变量」。
-
在「用户变量」中找到
Path，点击「编辑」。
- 检查列表是否包含上面确认的安装目录。如果没有，点击「新建」，添加该目录，末尾不包含
claude.exe。
- 依次点击「确定」保存，关闭所有 Windows Terminal、PowerShell 或 CMD 窗口，再重新打开终端。
添加的是 claude.exe 所在的文件夹路径，末尾不包含 claude.exe。应保留 Path 中已有的其他条目；如果安装目录已经存在，无需重复添加。
macOS
安装结果中的 Location 会显示 Claude Code 主程序的完整路径，例如：
其中，~ 表示当前用户的个人目录，claude 是程序文件名。需要加入 PATH 的是程序所在的文件夹：
macOS 默认使用 zsh。对于使用 zsh 的终端，可按以下步骤配置：
- 打开「终端」，执行下面的命令，将安装目录加入 zsh 配置文件：
其中，$HOME 表示当前用户的个人目录，末尾的 $PATH 用于保留已有的命令搜索路径。如果安装结果显示的是其他目录，应将 $HOME/.local/bin 替换为实际安装目录，末尾不包含 /claude。
- 执行下面的命令，让配置在当前终端立即生效：
- 执行以下命令，确认终端能够找到 Claude Code：
配置保存在 ~/.zshrc 中，以后新打开的 zsh 终端也会自动加载。如果文件中已经有相同的配置，无需重复添加；应保留其中已有的其他内容。如果你自行切换到了 Bash 等其他 shell，需要将对应的 PATH 配置写入该 shell 使用的启动配置文件。
验证安装结果
安装完成后，打开新的终端窗口，执行：
正常情况下，终端会输出版本号及 Claude Code 标识。该输出仅用于确认程序已经能够启动，不代表账户已登录，也不代表当前项目的运行依赖已经齐全。
进一步检查安装和配置，可执行：
该命令提供只读诊断，包括安装状态、设置文件问题及相关处理建议。若出现 command not found 等提示，应先确认已重新打开终端，再根据官方故障排查说明检查安装目录是否加入 PATH。
登录使用账户
先进入准备使用的项目目录，再执行以下命令启动 Claude Code：
首次运行 claude 时，会先进入初始化引导，选择终端的显示主题。使用键盘上下方向键切换选项，按 Enter 确认。可以选择自动匹配终端的 Auto (match terminal)、深色的 Dark mode 或浅色的 Light mode，下方代码区域会展示对应的配色效果。主题之后也可以在 Claude Code 中通过 /theme 修改。
完成主题选择后，终端会显示「选择登录方式」（Select login method）。使用键盘上下方向键选择与实际使用方式对应的选项，按 Enter 确认：
-
Claude 订阅账户（Claude account with subscription）：适用于 Pro、Max、Team 或 Enterprise 用户。个人用户应使用订阅对应的 Claude 账户；Team 或 Enterprise 用户应使用已获得组织授权的账户。
-
Anthropic Console 账户（Anthropic Console account）：适用于通过 Anthropic Console 使用官方 API 的用户，费用按 API 使用量计算（API usage billing），与 Claude 订阅分别计费。
-
第三方平台（3rd-party platform）：适用于通过 Amazon Bedrock、Microsoft Foundry 或 Google Vertex AI 使用 Claude 的用户，应根据所选平台的要求完成认证与配置。
选择后，继续按照终端提示操作。需要浏览器授权时，在浏览器中登录对应账户并完成授权，再返回终端继续。
浏览器未自动打开时，可以按提示复制登录链接并手动访问。部分 WSL、SSH 或容器环境无法直接完成本地回调，浏览器可能显示授权代码；此时应按终端提示将代码粘贴到指定位置。
完成认证并继续启动后，显示工作目录确认界面（Accessing workspace），询问该目录是否属于自己创建或信任的项目。Claude Code 会以此作为当前工作目录，并可能在权限允许的范围内读取、修改文件和执行命令。
登录完成后，可通过 /status 核对当前账户及认证方式。需要切换账户或重新认证时，在会话内输入：
需要退出账户时，输入：
组织账户可能受到管理员配置的登录方式、组织归属或模型提供方限制。无法选择预期方式时，应先检查组织要求，不宜将其直接判断为安装故障。
更新应用版本
原生安装默认在后台自动更新。需要立即检查并应用更新时，在系统终端执行：
采用包管理器安装的用户，应根据安装来源更新。例如，Homebrew 和 WinGet 分别使用：
如果使用 npm 安装，当前官方 npm 包要求 Node.js 22 或以上；更新时使用：
版本更新后，应重新打开相关终端或会话，再通过 claude --version 检查当前版本。功能入口与命令说明可能随版本变化，界面或操作方式发生变化时，应优先结合当前 /help 和官方文档核对。
评论
登录后查看