Claude Code在Linux/WSL2上的安装与API对接，一篇搞定所有步骤

前言

这篇文章整理了我在Linux/WSL2环境下的完整配置过程，从Node.js安装到Claude Code部署，再到API对接（用了个中转方案省掉翻墙和海外账号），每个步骤都附了命令和配置示例，亲测可用。如果你也是技术小白或想少踩坑，跟着做应该能顺利跑起来。

正文

一、安装Node.js

Claude Code要求Node.js版本至少18（建议LTS版），这里提供两种安装方法，选一种即可。

方法一：官网下载

访问Node.js官网，下载对应Linux系统的LTS版本二进制包，或用nvm（Node版本管理器）安装，适合需要多版本管理的用户。

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

直接用系统包管理器安装，简单快捷：

sudoaptupdatesudoaptinstall-ynodejsnpm

验证安装

安装完成后，检查版本是否达标：

node--version# 应显示v18.x或更高npm--version# 通常随Node.js一起安装

二、安装Claude Code

用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code

验证安装

安装后检查是否成功：

claude--version# 应显示版本号，如1.0.0

三、配置API连接

使用Claude Code需要API密钥，这里用88api(官网：https://api.88api.shop)作为中转方案（国内直连，不用翻墙和海外账号，一个Key还能管理多个模型，切换方便，大家也可以用其他API）。

前提：获取API Key

获取Key的步骤：

1. 注册并登录后，点击侧边栏“API令牌”。
   

2. 点击“添加令牌”
   

3. 选择分组

   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

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

方法一：配置文件（推荐）

通过配置文件永久保存API信息，无需每次设置环境变量。

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

配置内容：

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

创建步骤：

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

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

方法二：环境变量（临时/永久）

如果不想用配置文件，可通过环境变量设置。

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

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换为实际Key

永久设置（所有终端生效）：
将以下内容写入~/.bashrc或~/.zshrc（根据你使用的shell选择）：

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 替换为实际Key

保存后执行source ~/.bashrc（或source ~/.zshrc）使配置生效。

⚠️注意：替换"你的API密钥"为实际值，配置后需重启终端（VSCode等IDE需彻底重启，仅重启终端可能不生效）。

VSCode插件配置（可选）

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

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

配置内容：

{"primaryApiKey":"any"}

创建步骤：

mkdir-p~/.claude# 如已存在可跳过nano~/.claude/config.json

粘贴内容后保存退出（此文件与命令行工具的settings.json是两个独立文件）。

四、开始使用

配置完成后，在终端输入：

claude

即可启动Claude Code。如需查看命令说明，执行claude --help。

五、常见问题排查

问题1：Unable to connect to Anthropic services

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

# 创建文件并写入配置cat>~/.claude.json<<'EOF' { "hasCompletedOnboarding": true } EOF# 验证文件是否创建cat~/.claude.json

重启Claude Code即可。

💡调试技巧：若仍无法连接，检查网络、重启终端/IDE，或确认API Key和Base URL配置是否正确。

总结

其实Claude Code的安装配置并不复杂，关键在于Node.js版本、API地址和密钥这几个核心点。本文从环境准备到实际使用，再到常见问题解决，整理了完整流程，尤其解决了国内用户直连的痛点。按步骤操作，基本能避开大部分坑。如果遇到其他问题，欢迎在评论区交流，一起完善这个教程~