当前位置：首页 > news >正文

快速上手：ClaudeCode安装全攻略

news 2026/5/23 6:34:51

以下是从零开始安装 Claude Code 的详细操作步骤，涵盖环境准备、安装过程与验证方法。请根据你的操作系统选择对应的分支操作。

(PS: 官方文档：

接入 Claude Code | DeepSeek API Docs)

一、安装 Node.js 18 或更高版本

Claude Code 基于 Node.js 运行，需要Node.js 18+（建议使用最新的 LTS 版本）。

1. 检查是否已安装 Node.js

打开终端（或命令提示符），输入：

node --version

如果显示v18.x.x或更高版本，则已满足要求，可跳过安装步骤。
如果显示command not found或版本过低，请继续安装。

2. 安装 Node.js

Windows / macOS：访问 Node.js 官网，下载LTS 版本的安装包，运行安装程序（一路默认选项即可）。
Linux：使用包管理器安装，例如 Ubuntu/Debian：
```
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs
```
其他发行版请参考 NodeSource 指南。

安装完成后，重新打开终端，再次运行node --version确认版本。

二、Windows 用户：安装 Git for Windows

macOS / Linux 用户可跳过这一步，因为系统自带或可安装 Git，但一般 Claude Code 不强制要求（除非使用某些 Git 集成功能）。为了确保兼容性，推荐所有用户都安装 Git。

访问 Git for Windows 下载页。
下载适合你系统（32/64位）的安装程序（如Git-2.45.2-64-bit.exe）。
运行安装程序，保持默认选项直到完成（特别是要确保Git Bash和Git from the command line被选中）。
安装完成后，重启终端（或重启电脑），输入git --version验证是否成功。

三、使用 npm 全局安装 Claude Code

打开终端（Windows 用户推荐使用Git Bash或PowerShell，普通 CMD 也可）。

执行以下命令：

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

可能遇到的问题及解决：

权限错误（EACCES）：在 Linux/macOS 上，可以加sudo执行：
```
sudo npm install -g @anthropic-ai/claude-code
```
或者修复 npm 全局目录权限。

网络慢/超时：可以切换为淘宝镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

Windows 提示 “不能运行脚本”：以管理员身份打开 PowerShell，执行：
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
然后重新运行安装命令。

安装过程会显示进度条，完成后提示added xxx packages in xxs。

四、验证安装是否成功

在终端中执行：

claude --version

如果正常显示版本号（例如0.1.0），则安装成功。若提示claude: command not found，请检查：

是否成功执行了npm install -g（重新运行一次看是否有报错）。
npm 全局安装的目录是否在系统的PATH中。
- 查看全局目录：npm config get prefix
- 将该目录下的bin文件夹（Windows 为同级目录）添加到系统环境变量。

五、下一步：使用 Claude Code

安装完成后，输入claude即可启动交互式命令行工具。首次使用可能需要登录或配置 API 密钥（根据官方指南操作）。

总结步骤一览（复制用）：

安装 Node.js 18+ →node --version
Windows 用户安装 Git for Windows →git --version
npm install -g @anthropic-ai/claude-code
claude --version

如有任何错误信息，请根据提示进行排错或提供具体报错内容。

六、配置环境变量

（一）Linux / macOS 用户

1. 临时设置（仅当前终端会话有效）

打开终端，逐行执行以下命令（将<你的 DeepSeek API Key>替换为真实 Key）：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key> export ANTHROPIC_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVEL=max

验证：输入echo $ANTHROPIC_AUTH_TOKEN应显示你的 API Key（部分遮盖是正常的）。

2. 永久生效（推荐）

将上述 export 语句添加到你的 shell 配置文件中（取决于你使用的 shell）：

Bash：~/.bashrc或~/.bash_profile
Zsh：~/.zshrc
Fish：~/.config/fish/config.fish（语法略有不同）

示例（Bash/Zsh）：

echo ' export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的真实Key export ANTHROPIC_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVEL=max ' >> ~/.bashrc

然后执行source ~/.bashrc使其立即生效。

（二）Windows 用户

方式一：PowerShell（临时设置，仅当前窗口有效）

打开PowerShell（建议使用 Windows Terminal 或 PowerShell 7），执行：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>" $env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash" $env:CLAUDE_CODE_EFFORT_LEVEL="max"

验证：输入$env:ANTHROPIC_AUTH_TOKEN应显示你的 Key。

方式二：永久设置（通过系统环境变量）

按Win + R，输入sysdm.cpl并回车。
切换到高级选项卡 → 点击环境变量。
在用户变量（或系统变量）区域，点击新建，依次添加以下变量：

变量名	变量值
`ANTHROPIC_BASE_URL`	`https://api.deepseek.com/anthropic`
`ANTHROPIC_AUTH_TOKEN`	你的 DeepSeek API Key（如`sk-xxxx`）
`ANTHROPIC_MODEL`	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`deepseek-v4-pro[1m]`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`deepseek-v4-flash`
`CLAUDE_CODE_SUBAGENT_MODEL`	`deepseek-v4-flash`
`CLAUDE_CODE_EFFORT_LEVEL`	`max`

点击确定保存，然后重启终端（或重启电脑）使设置生效。

💡 你也可以使用命令行设置永久环境变量（PowerShell 管理员）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.deepseek.com/anthropic","User")
其余变量同理，但操作较繁琐，建议直接用图形界面。

（三）验证环境变量是否生效

Linux/macOS

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN | cut -c1-10 # 只显示前10位，避免泄露

Windows (PowerShell)

echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN.Substring(0,10)

（四）启动 Claude Code

完成上述配置后，在同一个终端中（若设置了永久变量则任意新终端）直接输入：

claude

Claude Code 会读取这些环境变量，将请求发送到 DeepSeek 的 Anthropic 兼容接口，并使用你配置的模型（注意deepseek-v4-pro[1m]和deepseek-v4-flash需确保在 DeepSeek 平台确实存在对应模型名称，如名称有差异请根据官方文档调整）。

常见问题

claude: command not found：说明第一步安装未成功，请回到安装步骤重新执行npm install -g @anthropic-ai/claude-code。
API 调用返回 401：检查ANTHROPIC_AUTH_TOKEN是否设置正确且未过期。
模型不存在错误：登录 DeepSeek 平台查看可用的模型名称，修正环境变量中的模型名（如可能是deepseek-chat或deepseek-reasoner）。
Windows 提示“无法加载 PowerShell 配置文件”：忽略，不影响环境变量设置，只需确保在执行claude之前运行过$env:...命令。