1. Windows 上跑 ClaudeCode卡住新手的三個地方ClaudeCode 是 Anthropic 推出的命令行編程助手能在終端里直接讀寫項目文件、執(zhí)行命令、跑測試適合習(xí)慣用 CLI 干活的開發(fā)者。它本身是個 Node.js 包理論上npm install -g就能裝好但 Windows 用戶第一次上手十有八九會卡在三個地方Node.js 版本不對導(dǎo)致安裝報錯、PowerShell 執(zhí)行策略攔住了腳本、以及 API 通道沒配好導(dǎo)致啟動后一直轉(zhuǎn)圈或直接 401。我試過在一臺干凈的 Windows 11 機器上從零走一遍發(fā)現(xiàn)真正花時間的不是敲命令而是搞清楚「環(huán)境變量到底設(shè)在哪一層」「settings.json 和系統(tǒng)環(huán)境變量誰優(yōu)先」這類細節(jié)。這篇就把整個流程拆開從裝 Node.js 到寫出可復(fù)制的 settings.json再到用 PowerShell 驗證請求真的通了一步步來。你跟著做大概二十分鐘能跑起來。核心檢索詞先擺出來ClaudeCode 在 Windows 下的安裝依賴 Node.js 18通過 npm 全局安裝用 PowerShell 配置 API 通道最終靠 settings.json 或環(huán)境變量把請求指向統(tǒng)一 API 網(wǎng)關(guān)。適合誰適合想在 Windows 本地用命令行 AI 編程、又不想折騰多套 Key 的開發(fā)者。2. 前置準(zhǔn)備Node.js 環(huán)境與 TaoToken 通道2.1 Node.js 裝哪個版本、怎么裝ClaudeCode 要求 Node.js 18 或更高。我建議直接上 LTS 版本別追最新奇數(shù)版。兩種裝法官網(wǎng)下載.msi安裝包雙擊一路默認安裝向?qū)詣影裯ode和npm加進 PATH。裝完必須重開一個 PowerShell 窗口否則 PATH 不刷新敲node -v會提示找不到命令。如果你裝了 Chocolatey 或 Scoop命令行更省事# Chocolatey choco install nodejs-lts -y # 或者 Scoop scoop install nodejs-lts裝完驗證兩個命令都要有版本號輸出node --version npm --version預(yù)期類似v20.11.1和10.2.4。如果node有輸出但npm報錯多半是安裝時沒勾選 npm 組件重裝一遍即可。2.2 為什么用 TaoToken 統(tǒng)一通道ClaudeCode 默認要連 Anthropic 官方端點但很多人的實際需求是一個 Key 走多個模型、方便切換、集中看用量。TaoToken 提供統(tǒng)一的 API 通道把 ClaudeCode 的請求指向https://taotoken.net/api即可Key 在控制臺生成模型對話、編碼計劃、API Keys 都在同一套體系里管理。這里要拿兩樣?xùn)|西一個 API Key以及確認接入端點。Key 的生成入口在控制臺的 API Keys 頁面接入文檔里有完整的端點說明。先把這兩個地址記下來后面配置要用官網(wǎng)入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 端點https://taotoken.net/api注意Key 只在生成時完整顯示一次復(fù)制后先存到臨時文本里別關(guān)頁面就找不到了。3. 可復(fù)制配置settings.json 骨架與 PowerShell 權(quán)限3.1 先解決 PowerShell 執(zhí)行策略Windows 默認的執(zhí)行策略是Restricted會攔住 npm 生成的.ps1腳本表現(xiàn)就是裝 ClaudeCode 時報「無法加載文件因為在此系統(tǒng)上禁止運行腳本」。用一條命令放開當(dāng)前用戶級別Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned的意思是本地腳本可跑、遠程下載的腳本需簽名對開發(fā)場景夠用也比Unrestricted安全。執(zhí)行后輸入Y確認。驗證Get-ExecutionPolicy -Scope CurrentUser輸出RemoteSigned就對了。3.2 全局安裝 ClaudeCodenpm install -g anthropic-ai/claude-code如果這一步報permission denied或EACCES別急著用管理員權(quán)限硬剛更穩(wěn)的做法是把 npm 全局目錄改到用戶目錄下npm config set prefix $env:APPDATA\npm然后把%APPDATA%\npm加進用戶 PATH重開 PowerShell 再裝。裝完驗證claude --version有版本號輸出即安裝成功。3.3 settings.json 骨架配置ClaudeCode 讀取配置的優(yōu)先級大致是項目級.claude/settings.json 用戶級~/.claude/settings.json 系統(tǒng)環(huán)境變量。推薦用用戶級 settings.json一次配好全局生效。文件路徑在C:\Users\你的用戶名\.claude\settings.json沒有就新建。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 在這里填你的TaoToken密鑰, ANTHROPIC_MODEL: claude-sonnet-4-5 }, permissions: { allow: [ Read, Write, Bash(git status), Bash(npm run test) ] } }幾個字段說明ANTHROPIC_BASE_URL指向統(tǒng)一通道端點注意結(jié)尾不要多加/v1之類的路徑ClaudeCode 會自己拼ANTHROPIC_AUTH_TOKEN填控制臺生成的 KeyANTHROPIC_MODEL指定默認模型不寫則用內(nèi)置默認。permissions.allow是白名單把常用只讀命令和測試命令放進去減少每次彈確認。如果你更習(xí)慣用環(huán)境變量而不是 settings.jsonPowerShell 用戶級永久設(shè)置這樣寫[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, [System.EnvironmentVariableTarget]::User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, 你的TaoToken密鑰, [System.EnvironmentVariableTarget]::User)設(shè)完必須重開 PowerShell當(dāng)前窗口讀不到新變量。驗證echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN兩條都要有值輸出為空說明沒設(shè)上。4. 驗證請求確認 ClaudeCode 真的連上了配置寫完不算完得確認請求真的通。分三步驗證。第一步檢查環(huán)境變量或 settings.json 是否被讀到。在 PowerShell 里claude --version echo $env:ANTHROPIC_BASE_URL如果ANTHROPIC_BASE_URL為空但你明明寫了 settings.json說明 ClaudeCode 還沒加載到該文件檢查路徑和文件名拼寫。第二步進一個測試項目目錄啟動cd C:\path\to\your\project claude啟動后界面會顯示當(dāng)前模型和會話狀態(tài)。輸入一句簡單指令比如「列出當(dāng)前目錄的文件」觀察是否正常返回。如果卡住不動或報 401多半是 Key 無效或端點寫錯。第三步用一條最小請求直接打端點排除 ClaudeCode 本身的干擾$headers { Authorization Bearer $env:ANTHROPIC_AUTH_TOKEN Content-Type application/json } $body {model:claude-sonnet-4-5,max_tokens:50,messages:[{role:user,content:say hi}]} Invoke-RestMethod -Uri https://taotoken.net/api/v1/messages -Method Post -Headers $headers -Body $body返回里帶content字段和文本內(nèi)容說明 Key 和端點都沒問題。這一步能通、ClaudeCode 卻報錯那問題就在 ClaudeCode 的配置讀取上回頭查 settings.json 的 JSON 格式有沒有多余逗號。成功結(jié)果長這樣ClaudeCode 啟動后能正常對話執(zhí)行claude后輸入指令有響應(yīng)/model命令能切換模型。到這一步Windows 環(huán)境就算搭完了。5. 本篇常見報錯排查報錯一claude : 無法將claude項識別為 cmdlet說明 npm 全局目錄不在 PATH 里。檢查npm config get prefix的輸出路徑把該路徑加進用戶環(huán)境變量 PATH重開 PowerShell。報錯二無法加載文件 ... 因為在此系統(tǒng)上禁止運行腳本執(zhí)行策略沒放開?；氐?3.1 節(jié)跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。報錯三啟動后一直轉(zhuǎn)圈或返回 401Key 無效或端點寫錯。先用第 4 節(jié)的Invoke-RestMethod單獨測端點確認 Key 本身可用再檢查 settings.json 里ANTHROPIC_BASE_URL是否誤加了/v1后綴。報錯四settings.json 改了不生效JSON 格式錯誤會被靜默忽略。用編輯器校驗括號和逗號或者把配置臨時改成環(huán)境變量方式對比測試。另外注意項目級.claude/settings.json會覆蓋用戶級檢查項目目錄里有沒有同名文件。報錯五殺毒軟件攔截 npm 腳本部分安全軟件會誤報 npm 的.ps1腳本。把%APPDATA%\npm目錄加進白名單或臨時關(guān)閉實時防護再裝。報錯六npm install -g卡在 idealTree 不動多半是網(wǎng)絡(luò)或緩存問題。先npm cache clean --force再重試仍不行就換用npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com走鏡像源。6. 配好之后Key 管理與長期使用環(huán)境搭好后日常最常打交道的兩個入口一個是 API Keys 頁面用來生成、輪換、吊銷 Key另一個是接入文檔端點變更或新增模型時會更新在這里。如果你打算長期用 ClaudeCode 做編碼和 Agent 任務(wù)可以了解下 Coding Plan它把編碼場景的用量和模型調(diào)度打包管理比單次按量更省心。想先驗證模型效果直接進模型對話頁面發(fā)幾條指令試試確認返回質(zhì)量再決定用哪個模型做默認。一個實用習(xí)慣把ANTHROPIC_MODEL設(shè)成你常用的那個項目里再按需用/model臨時切換。Key 不要硬編碼進項目文件提交到倉庫settings.json 放在用戶目錄下、加進.gitignore的全局忽略規(guī)則里更穩(wěn)妥。