Claude Code 全平台部署指南：Windows、Linux、macOS 与 VS Code

1. 安装 Node.js#

访问 Node.js 官网下载 LTS 版本，按照安装向导完成安装。安装结束后重新打开 PowerShell，再执行：

node --version
npm --version

2. 安装 Claude Code#

国内网络环境可以指定 npm 镜像：

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

安装完成后检查命令是否可用：

claude --version

3. 使用配置文件#

编辑下面的文件：

C:\Users\你的用户名\.claude\settings.json

写入配置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "http://apipaths.com"
  }
}

提示

如果 .claude 目录不存在，可以手动创建。JSON 最后一个字段不要添加多余逗号，否则程序会读取失败。

4. 使用环境变量#

不想保存到配置文件时，也可以在 PowerShell 中永久写入用户环境变量：

[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_BASE_URL",
  "http://apipaths.com",
  [System.EnvironmentVariableTarget]::User
)

[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_AUTH_TOKEN",
  "你的API密钥",
  [System.EnvironmentVariableTarget]::User
)

设置后需要重新打开终端。

5. 启动 Claude Code#

进入项目目录并运行：

cd D:\Projects\my-project
claude

首次使用时，可以先让 Claude Code 阅读项目，不要立即执行大范围修改：

请先分析这个项目的目录结构、技术栈和启动方式，不要修改文件。

1. 安装 Node.js#

Debian 或 Ubuntu 可以通过 NodeSource 安装 LTS 版本：

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

验证环境：

node --version
npm --version

2. 安装 Claude Code#

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

如果遇到全局目录权限问题，建议配置 npm 用户目录，不建议直接长期使用 sudo npm。

3. 配置环境变量#

使用 Bash 时，将配置写入 ~/.bashrc：

echo 'export ANTHROPIC_BASE_URL="http://apipaths.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

启动：

claude

1. 安装 Node.js#

已经安装 Homebrew 时，可以直接执行：

brew install node

2. 安装 Claude Code#

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

3. 配置环境变量#

macOS 默认使用 Zsh，将配置写入 ~/.zshrc：

echo 'export ANTHROPIC_BASE_URL="http://apipaths.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

启动：

claude

1. 安装扩展#

在 VS Code 扩展市场中搜索并安装：

Claude Code for VS Code

Cursor 可以使用相同的配置方式。

2. 配置扩展#

在项目或用户目录的 .claude/config.json 中配置：

{
  "primaryApiKey": "key"
}

这里需要特别注意：

• CLI 环境配置通常使用 settings.json
• VS Code 扩展示例使用 config.json
• 两个文件用途不同，不要混淆

找不到 claude 命令#

先检查 npm 全局目录：

npm config get prefix

确认对应的可执行文件目录已经加入 PATH，然后重新打开终端。

修改环境变量后没有生效#

Windows 需要关闭并重新打开 PowerShell；Linux 和 macOS 需要执行 source ~/.bashrc 或 source ~/.zshrc。

返回 401 或认证失败#

依次检查：

1. API 密钥是否完整
2. Base URL 是否正确
3. 服务地址是否需要附加版本路径
4. 配置文件中的 JSON 是否有效
5. 是否误用了全角引号或多余空格

网络连接超时#

可以先测试 API 域名是否能访问，并检查代理、防火墙和 DNS。企业网络中还需要确认终端是否允许访问外部服务。