前言

最近整理了這篇實操記錄，從Node.js安裝到Claude Code部署，再到國內API中轉配置，每一步都附了具體命令和路徑。我用88api作為接口中轉，解決了國內直連問題，省去了海外賬號注冊的麻煩，親測能跑通。如果你也是Windows用戶，想少踩坑快速上手，跟著步驟走應該能搞定。

一、安裝Node.js

Claude Code依賴Node.js環(huán)境，最低要求Node.js ≥18（建議用LTS版本，穩(wěn)定性更好）。

方法一：官網下載（推薦）

1. 訪問Node.js官網，下載Windows LTS版本（比如v20.x）
2. 雙擊安裝包，按向導默認安裝即可（建議勾選“Add to PATH”，自動配置環(huán)境變量）

方法二：包管理器安裝

如果習慣命令行，可用Chocolatey或Scoop安裝：

# Chocolatey
choco install nodejs
# Scoop
scoop install nodejs

驗證安裝

打開PowerShell（建議管理員模式，避免權限問題），輸入以下命令檢查版本：

node --version  # 輸出v18.x或更高
npm --version   # 輸出版本號即正常

二、安裝Claude Code

Node.js就緒后，用npm全局安裝Claude Code：

npm install -g @anthropic-ai/claude-code

安裝完成后驗證：

claude --version  # 輸出版本號即成功

三、配置API連接

前提：獲取API Key

使用Claude Code需要API Key，我這次用的是88api作為接口中轉（官網：https://api.88api.shop）。它支持國內直連，不用翻 墻和海外賬號，還能統(tǒng)一管理多個模型的Key，切換模型只需改一行配置，對國內用戶比較友好。

獲取Key的步驟：
1.注冊并登錄后，點擊側邊欄“API令牌”。

2. 點擊“添加令牌”

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

4.點擊提交

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

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

通過配置文件永久保存API信息，路徑固定：

C:\Users\<你的用戶名>\.claude\settings.json

創(chuàng)建步驟：

1. 打開文件資源管理器，進入C:\Users\<你的用戶名>\目錄（比如C:\Users\張三\）
2. 新建文件夾.claude（注意文件夾名前有個點）
3. 在.claude文件夾內新建settings.json文件，粘貼以下內容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密鑰",  // 替換為剛復制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 88api的接口地址
  }
}

方法二：環(huán)境變量（臨時/永久）

如果不想用配置文件，可通過環(huán)境變量設置（適合臨時測試）。

PowerShell臨時設置（當前會話生效）：

$env:ANTHROPIC_BASE_URL = "https://api.88api.shop"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密鑰"  # 替換為實際Key

PowerShell永久設置（用戶級，重啟后生效）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.88api.shop", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密鑰", [System.EnvironmentVariableTarget]::User)

驗證環(huán)境變量是否生效：

$env:ANTHROPIC_BASE_URL  # 輸出https://api.88api.shop
$env:ANTHROPIC_AUTH_TOKEN  # 輸出你的Key

注意：配置后需重啟終端（或IDE，如VS Code需徹底重啟）才能生效！

VSCode插件配置（可選）

如果用VSCode的Claude插件，需額外創(chuàng)建config.json文件：
路徑：C:\Users\<你的用戶名>\.claude\config.json
內容：

{
  "primaryApiKey": "any"
}

創(chuàng)建步驟和settings.json類似，在.claude文件夾內新建文件粘貼即可。

四、開始使用

配置完成后，在PowerShell中輸入：

claude

即可啟動Claude Code。輸入claude --help可查看支持的命令（比如代碼解釋、生成、優(yōu)化等）。

五、常見問題排查

問題：啟動后提示“Unable to connect to Anthropic services”

原因：首次啟動可能因引導流程未完成導致連接失敗。

解決：在用戶根目錄（C:\Users\<你的用戶名>\）創(chuàng)建.claude.json文件，內容：

{
  "hasCompletedOnboarding": true
}

保存后重啟Claude Code即可。

調試技巧：

1. 檢查網絡是否正常（國內用戶確保用中轉API，如88api）
2. 確認API Key和Base URL配置正確（對比settings.json或環(huán)境變量）
3. 重啟終端/IDE后重試

總結

本文從Node.js安裝到Claude Code部署，再到國內API中轉配置，完整覆蓋了Windows環(huán)境下的實操步驟。核心解決了兩個痛點：一是提供了清晰的Windows路徑和命令，二是通過88api中轉解決了國內直連問題。

如果按步驟操作仍有問題，建議重點檢查Node.js版本（≥18）、配置文件路徑（.claude文件夾位置）和API Key是否填對。動手試試吧，Claude Code的本地代碼輔助能力還是挺實用的，有問題歡迎留言交流~

以上就是Windows版Claude Code安裝與API對接教程(附常見問題解決)的詳細內容，更多關于Claude Code安裝與API對接的資料請關注腳本之家其它相關文章！

最新評論