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