在Linux/WSL2环境下安装和配置Claude Code的全过程

前言

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

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

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

方法一：官网下载

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

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

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

sudo apt update
sudo apt install -y nodejs npm

验证安装

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

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

二、安装Claude Code

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

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

验证安装

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

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. 若在使用中出现上游分组饱和，请切换分组使用

4. 点击提交

5. 点击复制按钮复制API令牌，也就是API KEY

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

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

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

配置内容：

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

创建步骤：

# 创建.claude目录（如果已存在可跳过）
mkdir -p ~/.claude
# 用nano编辑配置文件
nano ~/.claude/settings.json

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

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

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

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

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

永久设置（全局生效）：
将以下内容写入~/.bashrc或~/.zshrc：

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

配置内容：

{
  "primaryApiKey": "any"
}

创建步骤：

# 确保.claude目录存在
mkdir -p ~/.claude
# 编辑配置文件
nano ~/.claude/config.json

粘贴内容后保存退出。

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

四、启动Claude Code

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

claude

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

五、常见问题排查

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

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

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

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

重启Claude Code即可。

调试小技巧

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

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

总结

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

如果遇到连接失败，记得检查~/.claude/settings.json配置和~/.claude.json引导文件。跟着步骤操作，基本能一次跑通。

以上就是在Linux/WSL2环境下安装和配置Claude Code的全过程的详细内容，更多关于Linux/WSL2安装和配置Claude Code的资料请关注脚本之家其它相关文章！

最新评论