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