TokiLabsDocs
系統設定

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_URLhttps://api.tokilabs.xyzClaude Code、Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-你的金鑰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
不想用指令?圖形介面設定方法
  1. 按 Win 搜尋「編輯您帳戶的環境變數」並開啟。
  2. 在「使用者變數」區域點選「新增」,依序新增上表中的兩個變數。
  3. 點選「確定」儲存,然後重新開啟終端機。

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")
}