712 字
4 分钟
Claude Code 安装指南

Anthropic 官方 CLI 工具,Claude Sonnet 4.5 驱动

Windows 版本教程#

系统要求#

  • Windows 10 或 Windows 11
  • Node.js 18+
  • 网络连接

1. 安装 Node.js#

方法:使用官方安装包(推荐)

  1. 访问 https://nodejs.org
  2. 下载 LTS 版本的 Windows Installer (.msi)
  3. 运行安装程序,按默认设置完成安装
  4. 安装程序会自动添加到 PATH 环境变量

验证安装:

node --version
npm --version
NOTE

提示:建议使用 LTS(长期支持)版本以获得最佳稳定性。安装完成后需重启命令行窗口。

2. 安装 Claude Code CLI#

打开命令提示符(以管理员身份运行)或 PowerShell,执行以下命令:

npm install -g @anthropic-ai/claude-code

验证安装:

claude --version
WARNING

注意:如果遇到权限问题,请确保以管理员身份运行命令提示符。

3. 配置 Claude Code API#

3.1 获取Claude Code API Key,需要知道包含url和key#

3.2 配置环境变量#

settings.json 配置(推荐,永久生效)

配置位置:%USERPROFILE%\.claude\settings.json

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "粘贴为Claude Code专用分组令牌key",
"ANTHROPIC_BASE_URL": "https://[中转站api].com"
}
}
NOTE

注意:配置文件更加安全且便于管理,需要重启 Claude Code 才生效。

4 启动 Claude Code#

配置完成后,先进入到工程目录:

cd your-project-folder

然后,运行以下命令启动:

claude

Linux 版本教程#

系统要求#

  • Linux 发行版 (Ubuntu 18.04+, CentOS 7+, Debian 9+)
  • Node.js 18+
  • 网络连接

1. 安装 Node.js#

方法一:使用包管理器

Ubuntu/Debian#

更新包列表:

sudo apt update

安装 Node.js:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
CentOS/RHEL/Fedora#

使用 dnf (Fedora) 或 yum (CentOS/RHEL):

sudo dnf install nodejs npm
# 或者
sudo yum install nodejs npm
Arch Linux#
sudo pacman -S nodejs npm

验证安装:

node --version
npm --version

方法二:使用官方安装包

  1. 访问 https://nodejs.org
  2. 下载 LTS 版本的 Linux Binaries
  3. 解压并安装到系统目录
  4. 配置 PATH 环境变量

2. 安装 Claude Code CLI#

打开终端,执行以下命令:

npm install -g @anthropic-ai/claude-code

验证安装:

claude --version

3. 配置 Claude Code API Key#

NOTE

参考windows版本,简单来说也是在对应的目录里面,找到.claude的文件夹,去配置setting.json

在windows里面路径:C:\Users\你的用户名\.claude

4. 启动 Claude Code#

配置完成后,先进入到工程目录:

cd your-project-folder

然后,运行以下命令启动:

claude

VSCode 配置教程#

如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:

在windows系统:

配置文件位置:C:\Users\你的用户名\.claude\config.json

1.创建 ~/.claude/config.json

2.内容填写:

{
"primaryApiKey": "test"
}

以上”test”文本随便填就行

Claude code更新步骤#

在后续使用中,难免要升级新版本以获取最新的模型

升级用 claude update

Claude code回退版本#

因升级最新版本,部分功能无法正常使用,考虑回退版本

  1. 例如:回退到2.0.71

npm install -g @anthropic-ai/claude-code@2.0.71

  1. 另外可能还要考虑关掉自动更新

在 ~/.claude/settings.json 文件中添加以下配置:

{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
Claude Code 安装指南
https://fuwari.vercel.app/posts/claude-code-install/
作者
Ivan Jiang
发布于
2025-12-13
许可协议
CC BY-NC-SA 4.0