接入

Windows 安裝和設定 Claude Code

Windows 上有兩種用法：直接在 PowerShell 裡執行，或是裝進 WSL 當 Linux 用。這一頁以原生 Windows 為主，講安裝、設定和常見問題，WSL 見最後一節。

安裝

建議：原生安裝

開啟 PowerShell（不需要系統管理員），執行：

irm https://claude.ai/install.ps1 | iex

裝好後關掉這個視窗，重新開一個 PowerShell，執行 claude --version，能印出版本號就表示裝好了。安裝程式會把 claude 所在的目錄加進使用者的 PATH，只有新開的終端機才讀得到。

或者：npm 安裝

已經裝了 Node.js 22 或更新版本的，也可以：

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

下載太慢時，可以先切到中國大陸的 npm 鏡像。兩種方式裝一種就夠了，兩種都裝會讓 claude 到底指向哪一個變得不確定。

Git for Windows（選用）

Git for Windows 在原生 Windows 上是選用的。不裝時，Claude Code 用 PowerShell 執行指令；裝了之後改用 Git Bash，Bash 工具和 Monitor 工具也要裝了 Git Bash 才能用（見官方安裝說明）。平常就在用 Git 的話，建議裝上。

裝了 Git 但 Claude Code 找不到 Git Bash 時，在 settings.json 的 env 裡用 CLAUDE_CODE_GIT_BASH_PATH 指向 bash.exe，例如 "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"（JSON 裡的反斜線要寫兩個）。

設定

方式一：寫入設定檔（建議）

在檔案總管的網址列輸入 %USERPROFILE%\.claude 開啟資料夾（沒有就新建 .claude 資料夾），用記事本或 VS Code 新建或編輯 settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://corecode.live",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的金鑰"
  }
}

儲存時編碼選 UTF-8。檔案裡已有內容的話，只要合併 env 這一段，注意逗號和引號要成對。這個檔案 PowerShell、Git Bash 和 VS Code 外掛都會讀，改一次處處生效。

方式二：環境變數

只想在目前視窗試一下：

$env:ANTHROPIC_BASE_URL = "https://corecode.live"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的金鑰"
claude

想永久生效，用 setx 寫入使用者環境變數，然後重新開啟終端機（setx 不影響已經開啟的視窗）：

setx ANTHROPIC_BASE_URL https://corecode.live
setx ANTHROPIC_AUTH_TOKEN sk-你的金鑰

不要同時設定 ANTHROPIC_API_KEY，否則會出現 Auth conflict，見錯誤排查。

檢查是否生效

claude -p "回覆 ok"

回傳 ok 就表示接通了。在 Claude Code 裡輸入 /status，可以看到 Base URL 是 https://corecode.live。

常見問題

現象	怎麼辦
`claude` 不是內部或外部命令，或 `The term 'claude' is not recognized`	重新開一個終端機再試。還是不行，檢查使用者 `PATH` 裡有沒有 Claude Code 的安裝目錄；用 npm 裝的，檢查 `npm config get prefix` 顯示的目錄在不在 `PATH` 裡。
因為這個系統上已停用指令碼執行（`running scripts is disabled on this system`）	npm 安裝產生的 `claude.ps1` 被 PowerShell 的執行原則擋住了。執行 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` 後重開終端機，或是改用原生安裝。
首次啟動出現 `Unable to connect to Anthropic services`	在 `%USERPROFILE%\.claude.json` 最外層加上 `"hasCompletedOnboarding": true`，見錯誤排查。
改了設定還在走官方，或提示 `/login`	確認 `settings.json` 在 `%USERPROFILE%\.claude\` 底下、檔名沒有被記事本加上 `.txt`，然後重開終端機。
中文亂碼	用 Windows Terminal 執行 Claude Code；設定檔儲存為 UTF-8。

VS Code 和 JetBrains

VS Code 的 Claude Code 外掛和命令列共用 %USERPROFILE%\.claude\settings.json。依照方式一寫好後，完全退出 VS Code 再開啟即可。外掛裡登入過 claude.ai 帳號的，先登出。JetBrains 外掛在 IDE 的終端機裡執行命令列版，設定方法相同。

用 WSL

已經在用 WSL 開發的人，可以把 Claude Code 裝在 WSL 裡，依 Linux 的方式安裝和設定：

curl -fsSL https://claude.ai/install.sh | bash

設定寫在 WSL 裡的 ~/.claude/settings.json，和 Windows 那邊的 %USERPROFILE%\.claude 是兩份，互不影響。專案放在 WSL 的檔案系統裡（如 ~/project），比放在 /mnt/c 底下快得多。

更多設定項和常用指令見 Claude Code 接入。