Claude Code Windows 環境配置

詳細指導如何在 Windows 系統上配置 Claude Code 開發環境,包括 Node.js 安裝、環境變數配置等。

Windows 系統要求

  • Windows 10 或更高版本
  • 系統管理員權限(用於安裝軟體)
  • 至少 2GB 可用磁碟空間

安裝 Node.js

方法一:官方安裝套件(推薦)

第一步:下載 Node.js

造訪 Node.js 官網 下載 LTS 版本的 Windows 安裝套件(.msi 檔案)

第二步:執行安裝程式

  1. 雙擊下載的 .msi 檔案
  2. 點擊 "Next" 繼續安裝
  3. 接受授權合約
  4. 選擇安裝路徑(建議使用預設路徑)
  5. 確保勾選 "Add to PATH" 選項
  6. 點擊 "Install" 開始安裝

第三步:驗證安裝

開啟命令提示字元(cmd)或 PowerShell,執行:

cmd
node --version
npm --version

方法二:使用 Chocolatey

PowerShell (系統管理員)
# 安裝 Chocolatey(如果未安裝)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# 安裝 Node.js
choco install nodejs

方法三:使用 Winget

cmd
winget install OpenJS.NodeJS

環境變數配置

臨時配置(當前工作階段有效)

set ANTHROPIC_BASE_URL=https://i7dc.com/api
set ANTHROPIC_AUTH_TOKEN=你的key
cd your-project-folder
claude

永久配置(推薦)

方法一:透過系統內容配置

  1. 右鍵點擊"本機" → "內容"
  2. 點擊"進階系統設定"
  3. 在"系統內容"視窗中點擊"環境變數"
  4. 在"使用者變數"或"系統變數"中點擊"新增"
  5. 新增以下變數:
    • 變數名稱:ANTHROPIC_BASE_URL,變數值:https://i7dc.com/api
    • 變數名稱:ANTHROPIC_AUTH_TOKEN,變數值:你的key
  6. 點擊"確定"儲存

方法二:使用 PowerShell 配置

PowerShell (系統管理員)
# 為當前使用者設定環境變數
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://i7dc.com/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的key", "User")

# 驗證設定
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

Windows Terminal 配置(推薦)

為了更好的使用體驗,建議安裝 Windows Terminal:

PowerShell
# 透過 Microsoft Store 安裝
winget install Microsoft.WindowsTerminal

# 或者透過套件管理器安裝
choco install microsoft-windows-terminal

配置 Windows Terminal 啟動 Profile

  1. 開啟 Windows Terminal
  2. 按 Ctrl + , 開啟設定
  3. 在左側選單選擇"設定檔" → "新增設定檔"
  4. 配置如下:
    • 名稱:Claude Code
    • 命令列:powershell.exe
    • 起始目錄:你的專案目錄
    • 在進階設定中新增環境變數

常見問題解決

問題 1:node 命令無法識別

解決方案:

cmd
# 檢查 PATH 環境變數
echo %PATH%

# 手動新增 Node.js 到 PATH(臨時)
set PATH=%PATH%;C:\Program Files\nodejs

問題 2:npm 安裝速度慢

解決方案:

cmd
# 使用國內鏡像源
npm config set registry https://registry.npmmirror.com

問題 3:PowerShell 執行原則限制

解決方案:

PowerShell (系統管理員)
# 臨時允許執行指令碼
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 永久設定(需要系統管理員權限)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

問題 4:防火牆阻擋連線

解決方案:

  1. 開啟 Windows 防火牆設定
  2. 點擊"允許應用程式或功能通過 Windows 防火牆"
  3. 找到 Node.js 並勾選"私人"和"公用"網路

驗證配置

配置完成後,重啟命令提示字元或 PowerShell,執行以下命令驗證:

cmd
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

如果輸出正確的環境變數值和版本資訊,說明配置成功!

下一步

環境配置完成後,你可以:

  1. 在任意專案目錄下執行 claude 開始使用
  2. 選擇你喜歡的主題
  3. 確認安全須知並信任工作目錄
  4. 開始與 AI 程式設計搭檔協作!🚀
與 AI 一起帶來無限的創新,無盡的機遇
關於
功能特性
使用文件
定價方案
聯絡我們