Claude指令安装怎么做?Claude 指令指的是官方终端工具 Claude Code,命令名就是 claude。Claude指令安装本身只有一条命令的事,卡住人的通常是版本、PATH 和所在地区这三处,跟命令本身没关系。5 种官方安装方式、系统门槛与报错对照都在下文。 Claude Code 是什么,安装前要准备什么
Claude Code 是 Anthropic 推出的终端编程工具,官方说它能读懂代码库、改文件、跑命令,终端、IDE、桌面应用和浏览器里都能用。装完得到的不是普通软件包,是一个叫 claude 的本地可执行文件。多数人搜"Claude指令安装",想装的就是它。 官方快速入门给了三条前提:终端已经打开、手边有一个代码项目、有一个能用的账号。第三条最容易被忽略,官方对账号类型划得很清楚:
- 支持的类型:Pro、Max、Team、Enterprise 订阅,或 Anthropic Console 的按量计费账号;
- 不支持的类型:免费的 claude.ai 计划不含 Claude Code 访问权限;
- 第三方云通道:也可以通过 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 使用。
完全不想碰终端也行,官方另有桌面应用,装完直接在图形界面里用。
5种官方安装方式与对应命令
官方列出的安装方式一共五种,按系统和使用习惯挑一种:
| | | |
|---|
| | curl -fsSL https://claude.ai/install.sh | bash | |
| | brew install --cask claude-code | |
| | winget install Anthropic.ClaudeCode | |
| Debian、Ubuntu、Fedora、RHEL、Alpine | apt、dnf 或 apk 安装 claude-code | |
| | npm install -g @anthropic-ai/claude-code | |
Windows 装原生版要先分清自己在哪个 shell:PowerShell 用 irm https://claude.ai/install.ps1 | iex,CMD 得先下载脚本再执行。看提示符就能判断,PowerShell 显示 PS C:\,CMD 只显示 C:\。
- 安装过程不显示进度,完成后新开一个终端窗口(旧窗口仍在用旧的 PATH);
- 运行 claude --version,能打印出版本号即安装成功;
- 进入要处理的项目目录,输入 claude 回车,按浏览器提示完成登录;
- 不要用 sudo npm install -g,官方明确警告这会带来权限问题和安全风险。
原生安装的启动器落在 ~/.local/bin/claude,真实版本文件放在 ~/.local/share/claude/versions/ 目录里。Windows 上官方建议顺手装上 Git for Windows,Bash 工具才有 Git Bash 可用;不装的话 Claude Code 改用 PowerShell 执行 shell 命令。
各系统版本要求与硬件门槛对照
官方给出的运行前提如下,截止时间2026 年 10 月:
| |
|---|
| 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 |
| |
| |
| |
Node.js 这条要单独说:npm 包在 2.1.198 版(2026 年 7 月 1 日发布)把引擎要求从 Node 18 提到了 Node 22,网上大量教程还在写"Node 18 即可",已经过期。另一处容易误解:Node 版本不够时 npm 只打印 EBADENGINE 警告,不中断安装,claude 照样能跑,因为这个包下载的是原生二进制,运行时不调用你的 Node。
Alpine 这类基于 musl 的发行版还得多准备 bash、curl、libgcc、libstdc++ 和 ripgrep,并把 USE_BUILTIN_RIPGREP 设为 0。主目录挂在网络存储上时(比如多台机器共享的 NFS)要当心:会话运行期间可执行文件必须一直可读,中途被删会让会话直接 Bus error 崩掉。
装完怎么验证、登录与常用指令
验证只用一条命令:claude --version 会打印形如 2.1.211 (Claude Code) 的版本号。要看更详细的只读体检就运行 claude doctor,它给出安装健康状况、配置文件校验错误和带修复建议的警告,不启动会话。
登录是在项目目录里直接输入 claude,按浏览器提示授权。事先设了 ANTHROPIC_API_KEY 环境变量、并在询问时确认用这个密钥的话,Claude Code 会跳过登录提示。
装完最常用的几条 claude 指令:
| |
|---|
| |
| |
| |
| |
| 安装或重装指定版本,可传版本号或 stable、latest 频道名 |
| |
安装失败常见报错排查对照
官方排错页按报错原文给处置,安装阶段最常撞到的是这六类:
| | |
|---|
command not found: claude | | 新开一个终端再试;仍不行就按官方 PATH 指引把 ~/.local/bin 写进 shell 配置文件 |
syntax error near unexpected token '<' | | 等几分钟重试,或改用 Homebrew、WinGet 安装 |
| | |
App unavailable in region | | |
curl: (56) 或 curl: (23) Failure writing output | | |
Error: claude native binary not installed | | |
另有几类跟 shell 选择有关:在 PowerShell 里跑 CMD 命令会报 The token '&&' is not a valid statement separator,反过来会报 irm 不是可识别的命令。Windows 上还有两个坑,一是安装目录被其他进程占用导致文件无法访问,二是误开 32 位 PowerShell 收到不支持提示。
安装 Claude Code 的注意事项
- 别用 sudo 装 npm 包:官方明确不要执行 sudo npm install -g,权限问题与安全风险都由它引起。
- 升级别用 npm update -g:它会沿用最初安装时的版本范围,可能升不到最新版,正确写法是 npm install -g @anthropic-ai/claude-code@latest。
- 只有原生安装默认自动更新:Homebrew、WinGet 和 Linux 包管理器装的默认都要手动升级;想让 Claude Code 代跑升级命令,可把 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设为 1。
- 卸载前想清楚数据:删掉 ~/.claude 目录和 ~/.claude.json,会一并清掉全部设置、允许的工具、MCP 配置与会话历史;项目级配置在项目内的 .claude 目录和 .mcp.json。
- 账号门槛先确认:免费的 claude.ai 计划不含 Claude Code,需要 Pro、Max、Team、Enterprise 或 Console 账号之一。
- 只走官方渠道:官方安装入口与安装包只此一处,凡要求输入账号密码或支付信息的非官方页面都不要提交信息。
- 换镜像解决不了地区限制:第三方教程常建议把 npm 源换成国内镜像,这只改善安装包的下载速度,并不改变服务本身可用的国家/地区范围。
Claude指令安装常见问题
Q:Claude Code 要单独付费吗?
A:它不单独计价,但必须挂在一个支持的账号上,也就是 Pro、Max、Team、Enterprise 订阅或 Console 的按量计费账号,免费的 claude.ai 计划用不了。
Q:安装必须装 Node.js 吗?
A:只有 npm 那一种方式需要,而且要 22 或更高;官方安装脚本、Homebrew、WinGet 和 Linux 包管理器都不依赖 Node。
Q:Node 版本低于 22 会装不上吗?
A:不会中断。npm 只打印 EBADENGINE 警告,安装照样完成,因为 claude 是原生二进制,运行时不用你的 Node。
Q:Windows 上该用 PowerShell 还是 CMD?
A:两条命令不通用。看提示符区分,显示 PS C:\ 的是 PowerShell,只显示 C:\ 的是 CMD,选错会立刻报语法错误。
Q:装完提示找不到 claude 怎么办?
A:多数是安装目录没进 PATH,新开一个终端窗口通常就好;仍不行则按官方指引把 ~/.local/bin 写进 shell 配置文件。
Q:怎么升级到最新版?
A:原生安装会后台自动更新,也可以随时手动执行 claude update;Homebrew 装的用 brew upgrade,npm 装的用 npm install -g @anthropic-ai/claude-code@latest。
Q:能装指定版本吗?
A:可以。官方安装脚本接受版本号或 stable、latest 频道名,装完 claude --version 会打印你指定的那个版本;npm 方式也可以用 claude install 指定版本重装。
Q:中国大陆能用吗?
A:按官方口径,使用位置需要在支持国家/地区清单内,不在清单内的会看到 App unavailable in region 一类提示。国内有同类合规工具,通义灵码、CodeBuddy、文心快码等都能承接日常编码需求。 Q:配置和会话记录存在哪里?
A:用户级配置在 ~/.claude 目录与 ~/.claude.json,项目级配置在项目的 .claude 目录与 .mcp.json。要彻底卸载,得先移除 VS Code 扩展、JetBrains 插件和桌面应用,再删这些文件,否则目录下次运行会被重新创建。
版本门槛与安装方式都会随官方迭代调整,动手前按当期官方文档核对一遍就行。Claude指令安装相关的入口与版本变化,本站的 AI 工具栏目会同步跟进。