系統設定
Windows 設定指南
適用於 Windows 10 / 11。全程在 PowerShell 中完成,不需要系統管理員權限。
一組金鑰即可呼叫所有模型。金鑰只儲存在你自己的瀏覽器中,不會上傳到任何伺服器。
還沒有金鑰?請先到 取得 API 金鑰 建立一組。
1. 開啟終端機
按 Win + X,選擇「終端機」或「Windows PowerShell」。下文所有指令都在 PowerShell 中執行,不要使用舊的 cmd 視窗。
2. 安裝 Node.js
Claude Code 需要 Node.js 18 以上版本;在 Windows 上還需要 Git for Windows(提供 Git Bash)。使用系統內建的 winget 安裝:
PowerShell
winget install OpenJS.NodeJS.LTS
winget install Git.Git安裝完成後關閉並重新開啟終端機,確認版本:
PowerShell
node -v
git --version如果執行
npm 時出現「此系統上已停用指令碼執行」,執行一次 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 並輸入 Y 確認即可。3. 設定環境變數
設定下面兩個變數,介面網址為 https://api.tokilabs.xyz。
| 變數名稱 | 值 | 用途 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.tokilabs.xyz | Claude Code、Anthropic SDK |
ANTHROPIC_AUTH_TOKEN | sk-你的金鑰 | Claude Code |
PowerShell
# 寫入「使用者環境變數」,永久生效(不需要系統管理員權限)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.tokilabs.xyz", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的金鑰", "User")檢查是否生效
指令執行後,關閉所有終端機視窗和 VS Code 再重新開啟,新變數才會生效。用下面的指令檢查:
PowerShell
$env:ANTHROPIC_BASE_URL不想用指令?圖形介面設定方法
- 按 Win 搜尋「編輯您帳戶的環境變數」並開啟。
- 在「使用者變數」區域點選「新增」,依序新增上表中的兩個變數。
- 點選「確定」儲存,然後重新開啟終端機。
4. 驗證連線
回傳一段包含 "data" 的 JSON 模型列表,就表示網址和金鑰都沒問題。
PowerShell
# 注意:PowerShell 裡要寫 curl.exe,只寫 curl 會呼叫 Invoke-WebRequest
curl.exe "$env:ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $env:ANTHROPIC_AUTH_TOKEN"回傳
401 表示金鑰錯誤或已失效;連線逾時請檢查本機的 Proxy 設定,參見 常見問題。5. 安裝 Claude Code
PowerShell · 官方安裝指令碼
irm https://claude.ai/install.ps1 | iex或者使用 npm 安裝:
PowerShell · npm
npm install -g @anthropic-ai/claude-code略過首次啟動時的官方帳號登入引導:
PowerShell
# 僅在檔案不存在時建立,避免覆寫既有設定
if (!(Test-Path "$HOME\.claude.json")) {
[IO.File]::WriteAllText("$HOME\.claude.json", '{"hasCompletedOnboarding": true}')
}進入專案目錄啟動:
PowerShell
cd 你的專案目錄
claude啟動後輸入 /status,看到 Base URL 為 https://api.tokilabs.xyz 即表示已經過 Toki Labs 介面。輸入 /model 可切換模型,例如 claude-opus-5-5。更多設定請見 Claude Code 詳細設定。
使用 WSL
如果你在 WSL(Windows Subsystem for Linux)中開發,請在 WSL 終端機中依照 Linux 設定指南 操作。WSL 與 Windows 的環境變數彼此獨立,需要分別設定。
還原設定
不再使用時,刪除這些環境變數即可恢復預設:
PowerShell
foreach ($n in "ANTHROPIC_BASE_URL","ANTHROPIC_AUTH_TOKEN") {
[Environment]::SetEnvironmentVariable($n, $null, "User")
}