Claude Code在Linux/WSL2环境完整部署指南：API中转+避坑配置一篇搞定

前言

这篇文章就带你从0开始，在Linux/WSL2环境下完成安装、API配置到成功启动的Claude Code 全流程。我会用API中转服务简化国内直连，避免翻墙和海外账户问题，尽量把每个步骤讲清楚，让你少踩坑。

正文

一、准备工作：安装Node.js

Claude Code要求Node.js版本≥18（建议LTS版），先确保环境满足这个基础要求。

方法一：官网下载

访问Node.js官网，下载Linux二进制包或用nvm安装（适合需要多版本管理的场景）。

方法二：包管理器安装（Ubuntu/Debian）

如果用Ubuntu或Debian系统，直接通过包管理器安装更方便：

bash 复制代码

sudo apt update
sudo apt install -y nodejs npm

验证安装

安装完成后，检查Node.js和npm版本是否符合要求：

bash 复制代码

node --version  # 输出v18.x.x或更高
npm --version   # 通常会随Node.js一起安装

二、安装Claude Code

Node.js准备好后，用npm全局安装Claude Code：

bash 复制代码

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

验证安装

安装完成后，检查是否成功：

bash 复制代码

claude --version  # 输出类似1.0.0的版本号

三、配置API连接（核心步骤）

Claude Code需要API密钥才能调用服务。我这里用了88api中转服务（网址：https://api.88api.shop），主要是为了国内直连方便，不用折腾海外账户和网络，而且一个Key能管理多个模型，本地配置也简单。

推荐大家可以试试，或者大家也可以用自己的。下面以88 API 为例:

1. 获取API Key

获取Key的步骤：

注册并登录后，点击侧边栏"API令牌"。
点击"添加令牌"
选择分组
1. 根据需要调用的模型选择分组
  a. claude 模型建议使用 calude code 分组、
  b. gpt 模型建议使用 codex分组
2. 可通过平台的模型广场查看不同模型支持的分组
3. 若在使用中出现上游分组饱和，请切换分组使用
点击提交
5. 点击复制按钮复制API令牌，也就是API KEY

2. 配置API（推荐用配置文件）

通过配置文件永久保存API信息，比环境变量更方便管理。

配置文件路径 ：~/.claude/settings.json

配置内容：

json 复制代码

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为刚复制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转服务地址
  }
}

创建步骤：

bash 复制代码

# 创建.claude目录（如果已存在可跳过）
mkdir -p ~/.claude

# 用nano编辑配置文件
nano ~/.claude/settings.json

粘贴上述配置内容，按Ctrl+O保存，Ctrl+X退出编辑器。

3. 环境变量配置（备选方案）

如果不想用配置文件，也可以通过环境变量临时或永久配置：

临时设置（当前终端生效）：

bash 复制代码

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久设置（全局生效） ：

将以下内容写入~/.bashrc或~/.zshrc：

bash 复制代码

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后执行source ~/.bashrc（或对应shell配置文件）使其生效。

⚠️ 注意：

务必将"你的API密钥"替换为实际复制的Key

配置后需重启终端，若用VS Code/Cursor等IDE的集成终端，需重启整个IDE才能生效

4. VSCode插件配置（可选）

如果用VSCode的Claude插件，还需额外创建config.json：

配置文件路径 ：~/.claude/config.json

配置内容：

json 复制代码

{
  "primaryApiKey": "any"
}

创建步骤：

bash 复制代码

# 确保.claude目录存在
mkdir -p ~/.claude

# 编辑配置文件
nano ~/.claude/config.json

粘贴内容后保存退出。

⚠️ 注意：这是VSCode插件专用配置，与命令行工具的settings.json是两个不同文件。

四、启动Claude Code

配置完成后，在终端输入以下命令启动：

bash 复制代码

claude

首次启动可能需要确认协议，按提示操作即可。如果想查看命令说明，可执行claude --help。

五、常见问题排查

问题1：启动后提示「Unable to connect to Anthropic services」

症状：启动Claude Code后显示无法连接服务。
原因：首次启动引导未完成。
解决方案 ：创建~/.claude.json文件跳过引导：

bash 复制代码

# 直接生成配置文件
cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

# 验证文件是否创建成功
cat ~/.claude.json

重启Claude Code即可。

调试小技巧

如果配置后仍无法连接，可按以下步骤排查：

检查网络是否正常（国内网络需确保中转服务可访问）
重启终端或IDE（配置可能未生效）
核对API Key和ANTHROPIC_BASE_URL是否正确

总结

这篇教程带你在Linux/WSL2环境下完成了Claude Code的安装、API配置和启动，重点解决了国内环境下的直连问题。核心在于通过API中转服务简化配置，避免海外账户和网络障碍。

如果遇到连接失败，记得检查~/.claude/settings.json配置和~/.claude.json引导文件。跟着步骤操作，基本能一次跑通。有其他问题欢迎在评论区交流，一起避坑~