Claude Code 安装指南

环境信息

- 系统: Linux

- VS Code: 1.110.1

- 最后更新: 2026-03-16

一、前置条件检查

1. 检查 nvm 是否已安装

nvm --version

如果已安装，会显示版本号（如 `0.40.4`）。

 2. 检查当前 Node.js 版本

node --version

npm --version

Claude Code 需要较新的 Node.js 版本（推荐 18+ 或 LTS 版本）。

 二、安装 Node.js（使用 nvm）

方法一：直接安装 LTS 版本

nvm install --lts

方法二：如果遇到网络问题，使用国内镜像

# 设置中科大镜像源

export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/



# 然后安装 LTS 版本

nvm install --lts

验证 Node.js 安装

node -v

# 应该显示较新版本，如 v18.x.x 或 v20.x.x

 三、安装 Claude CLI 工具

# 使用 npm 全局安装 Claude CLI

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

验证安装

claude --version

 四、安装 VS Code Claude 扩展

# 安装 Claude for VS Code 扩展

code --install-extension saoudrizwan.claude-dev




# 验证扩展安装



code --list-extensions | grep -i claude

# 应显示: saoudrizwan.claude-dev




# 如果需要重新安装扩展


code --uninstall-extension saoudrizwan.claude-dev

code --install-extension saoudrizwan.claude-dev

五、配置 Claude

### 方法一：首次运行引导


claude


首次运行时会引导你登录/配置 API 密钥。



### 方法二：手动配置（推荐用于自定义 API）



配置文件位于 `~/.claude.json`，可以手动编辑配置自定义 API 端点。


vim ~/.claude.json




配置示例：

```json

{

  "env": {

    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-R1",

    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-5",

    "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-5",

    "ANTHROPIC_AUTH_TOKEN": "your-api-key",

    "ANTHROPIC_BASE_URL": "https://your-api-endpoint.com",

    "API_TIMEOUT_MS": "3000000",

    "claudeCode.disableLoginPrompt": true,

    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"

  }

}

```



### 配置项说明



| 配置项 | 说明 |

|--------|------|

| `ANTHROPIC_AUTH_TOKEN` | API 密钥 |

| `ANTHROPIC_BASE_URL` | 自定义 API 端点（用于非官方 API） |

| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 默认 Haiku 模型名称 |

| `ANTHROPIC_DEFAULT_SONNET_MODEL` | 默认 Sonnet 模型名称 |

| `ANTHROPIC_DEFAULT_OPUS_MODEL` | 默认 Opus 模型名称 |

| `API_TIMEOUT_MS` | API 请求超时时间（毫秒） |

| `claudeCode.disableLoginPrompt` | 禁用登录提示 |

| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 禁用非必要网络请求 |



### VS Code 中配置

1. 打开 VS Code

2. 按 `Ctrl+Shift+P` 打开命令面板

3. 搜索 "Claude" 相关命令进行配置

 六、常见问题

 1. nvm 安装 Node.js 网络超时

**原因**: 国内访问 nodejs.org 较慢

**解决方案**: 使用国内镜像

```bash

export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/

nvm install --lts

```

2. Node.js 版本过低

**症状**: Claude 无法启动或报错

**解决方案**:

```bash

# 安装并切换到新版本

nvm install --lts

nvm use <新版本号>

nvm alias default <新版本号>  # 设置为默认版本

```

3. VS Code 扩展问题

```bash

# 查看已安装的扩展

code --list-extensions | grep -i claude

# 重新安装

code --uninstall-extension saoudrizwan.claude-dev

code --install-extension saoudrizwan.claude-dev

```

## 七、快速安装脚本

将以下内容保存为 `install_claude.sh` 并执行：

 

```bash

#!/bin/bash

echo "=== Claude Code 安装脚本 ==="

# 检查 nvm

if ! command -v nvm &> /dev/null; then

    echo "错误: 请先安装 nvm"

    echo "参考: https://github.com/nvm-sh/nvm"

    exit 1

fi

# 设置镜像源（国内用户）

export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/

# 安装 Node.js LTS

echo "正在安装 Node.js LTS..."

nvm install --lts

# 验证 Node.js

echo "Node.js 版本: $(node -v)"

echo "npm 版本: $(npm -v)"

# 安装 Claude CLI

echo "正在安装 Claude CLI..."

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

# 安装 VS Code 扩展

echo "正在安装 VS Code Claude 扩展..."

code --install-extension saoudrizwan.claude-dev

echo "=== 安装完成 ==="

echo "请运行 'claude' 开始使用"

```

参考链接

- [Claude Code 官方文档](https://docs.anthropic.com/claude-code)

- [nvm GitHub](https://github.com/nvm-sh/nvm)

- [Node.js 官网](https://nodejs.org/)