博客 · AI 工具 · 发布
Claude Code 怎么安装与登录:终端、桌面与云端三种方式
Claude Code 的安装与登录分两步:先确认账号类型(Pro、Max、Ultra、Team、Enterprise、Console,或经受支持云厂商接入;免费版 claude.ai 不含访问权限),再按入口安装。终端用官方原生命令,装完运行 claude --version 能打印版本号即成功,首次运行 claude 会引导浏览器登录;桌面应用与网页入口按页面提示操作。文中列出系统要求、Windows 原生与 WSL 的差别、验证命令和排查顺序。
Claude Code 是 Anthropic 的编程助手(能读项目文件、改代码、执行命令的 AI 助手)。要用它,先定两件事:从终端、桌面应用还是网页进入,以及手上的账号类型是否被官方支持。终端入口用官方命令安装,运行 claude --version 能打印版本号即为安装成功;第一次在项目目录运行 claude 会提示你在浏览器完成登录(官方快速入门、高级安装说明)。
一、先确认账号,再动手安装
官方在认证一节统一写明:Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账号,免费版 claude.ai 账号不包含 Claude Code 的访问权限。除了这些订阅与 Console 账号,还可以通过受支持的云厂商接入:Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry。如果所在组织自建了 Claude apps gateway(应用网关,管理员统一配好的登录入口),管理员会预先设置网关地址,输入 /login 会直接打开 Cloud gateway 页面,用企业 SSO(单点登录)登录。
这里有一个容易混的区别:能登录 claude.ai,不等于能用 Claude Code。免费账号可以注册和聊天,但要用它,账号类型要落在上面这几类里。Console 账号首次登录时,官方会自动创建一个名为「Claude Code」的工作区,用来集中统计这部分费用。
二、系统要求:先对一遍再下载
| 项目 | 官方要求 |
|---|---|
| 操作系统 | macOS 13.0+;Windows 10 1809+ 或 Windows Server 2019+;Ubuntu 20.04+;Debian 10+;Alpine Linux 3.19+ |
| 硬件 | 4 GB 以上内存;x64 或 ARM64 处理器 |
| 网络 | 需要联网 |
| 终端 | Bash、Zsh、PowerShell 或 CMD |
| 所在地 | Anthropic 支持的国家/地区 |
另有两项依赖要知道:ripgrep(搜索工具)通常随 Claude Code 一起提供,官方写明搜索失败时另看排查说明;Git 是可选依赖,装了 Git 的话,claude plugin eval 和从 macOS、Linux、WSL 上传本地仓库到云端会话都要求 git 2.31 或更高版本,可以用 git --version 先看版本。
所在地这一条是官方写明的运行条件,本文只按官方支持的地区说明,不涉及任何绕过地区限制的做法。
三、三种入口怎么选
官方把网页入口、桌面应用和终端都列为使用方式,另有 VS Code、JetBrains 等编辑器入口。与安装、登录最直接相关的是前三种:
| 入口 | 适合的情况 | 怎么开始 | 登录与账号 |
|---|---|---|---|
| 终端 CLI(命令行界面) | 项目在本地、习惯敲命令 | 按系统运行官方安装命令,进项目目录执行 claude |
首次运行按浏览器提示登录,凭证会保存 |
| 桌面应用 | 不想开终端,想要图形界面 | 从官方文档的桌面应用入口下载 macOS、Windows 或 Linux 版本 | 按应用内提示操作;账号要求见第一节 |
| 网页云端 | 想直接在浏览器里用,或把本地仓库交给云端会话 | 打开 claude.ai/code | 以页面提示为准;从 macOS、Linux、WSL 上传本地仓库需要 git 2.31 或更高版本 |
选的时候看两件事:项目在哪、你愿不愿意开终端。项目在本地、要频繁改文件,终端最直接;不想碰命令行,桌面应用是官方提供的图形入口;只想在浏览器里用,或者要把本地仓库传到云端会话,走网页入口。官方另外把从没使用过终端的人引到一份终端入门指南,里面讲怎么打开终端、怎么粘贴命令,第一次装可以先看它。
四、终端安装:一条命令,三步核对
- 打开终端。macOS 和 Linux 用系统终端;Windows 用 PowerShell 或 CMD。判断方法:提示符是
PS C:\就是 PowerShell,只有C:\就是 CMD。 - 按系统选命令(原生安装,官方标注为推荐):
- macOS、Linux、WSL(Windows 里的 Linux 子系统):
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),就说明装好了。官方特别说明:安装命令在下载过程中不显示进度,停在那里不动不等于失败。
提示找不到命令时,官方给的解释是安装目录还没进 PATH(系统查找命令的目录列表),并单独写了修复 PATH 的说明,不必急着重装。
同一件事还有几个官方渠道,按系统和使用习惯选:
- Homebrew:
brew install --cask claude-code。官方有两个 cask(Homebrew 的安装包形式),claude-code跟稳定通道,claude-code@latest跟最新通道;Homebrew 装的默认不自动更新。 - WinGet:
winget install Anthropic.ClaudeCode,同样默认不自动更新。 - Debian、Fedora、RHEL、Alpine:用 apt、dnf 或 apk 这几个系统包管理器安装,官方提供带签名的软件源。
- npm(Node.js 的包管理器):
npm install -g @anthropic-ai/claude-code,需要 Node.js 22 或更高版本;官方明确提醒不要用sudo npm install -g。
Windows:原生还是 WSL
| 方式 | 沙箱(把命令限制在隔离环境里运行) | 适合的情况 |
|---|---|---|
| 原生 Windows | 不支持 | Windows 原生项目和工具 |
| WSL 2 | 支持 | Linux 工具链,或需要沙箱执行命令 |
| WSL 1 | 不支持 | WSL 2 不可用时 |
原生 Windows 安装不需要管理员权限。官方建议装 Git for Windows,这样 Claude Code 才能用 Bash 工具;没装时它改用 PowerShell 作为执行命令的 shell 工具。如果 Claude Code 找不到 Git Bash,可以在 settings.json 里用 CLAUDE_CODE_GIT_BASH_PATH 指定路径。用 WSL 的话,要在 WSL 终端里安装和启动 claude,不是在 PowerShell 或 CMD 里装;WSL 也不需要 Git for Windows。
Alpine 和其他 musl 系发行版另有一道门槛:安装命令需要 bash 和 curl,运行还需要 libgcc、libstdc++ 和 ripgrep。Alpine 默认不带 bash 和 curl,官方给的做法是先 apk add bash curl libgcc libstdc++ ripgrep,再在 settings.json 里把 USE_BUILTIN_RIPGREP 设为 0。
五、登录:账号类型对了,浏览器授权一次就够
装好后进项目目录运行 claude:
cd /path/to/your/project
claude
第一次运行会提示登录。订阅账号或 Console 账号按提示在浏览器完成认证即可。如果你已经设置过 ANTHROPIC_API_KEY 环境变量(一种把密钥放在系统环境里、供程序读取的做法),并在它询问是否使用这个密钥时同意,它会跳过登录提示、直接走密钥。登录成功后凭证会保存,不用每次重新登录;以后想换账号或重新认证,在运行中的会话里输入 /login。
进入会话后,提示符上方会显示版本、当前模型和工作目录;输入 /help 看可用命令,/resume 继续之前的对话。按 Shift+Tab 可以切换当前会话的权限模式(permission mode,决定哪些操作要先问你)。
六、装完先验证,再决定要不要手动更新
装完不要只看安装脚本有没有报错,用两个命令核对:
claude --version:打印版本号,说明命令能被找到并且能运行。claude doctor:只读诊断,不启动会话,会列出安装健康状况、设置文件校验错误,以及带建议的警告。
更新策略取决于安装方式。原生安装会在后台自动更新,下载安装完成后下次启动生效;Homebrew、WinGet 和 Linux 包管理器装的默认要手动更新,分别是 brew upgrade claude-code(或 brew upgrade claude-code@latest)、winget upgrade Anthropic.ClaudeCode,以及各包管理器自己的升级命令。想立刻更新、不等下一次后台检查,运行 claude update。
官方还有发布通道:latest 是默认通道,新功能第一时间收到;stable 通常落后约一周,会跳过有重大回归的版本。可以在 /config 的 Auto-update channel 里切换,也可以在 settings.json 写 autoUpdatesChannel;Homebrew 装的用 cask 名区分通道,不读这个设置。
七、怎么确认装的是官方文件
官方每次发布都会提供 manifest.json(清单文件),里面列出各平台二进制的 SHA256 校验值,并用 Anthropic 的 GPG 密钥(一种用于验证文件来源和完整性的签名机制)签名,校验了这个签名就等于校验了它列出的每个二进制。macOS 的二进制由「Anthropic PBC」签名并经 Apple 公证,Windows 的二进制由「Anthropic, PBC」签名;Linux 的二进制不单独做代码签名,用清单的签名或包管理器的软件源签名来确认完整性。
八、卡住时按这个顺序排查
claude找不到:先确认安装目录有没有进 PATH,官方把这种情况单列为「Fix your PATH」。- Windows 命令报错:先确认当前是 PowerShell 还是 CMD,两种终端的命令不能混用。看到
The token '&&' is not a valid statement separator,说明在 PowerShell 里跑了 CMD 命令;看到'irm' is not recognized,说明在 CMD 里跑了 PowerShell 命令。换到对应终端再跑一次。 - 安装脚本报错:遇到
syntax error near unexpected token '<'、403 或其他错误,官方建议对照「Troubleshoot installation」找到对应修复和替代安装方式。 - 网络问题:系统要求里写明需要联网,官方另有网络配置说明;按那里的设置排查,不要靠反复重装解决。
- 卸载后还能运行:官方说明这通常意味着还有第二份安装,或旧安装器留下的 shell 别名,先找出来删掉再重装。
原生安装的卸载方式是删掉可执行文件和版本目录(macOS、Linux、WSL 用 rm -f ~/.local/bin/claude 和 rm -rf ~/.local/share/claude,Windows 用对应的 PowerShell 删除命令);Homebrew、WinGet、npm 装的分别用 brew uninstall --cask、winget uninstall、npm uninstall -g。要注意:删掉 ~/.claude 会连同设置、允许的工具、MCP(让外部工具接入 Claude Code 的配置)和会话历史一起清掉,官方提醒先把桌面应用、VS Code 扩展、JetBrains 插件卸干净,否则它们下次运行又会把这个目录建回来。
如果你同时也在比较 ChatGPT 各档订阅怎么选,站内的 ChatGPT 订阅费用总览 按使用场景整理了选择顺序,也可以直接看 ChatGPT 充值套餐 的档位说明,作为另一条参考。