前言

這篇文章就帶你從0開始，在Linux/WSL2環(huán)境下完成安裝、API配置到成功啟動的Claude Code 全流程。我會用API中轉(zhuǎn)服務(wù)簡化 國內(nèi)直連，避免翻 墻和海外賬戶問題，盡量把每個步驟講清楚，讓你少踩坑。

一、準備工作：安裝Node.js

Claude Code要求Node.js版本≥18（建議LTS版），先確保環(huán)境滿足這個基礎(chǔ)要求。

方法一：官網(wǎng)下載

訪問Node.js官網(wǎng)，下載Linux二進制包或用nvm安裝（適合需要多版本管理的場景）。

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

如果用Ubuntu或Debian系統(tǒng)，直接通過包管理器安裝更方便：

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密鑰才能調(diào)用服務(wù)。我這里用了88api中轉(zhuǎn)服務(wù)（網(wǎng)址：https://api.88api.shop），主要是為了國內(nèi)直連方便，不用折騰海外賬戶和網(wǎng)絡(luò)，而且一個Key能管理多個模型，本地配置也簡單。

推薦大家可以試試，或者大家也可以用自己的。下面以88 API 為例:

1. 獲取API Key

獲取Key的步驟：

注冊并登錄后，點擊側(cè)邊欄“API令牌”。

點擊“添加令牌”

選擇分組

1. 根據(jù)需要調(diào)用的模型選擇分組
   a. claude 模型建議使用 calude code 分組、
   b. gpt 模型建議使用 codex分組
2. 可通過平臺的模型廣場查看不同模型支持的分組
3. 若在使用中出現(xiàn)上游分組飽和，請切換分組使用

4. 點擊提交

5. 點擊復(fù)制按鈕復(fù)制API令牌，也就是API KEY

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

通過配置文件永久保存API信息，比環(huán)境變量更方便管理。

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

配置內(nèi)容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密鑰",  // 替換為剛復(fù)制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中轉(zhuǎn)服務(wù)地址
  }
}

創(chuàng)建步驟：

# 創(chuàng)建.claude目錄（如果已存在可跳過）
mkdir -p ~/.claude
# 用nano編輯配置文件
nano ~/.claude/settings.json

粘貼上述配置內(nèi)容，按Ctrl+O保存，Ctrl+X退出編輯器。

3. 環(huán)境變量配置（備選方案）

如果不想用配置文件，也可以通過環(huán)境變量臨時或永久配置：

臨時設(shè)置（當(dāng)前終端生效）：

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

永久設(shè)置（全局生效）：
將以下內(nèi)容寫入~/.bashrc或~/.zshrc：

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

保存后執(zhí)行source ~/.bashrc（或?qū)?yīng)shell配置文件）使其生效。

注意：

• 務(wù)必將"你的API密鑰"替換為實際復(fù)制的Key
• 配置后需重啟終端，若用VS Code/Cursor等IDE的集成終端，需重啟整個IDE才能生效

4. VSCode插件配置（可選）

如果用VSCode的Claude插件，還需額外創(chuàng)建config.json：

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

配置內(nèi)容：

{
  "primaryApiKey": "any"
}

創(chuàng)建步驟：

# 確保.claude目錄存在
mkdir -p ~/.claude
# 編輯配置文件
nano ~/.claude/config.json

粘貼內(nèi)容后保存退出。

注意：這是VSCode插件專用配置，與命令行工具的settings.json是兩個不同文件。

四、啟動Claude Code

配置完成后，在終端輸入以下命令啟動：

claude

首次啟動可能需要確認協(xié)議，按提示操作即可。如果想查看命令說明，可執(zhí)行claude --help。

五、常見問題排查

問題1：啟動后提示「Unable to connect to Anthropic services」

癥狀：啟動Claude Code后顯示無法連接服務(wù)。
原因：首次啟動引導(dǎo)未完成。
解決方案：創(chuàng)建~/.claude.json文件跳過引導(dǎo)：

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

# 驗證文件是否創(chuàng)建成功
cat ~/.claude.json

重啟Claude Code即可。

調(diào)試小技巧

如果配置后仍無法連接，可按以下步驟排查：

1. 檢查網(wǎng)絡(luò)是否正常（國內(nèi)網(wǎng)絡(luò)需確保中轉(zhuǎn)服務(wù)可訪問）
2. 重啟終端或IDE（配置可能未生效）
3. 核對API Key和ANTHROPIC_BASE_URL是否正確

總結(jié)

這篇教程帶你在Linux/WSL2環(huán)境下完成了Claude Code的安裝、API配置和啟動，重點解決了國內(nèi)環(huán)境下的直連問題。核心在于通過API中轉(zhuǎn)服務(wù)簡化配置，避免海外賬戶和網(wǎng)絡(luò)障礙。

如果遇到連接失敗，記得檢查~/.claude/settings.json配置和~/.claude.json引導(dǎo)文件。跟著步驟操作，基本能一次跑通。

以上就是在Linux/WSL2環(huán)境下安裝和配置Claude Code的全過程的詳細內(nèi)容，更多關(guān)于Linux/WSL2安裝和配置Claude Code的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論