这篇 Claude Code (Linux/WSL2) 从安装到调用一篇搞定

前言

我整理了这份在Linux/WSL2环境下的完整Claude Code上手教程，从Node.js安装到API配置，再到解决常见报错，每一步都亲测过。特别是用了API中转服务，省掉了海外账号和翻墙的麻烦，国内环境也能稳定调用。如果你也想少踩坑快速上手，这篇文章应该能帮到你。

正文

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

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

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

访问Node.js官网，下载Linux二进制包或用nvm安装。如果你熟悉nvm，这是管理Node版本的好方式；如果不太熟悉，直接用包管理器更简单。

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

打开终端，执行以下命令：

sudoaptupdatesudoaptinstall-ynodejsnpm

验证安装是否成功

安装完成后，检查Node.js和npm版本：

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

二、安装Claude Code

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

npminstall-g@anthropic-ai/claude-code

验证安装是否成功

安装完成后，检查Claude Code版本：

claude--version# 应显示具体版本号，如0.1.0

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

Claude Code需要API密钥才能调用服务。这里用API中转服务（我用的是88api，网址：https://api.88api.shop），国内直连无需翻墙，一个Key还能管理多个模型，省掉不少环境配置麻烦。

推荐大家可以试试，或者大家也可以用自己的。

1. 获取API Key（以88api为例）

获取Key的步骤：

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

2. 点击“添加令牌”
   

3. 选择分组

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

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

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

方法一：通过配置文件设置（持久生效，推荐）

在用户目录下创建.claude文件夹和settings.json配置文件：

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

配置内容（替换你的API密钥为实际Key）：

{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","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密钥"

永久设置（所有终端生效）：
编辑~/.bashrc或~/.zshrc（根据你用的shell选择）：

nano~/.bashrc# 或 nano ~/.zshrc

在文件末尾添加：

exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"

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

⚠️ 注意：

• 务必将你的API密钥替换为实际复制的Key，否则无法连接服务。
• 配置后需要重启终端；如果在VS Code/Cursor等IDE的集成终端使用，需彻底重启IDE（仅重启终端可能不生效）。

3. VSCode插件配置（可选）

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

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

配置内容：

{"primaryApiKey":"any"}

创建步骤：

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

粘贴内容后保存退出。

⚠️ 注意：这是VSCode插件专用的config.json，和命令行工具的settings.json是两个不同文件，不要弄混。

四、开始使用Claude Code

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

claude

即可启动Claude Code。如果想查看命令说明，执行：

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和ANTHROPIC_BASE_URL是否配置正确（重点核对Key是否复制完整）。

总结

这篇教程从Node.js安装到API配置，再到解决常见报错，覆盖了Claude Code在Linux/WSL2环境下的完整部署流程。核心是通过API中转服务解决国内环境的调用问题，避免了海外账号和翻墙的麻烦。

如果你跟着步骤走，应该能顺利启动Claude Code。如果遇到其他问题，欢迎在评论区交流——毕竟环境配置有时会因系统版本略有差异，一起踩坑一起解决～