Claude Code (Linux/WSL2) 安装+api配置手把手指南

前言

最近整理了这套Claude Code (Linux/WSL2) 从0到1的实操流程，从Node.js安装到API配置全程本地化，用中转服务省去翻墙和海外账户的折腾。如果你也想在Linux/WSL2环境下顺畅用上Claude Code，跟着这篇一步步来，基本不会踩坑。

正文

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

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

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

访问Node.js官网，下载对应Linux的二进制包，或用nvm（Node版本管理器）安装，后者更方便切换版本。

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

如果习惯用系统包管理器，直接执行：

sudoaptupdatesudoaptinstall-ynodejsnpm

验证安装

安装完成后，输入以下命令检查版本，出现版本号即成功：

node--version# 输出示例：v20.11.0（≥18即可）npm--version# 输出示例：10.2.4

二、安装Claude Code

Node.js就绪后，用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code

验证安装

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

claude--version

能正常显示版本号说明安装没问题。

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

Claude Code需要API密钥才能调用服务。我这次使用88api(https://api.88api.shop)中转服务来配置接口，主要是为了省去海外账户注册和翻墙的麻烦，国内可直连，配置也相对简单。

获取API Key（以88api为例）

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

2. 点击"添加令牌"

3. 创建令牌，输入任意名称（仅作标识），点击提交

4. 保存生成的Key（注意：Key等同于账号凭证，切勿公开分享）。

5. 点击"知道了"，在令牌列表中可以点击"复制"按钮获取 API Key

配置方式（二选一）

方法一：配置文件（推荐，永久生效）

在用户目录下创建配置文件，Claude Code会自动读取：

配置文件路径：~/.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退出编辑器。

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

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

临时生效（当前终端）：

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

永久生效：
将上述两行写入~/.bashrc或~/.zshrc（根据你使用的shell选择）：

# 编辑配置文件nano~/.bashrc# 或 ~/.zshrc# 粘贴以下内容（替换Key）exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"# 使配置生效source~/.bashrc# 或 source ~/.zshrc

⚠️注意：

• 务必将"你的API密钥"替换为实际生成的Key；
• 配置后需重启终端，若在VS Code/Cursor等IDE中使用，需重启整个IDE（仅重启终端可能不生效）。

VSCode插件配置（可选）

如果使用VSCode的Claude插件，需额外创建插件专用配置文件：

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

{"primaryApiKey":"any"}

创建步骤：

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

粘贴内容后保存退出即可。

⚠️ 注意：此文件（config.json）与Claude Code命令行工具的配置文件（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和Base URL配置是否正确（重点核对settings.json或环境变量）。

总结

这套流程从Node.js安装到API配置，全程在Linux/WSL2环境下操作，用中转服务解决了国内用户的网络和账户痛点。核心是配置文件或环境变量的正确设置，以及注意重启终端/IDE让配置生效。如果遇到连接问题，优先检查~/.claude/settings.json和~/.claude.json两个文件。按照步骤走，基本能顺畅跑通Claude Code。有其他问题欢迎在评论区交流，我会尽量回复~