这一页只讲怎么把 Claude Code 装到电脑上。装完请回到 Claude Code 配置 填写网关地址和 Key。

先确认你的系统

系统	是否支持	说明
Windows 10 1809+ / 11	支持	原生装或装进 WSL 都行，见下方选择
Ubuntu 20.04+ / Debian 10+	支持
macOS 13.0+	支持
Alpine Linux 3.19+	支持	需要额外装几个依赖包

硬件要求：4 GB 以上内存。

Windows 用户：原生装还是 WSL？

	原生 Windows	WSL 2
需要装 WSL	不用	要
命令沙箱（sandbox）	不支持	支持
适合	项目在 Windows 盘上、用 Windows 工具链	项目在 Linux 环境、要隔离执行命令

不确定就选原生——最简单，不用先折腾 WSL。

安装

Windows（PowerShell）

按 Win 键搜索「PowerShell」打开，粘贴回车：

irm https://claude.ai/install.ps1 | iex

Windows（CMD）

如果你用的是命令提示符（窗口标题没有 PS 字样）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

macOS / Linux / WSL

打开终端，粘贴回车：

curl -fsSL https://claude.ai/install.sh | bash

怎么区分自己在 PowerShell 还是 CMD

看提示符：

• PS C:\Users\你的名字> → PowerShell，用上面 PowerShell 那条
• C:\Users\你的名字> （没有 PS）→ CMD，用 CMD 那条

用错了会报 'irm' is not recognized 或 The token '&&' is not a valid statement separator。

其他安装方式

方式	命令	适合
WinGet	winget install Anthropic.ClaudeCode	Windows 上习惯用包管理器
Homebrew	brew install --cask claude-code	macOS 上习惯用 brew
npm	npm install -g @anthropic-ai/claude-code	已有 Node.js 环境（需要 Node.js 22+）

不要用 sudo 装 npm 包

sudo npm install -g 会导致权限问题，也可能带来安全风险。如果遇到权限报错，应该去修 npm 的全局目录权限，而不是加 sudo。

验证装好了

claude --version

能打印出版本号（类似 2.1.211 (Claude Code)）就成功了。

想看得更详细一点：

claude doctor

它会做一次只读的体检——安装是否健康、配置文件有没有写错、有没有可修复的警告，不会启动会话。

装完下一步

回到 Claude Code 配置，设置 ANTHROPIC_BASE_URL 和 API Key。

还没登录过 Anthropic 账号？

Claude Code 默认会引导你登录 Anthropic 账号。接到我们这里之后不需要——设好 ANTHROPIC_AUTH_TOKEN 就会用你的 API Key 走我们的网关。

装不上的常见原因

报错	原因	怎么办
command not found: claude	安装目录不在 PATH 里	关掉终端重新开一个；还不行就重启电脑
syntax error near unexpected token '<'	在 PowerShell/CMD 里跑了 Linux 的命令	对着上面的系统选对应的命令
permission denied	权限不足	Linux/macOS 上不要加 sudo，改用手动指定安装目录
下载卡住 / 403	网络原因	挂代理重试，或改用 WinGet / Homebrew / npm

相关页

• Claude Code 配置 —— 填网关地址和 Key
• 调用方式 —— 为什么 Base URL 不带 /v1