别再找碎片化教程了！Claude Code(适配Linux/WSL2)从0到1安装配置，API对接一步到位

前言

这篇文章适配Linux和WSL2，是我自己实操踩坑后整理的完整流程，从Node.js环境准备到Claude Code安装，再到国内API直连配置，每个步骤都附了具体命令和配置示例。

亲测在Linux和WSL2下能跑通，适合像我一样不想折腾海外账户和翻墙的开发者，跟着一步步做应该能少走不少弯路。

正文

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

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

方法一：官网下载（推荐）

访问Node.js官网，下载Linux LTS版本的二进制包，或用nvm（Node版本管理器）安装，这种方式能避免系统包管理器版本过旧的问题。

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

如果习惯用系统包管理器，执行以下命令：

sudoaptupdatesudoaptinstall-ynodejsnpm

验证安装

安装完成后，检查版本是否符合要求：

node--version# 输出应 >= v18.x.xnpm--version# 通常会随Node.js一起安装

二、安装Claude Code

环境准备好后，用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code

验证安装

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

claude--version# 输出版本号即表示安装成功

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

Claude Code需要API密钥才能调用模型服务，这里以我使用的88api中转站为例（国内直连无需翻墙，且支持多模型统一管理），大家用自己的也可以。步骤如下：

1. 获取API Key

首先访问88api官网，注册后按以下步骤操作：

• 进入控制台，点击侧边栏「API令牌」
  

• 点击「添加令牌」
  

• 选择分组

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

• 提交后，点击「复制」按钮获取API令牌（即API Key）
  
  

2. 配置方式（推荐配置文件）

方法一：通过配置文件持久化配置（推荐）

在用户目录下创建.claude文件夹和settings.json配置文件，路径和内容如下：

配置文件路径：

~/.claude/settings.json

配置内容：

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

创建步骤：

# 创建.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（或对应shell配置文件）使配置生效。

⚠️注意：配置完成后需重启终端，若在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）。

3. VSCode插件配置（可选）

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

配置文件路径：

~/.claude/config.json

配置内容：

{"primaryApiKey":"any"}

创建步骤：

# 创建配置文件nano~/.claude/config.json

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

四、开始使用Claude Code

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

claude

首次启动会进入交互界面，可直接输入问题或代码需求。如需查看命令说明，执行：

claude--help

五、常见问题排查

问题1：启动后提示“Unable to connect to Anthropic services”

症状：启动Claude Code后无法连接服务，通常是首次启动引导流程未完成导致。

解决方案：创建.claude.json文件跳过引导：

配置文件路径：

~/.claude.json

配置内容：

{"hasCompletedOnboarding":true}

创建方法：

cat>~/.claude.json<<'EOF' { "hasCompletedOnboarding": true } EOF

验证文件是否创建：

cat~/.claude.json# 输出上述内容即成功

重启Claude Code即可解决。

💡调试小技巧：若仍无法连接，先检查网络、重启IDE，再确认API Key是否正确配置（重点核对settings.json或环境变量中的密钥）。

总结

本文从Node.js环境准备到Claude Code安装，再到国内API直连配置，完整覆盖了Linux/WSL2下的部署流程。核心是解决两个痛点：一是环境依赖（Node.js版本和安装方式），二是国内API接入（通过中转服务直连，避免海外账户和翻墙）。

如果按步骤操作仍遇到问题，优先检查配置文件路径和API密钥是否正确，或参考“常见问题”中的解决方案。技术工具配置难免踩坑，欢迎在评论区分享你的经验，一起完善这个教程~