1. Windows 裝 Claude Code 到底卡在哪從 PowerShell 報(bào)錯(cuò)說起如果你在 Windows 上搜「Claude Code 安裝」大概率會(huì)看到兩種聲音一種說一條命令就裝好了另一種說折騰一下午全是報(bào)錯(cuò)。這兩種都是真的區(qū)別只在于你有沒有提前把環(huán)境理順。Claude Code 是一個(gè)跑在終端里的 AI 編碼助手能讀你的項(xiàng)目、改代碼、跑命令適合已經(jīng)會(huì)用命令行、或者愿意花十分鐘學(xué)命令行的 Windows 10/11 用戶。它本身是 Linux-first 的工具在 Windows 上要么借 PowerShell 跑要么借 WSL2 跑路徑不同踩的坑也不同。我自己第一次裝的時(shí)候卡在irm : 無法加載文件……因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本這個(gè)報(bào)錯(cuò)上當(dāng)時(shí)以為是網(wǎng)絡(luò)問題折騰了半天才發(fā)現(xiàn)是 PowerShell 執(zhí)行策略在攔。后來幫同事裝又遇到claude : 無法識(shí)別和Requires Either Git for Windows兩個(gè)經(jīng)典問題。這些坑的共同點(diǎn)是它們跟 Claude Code 本身沒關(guān)系全是 Windows 環(huán)境配置的鍋。這篇教程的目標(biāo)很明確帶你在 Windows 上把 Claude Code 裝好并且把 API 端點(diǎn)統(tǒng)一指向 TaoToken用一條最小請(qǐng)求驗(yàn)證連通性。我會(huì)覆蓋 PowerShell 和 WSL2 兩條路徑給出可直接復(fù)制的命令和環(huán)境變量配置片段。裝完之后你的 Claude Code 請(qǐng)求會(huì)走 TaoToken 的統(tǒng)一 Key而不是默認(rèn)的官方端點(diǎn)——這對(duì)需要統(tǒng)一管理多個(gè)模型 Key 的人來說省事很多。先說清楚前置條件。你需要 Windows 10 版本 1809 以上或 Windows 11需要 GitClaude Code 在 Windows 上依賴 Git Bash 執(zhí)行 shell 命令如果用 npm 方式裝還需要 Node.js 18 以上。這三樣檢查一遍后面會(huì)順很多。打開 PowerShell開始菜單搜「PowerShell」點(diǎn)第一個(gè)依次敲[System.Environment]::OSVersion.Version git --version node --version第一條預(yù)期看到 Major 是 10 或以上第二條預(yù)期git version 2.30.0或更高沒有就去 git-scm.com 下載安裝一路 Next 即可第三條預(yù)期v18.0.0以上推薦 v22.x沒有就去 nodejs.org 下 LTS 版。如果你打算用官方原生安裝器Node.js 其實(shí)可以不裝這是我最推薦的方式。環(huán)境檢查完接下來就是安裝。安裝方式有好幾種但真正值得你花時(shí)間的就兩條路PowerShell 原生安裝器最省事和 WSL2體驗(yàn)最好。下面先講怎么把 TaoToken 的接入準(zhǔn)備好再講兩條安裝路徑的具體命令。2. TaoToken 前置準(zhǔn)備拿到統(tǒng)一 Key 和 Base URL在裝 Claude Code 之前先把 TaoToken 這邊的接入信息準(zhǔn)備好這樣裝完就能直接配不用來回切窗口。TaoToken 做的事情是把模型調(diào)用統(tǒng)一到一個(gè)入口你拿一個(gè) Key、一個(gè) Base URL就能在 Claude Code 里用。官網(wǎng)是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端點(diǎn)是 https://taotoken.net/api 。第一步注冊(cè)并登錄。打開官網(wǎng)完成賬號(hào)注冊(cè)進(jìn)入控制臺(tái)。控制臺(tái)地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 登錄后你能看到自己的賬戶概覽和用量。第二步創(chuàng)建 API Key。在控制臺(tái)里找到 API Keys 頁面地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 點(diǎn)創(chuàng)建復(fù)制生成的 Key。這個(gè) Key 通常以sk-開頭只顯示一次復(fù)制后先存到記事本里后面配置要用。注意別把它提交到 Git 倉庫也別貼在公開聊天里。第三步確認(rèn)你要用的模型 ID。Claude Code 默認(rèn)走的是 Anthropic 的模型在 TaoToken 里你需要知道對(duì)應(yīng)的模型標(biāo)識(shí)?？梢栽谀Ｐ蛯?duì)話頁面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 里先試一下對(duì)話確認(rèn)模型可用再回到 Claude Code 配置。如果你打算長(zhǎng)期用 Claude Code 做編碼和 Agent 任務(wù)可以看一下 Coding Plan 頁面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 了解套餐和額度。到這里你手上有三樣?xùn)|西Base URLhttps://taotoken.net/api、API Keysk-開頭那串、Model ID比如某個(gè) Claude 模型標(biāo)識(shí)。這三件套是后面所有配置的核心缺一不可。很多人配完發(fā)現(xiàn)請(qǐng)求失敗回頭一查就是 Model ID 寫錯(cuò)了或者 Base URL 多加了斜杠。關(guān)于 Base URL 有個(gè)細(xì)節(jié)要提醒Claude Code 走的是 Anthropic 兼容協(xié)議環(huán)境變量名是ANTHROPIC_BASE_URL值填https://taotoken.net/api不要在后面加/v1或者別的路徑除非文檔明確要求。我見過有人填成https://taotoken.net/api/v1結(jié)果一直 404排查半天。準(zhǔn)備好這三樣接下來分兩條路裝 Claude Code。如果你只想快點(diǎn)跑起來直接看 PowerShell 原生安裝器那節(jié)如果你追求更順的體驗(yàn)、愿意多花十分鐘看 WSL2 那節(jié)。兩條路最后都會(huì)匯到同一套環(huán)境變量配置上。3. 可復(fù)制配置PowerShell 與 WSL2 兩條安裝路徑這一節(jié)是全文的核心給你可以直接復(fù)制的命令和配置片段。先講 PowerShell 原生安裝器再講 WSL2最后給出統(tǒng)一的環(huán)境變量配置。3.1 PowerShell 原生安裝器最省事打開 PowerShell注意不是 CMD。先放寬當(dāng)前用戶的腳本執(zhí)行策略否則安裝腳本會(huì)被攔Set-ExecutionPolicy RemoteSigned -Scope CurrentUser系統(tǒng)會(huì)問你是否更改執(zhí)行策略輸入 Y 回車。這一步只影響當(dāng)前用戶是安全的做法不要用 Unrestricted也別改系統(tǒng)級(jí)策略。然后跑安裝命令irm https://claude.ai/install.ps1 | iex你會(huì)看到進(jìn)度條跑幾秒然后提示安裝完成。裝完后關(guān)掉當(dāng)前 PowerShell 窗口重新開一個(gè)新的驗(yàn)證claude --version預(yù)期顯示類似Claude Code v2.x.x的版本號(hào)。如果提示claude : 無法識(shí)別說明安裝目錄沒進(jìn) PATH跳到第 5 節(jié)排查。3.2 WSL2 路徑體驗(yàn)最好如果你愿意多花十分鐘WSL2 是 Windows 上跑 Claude Code 的最佳方式因?yàn)樗?Linux 原生環(huán)境文件搜索快、權(quán)限問題少。以管理員身份打開 PowerShell執(zhí)行wsl --install這會(huì)裝 WSL2 加 Ubuntu裝完重啟電腦。重啟后打開 Ubuntu開始菜單搜「Ubuntu」首次進(jìn)入會(huì)讓你創(chuàng)建用戶名和密碼。然后裝 Node.js推薦用 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node --version預(yù)期v22.x.x。接著裝 Claude Code用原生安裝器curl -fsSL https://claude.ai/install.sh | bash或者用 npmnpm install -g anthropic-ai/claude-code有個(gè)重要提醒項(xiàng)目不要放在/mnt/c/下面也就是別放在 Windows 的 C 盤里通過 WSL 訪問跨文件系統(tǒng)讀取很慢還會(huì)導(dǎo)致文件搜索漏文件。把項(xiàng)目放在/home/你的用戶名/projects/這類 Linux 文件系統(tǒng)路徑下。3.3 統(tǒng)一環(huán)境變量配置兩條路都適用裝完之后把 API 端點(diǎn)指向 TaoToken。PowerShell 里這樣設(shè)置用戶級(jí)環(huán)境變量[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, sk-你的TaoToken密鑰, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, 你的模型ID, [EnvironmentVariableTarget]::User)設(shè)置完關(guān)掉終端重新打開驗(yàn)證echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY echo $env:ANTHROPIC_MODELWSL2 里則寫進(jìn)~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密鑰 export ANTHROPIC_MODEL你的模型ID然后source ~/.bashrc生效。如果你更習(xí)慣用配置文件Claude Code 支持~/.claude/settings.json可以這樣寫{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密鑰, ANTHROPIC_MODEL: 你的模型ID } }這個(gè)文件在 Windows 上的路徑是C:\Users\你的用戶名\.claude\settings.json在 WSL2 里是~/.claude/settings.json。三件套 Base URL、Key、Model ID 一個(gè)都不能少寫錯(cuò)任何一個(gè)都會(huì)導(dǎo)致請(qǐng)求失敗。配置完進(jìn)入你的項(xiàng)目目錄啟動(dòng) Claude Codecd C:\Users\你的用戶名\projects\my-project claude第一次啟動(dòng)會(huì)問你是否認(rèn)證如果你已經(jīng)用環(huán)境變量配了 API Key它會(huì)直接走 Key 這條路。敲/status確認(rèn)狀態(tài)看 Auth 那一行是不是走的 API KeyModel 是不是你配的模型。4. 驗(yàn)證請(qǐng)求一條最小請(qǐng)求確認(rèn)連通性配置寫完不代表通了得實(shí)際發(fā)一條請(qǐng)求驗(yàn)證。這一步很多人跳過結(jié)果用的時(shí)候才發(fā)現(xiàn)報(bào)錯(cuò)回頭排查更費(fèi)勁。驗(yàn)證分兩層先確認(rèn) Claude Code 能啟動(dòng)并識(shí)別配置再發(fā)一條最小請(qǐng)求看返回。第一層啟動(dòng)后敲/status。你會(huì)看到類似這樣的輸出Account: (API Key) Auth: API Key Model: 你的模型ID Base URL: https://taotoken.net/api重點(diǎn)看 Auth 和 Base URL 兩行。如果 Auth 顯示的是訂閱賬號(hào)而不是 API Key說明你之前登錄過訂閱API Key 的優(yōu)先級(jí)雖然更高但最好確認(rèn)一下。Base URL 必須是你配的 TaoToken 地址如果顯示的是默認(rèn)官方地址說明環(huán)境變量沒生效回去檢查是不是沒重開終端。第二層發(fā)一條最小請(qǐng)求。在 Claude Code 里直接輸入一句簡(jiǎn)單的話比如幫我看看當(dāng)前目錄下有哪些文件預(yù)期它會(huì)調(diào)用工具列出文件并給出說明。如果這一步能正常返回說明從 Claude Code 到 TaoToken 的鏈路是通的。如果報(bào)錯(cuò)看第 5 節(jié)的排查對(duì)照。如果你想更直接地驗(yàn)證 API 端點(diǎn)可以用 curl 發(fā)一條最小請(qǐng)求。PowerShell 里這樣寫curl.exe -X POST https://taotoken.net/api/v1/messages -H x-api-key: sk-你的TaoToken密鑰 -H anthropic-version: 2023-06-01 -H content-type: application/json -d {\model\:\你的模型ID\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\說一句你好\}]}注意 PowerShell 里 curl 是Invoke-WebRequest的別名所以要寫curl.exe才能用真正的 curl。預(yù)期返回一段 JSON里面有content字段和模型回復(fù)的文本。如果返回 401是 Key 的問題返回 404是路徑或模型 ID 的問題返回 400多半是請(qǐng)求體格式問題。WSL2 里驗(yàn)證更簡(jiǎn)單直接用 curlcurl -X POST https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密鑰 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:你的模型ID,max_tokens:64,messages:[{role:user,content:說一句你好}]}看到正常返回就說明連通性沒問題了。這時(shí)候回到 Claude Code就可以正常干活了。建議裝完第一件事是敲/init它會(huì)分析你的項(xiàng)目生成CLAUDE.md告訴 Claude Code 你的項(xiàng)目結(jié)構(gòu)和技術(shù)棧后面所有操作都會(huì)更準(zhǔn)。這個(gè)動(dòng)作只要 30 秒但能省你后面很多來回解釋的時(shí)間。5. 常見報(bào)錯(cuò)排查401、local proxy failed、reading choices這一節(jié)把 Windows 上裝 Claude Code 配 TaoToken 最常見的幾個(gè)報(bào)錯(cuò)列出來對(duì)照著排查。每個(gè)報(bào)錯(cuò)我都寫清楚現(xiàn)象、原因和解決動(dòng)作。報(bào)錯(cuò)一401 Unauthorized 或 invalid api key現(xiàn)象是請(qǐng)求返回 401或者 Claude Code 提示認(rèn)證失敗。原因通常是 API Key 寫錯(cuò)、Key 已失效、或者環(huán)境變量沒生效。排查順序先echo $env:ANTHROPIC_API_KEY確認(rèn) Key 確實(shí)被讀到了注意有沒有多余空格或引號(hào)再去 TaoToken 控制臺(tái)的 API Keys 頁面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 確認(rèn)這個(gè) Key 還在、沒被刪最后確認(rèn)你復(fù)制的是完整的 Key沒有截?cái)?。如果都正常還是 401換一個(gè)新 Key 試試。報(bào)錯(cuò)二local proxy failed 或 connection refused現(xiàn)象是 Claude Code 報(bào)連接失敗或者提示本地代理錯(cuò)誤。這個(gè)報(bào)錯(cuò)在 Windows 上常見于兩種情況一是你之前配過系統(tǒng)代理環(huán)境變量里殘留了HTTP_PROXY或HTTPS_PROXY指向一個(gè)已經(jīng)關(guān)掉的本地端口二是防火墻攔了請(qǐng)求。排查echo $env:HTTPS_PROXY看看有沒有值如果有但你沒在用代理清掉它[Environment]::SetEnvironmentVariable(HTTPS_PROXY, $null, [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable(HTTP_PROXY, $null, [EnvironmentVariableTarget]::User)然后重開終端再試。如果確實(shí)是公司網(wǎng)絡(luò)需要代理那就把代理地址配對(duì)別留一個(gè)失效的。報(bào)錯(cuò)三reading choices 或 unexpected response format現(xiàn)象是 Claude Code 報(bào)解析響應(yīng)失敗提示 reading choices 之類。這個(gè)報(bào)錯(cuò)通常意味著請(qǐng)求發(fā)出去了但返回的格式不是 Claude Code 預(yù)期的。原因多半是 Base URL 或 Model ID 配錯(cuò)導(dǎo)致請(qǐng)求打到了不兼容的端點(diǎn)。排查確認(rèn)ANTHROPIC_BASE_URL是https://taotoken.net/api沒有多余路徑確認(rèn)ANTHROPIC_MODEL是 TaoToken 支持的模型 ID不是隨便寫的字符串?？梢匀ツＰ蛯?duì)話頁面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 先確認(rèn)這個(gè)模型能正常對(duì)話再回 Claude Code 配。報(bào)錯(cuò)四OAuth 相關(guān)報(bào)錯(cuò)或登錄循環(huán)現(xiàn)象是啟動(dòng)時(shí)反復(fù)要求登錄或者 OAuth 回調(diào)失敗。如果你用的是 API Key 方式本來就不該走 OAuth。排查確認(rèn)環(huán)境變量里ANTHROPIC_API_KEY有值且ANTHROPIC_BASE_URL指向 TaoToken。如果之前登錄過訂閱賬號(hào)Claude Code 可能緩存了登錄態(tài)可以刪掉~/.claude下的認(rèn)證緩存文件再試。API Key 的優(yōu)先級(jí)高于訂閱登錄配了 Key 就會(huì)走 Key。報(bào)錯(cuò)五claude 命令找不到現(xiàn)象是claude : 無法識(shí)別。原因是安裝目錄沒進(jìn) PATH。PowerShell 原生安裝器一般裝到C:\Users\你的用戶名\.local\binnpm 裝到C:\Users\你的用戶名\AppData\Roaming\npm。按 WinR 輸入sysdm.cpl高級(jí)、環(huán)境變量在用戶變量的 Path 里新建一條填對(duì)應(yīng)路徑確定后關(guān)掉所有終端重開。PATH 不會(huì)自動(dòng)更新到已打開的窗口這步必須做。報(bào)錯(cuò)六Requires Either Git for Windows現(xiàn)象是安裝或啟動(dòng)時(shí)報(bào)找不到 Git Bash。Claude Code 在 Windows 上需要 Git Bash 執(zhí)行 shell 命令。先git --version確認(rèn) Git 裝了如果裝了還報(bào)錯(cuò)在~/.claude/settings.json里手動(dòng)指定路徑{ env: { CLAUDE_CODE_GIT_BASH_PATH: C:\\Program Files\\Git\\bin\\bash.exe } }路徑按你實(shí)際安裝位置調(diào)整不確定就用where.exe git查Git Bash 在同級(jí)目錄的bin\bash.exe。排查完這些基本能覆蓋 Windows 上 90% 的安裝問題。如果還是不通去接入文檔 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 對(duì)照最新的配置說明或者用模型對(duì)話頁面先確認(rèn) Key 本身可用。6. 裝完之后把 TaoToken 接入長(zhǎng)期用起來裝好、驗(yàn)證通、排查完接下來就是把它用起來。這一節(jié)說幾個(gè)實(shí)際使用中的配置建議幫你少走彎路。第一把三件套固定下來。Base URL、API Key、Model ID 這三樣建議寫進(jìn)~/.claude/settings.json而不是只靠環(huán)境變量。環(huán)境變量在換終端、換 shell 的時(shí)候容易丟配置文件更穩(wěn)。Windows 上路徑是C:\Users\你的用戶名\.claude\settings.jsonWSL2 里是~/.claude/settings.json。寫進(jìn)去之后無論從哪個(gè)終端啟動(dòng) Claude Code配置都在。第二如果你同時(shí)用多個(gè) AI 編碼工具比如 Claude Code 和別的 CLITaoToken 的統(tǒng)一 Key 能讓你只維護(hù)一份憑證。不用每個(gè)工具配一套 Key換模型的時(shí)候也只需要改 Model ID。這對(duì)需要對(duì)比不同模型效果的人特別省事。想了解套餐和額度可以看 Coding Plan 頁面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。第三養(yǎng)成敲/status的習(xí)慣。每次換項(xiàng)目、換終端、或者感覺響應(yīng)不對(duì)的時(shí)候先敲一下/status確認(rèn) Auth 和 Base URL 是對(duì)的。很多「Claude Code 不好用」的抱怨其實(shí)是配置漂了請(qǐng)求根本沒走對(duì)端點(diǎn)。第四項(xiàng)目放對(duì)位置。WSL2 用戶尤其注意項(xiàng)目放 Linux 文件系統(tǒng)里別放/mnt/c/。PowerShell 用戶則注意項(xiàng)目路徑別帶中文和空格雖然現(xiàn)在支持得不錯(cuò)但偶爾還是會(huì)有工具處理路徑出問題。第五裝完先/init。這個(gè)前面提過再?gòu)?qiáng)調(diào)一次因?yàn)樗娴哪苁r(shí)間。CLAUDE.md生成后你可以手動(dòng)補(bǔ)充一些項(xiàng)目約定比如代碼風(fēng)格、測(cè)試命令、目錄結(jié)構(gòu)說明Claude Code 后續(xù)會(huì)參考這些。最后說一個(gè)實(shí)際經(jīng)驗(yàn)Windows 上裝 Claude Code最耗時(shí)間的從來不是安裝本身而是環(huán)境變量的生效和 PATH 的配置。裝完發(fā)現(xiàn)命令找不到、Key 讀不到八成是終端沒重開。記住一個(gè)原則改完環(huán)境變量或 PATH關(guān)掉所有終端窗口重新開再驗(yàn)證。這個(gè)動(dòng)作能解決大部分「明明配了卻沒用」的問題。如果你在配置過程中遇到本文沒覆蓋的報(bào)錯(cuò)可以去接入文檔 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 查最新的說明或者在模型對(duì)話頁面先確認(rèn) Key 和模型本身可用把問題范圍縮小到 Claude Code 這一層再排查。裝好之后Claude Code 配合 TaoToken 的統(tǒng)一接入日常編碼、讀項(xiàng)目、改代碼這些事就能順起來了。