1. Windows 上跑 Claude Code為什么總在第一步卡住Claude Code 是 Anthropic 推出的命令行編程助手能在終端里直接讀寫項目文件、執(zhí)行命令、跑測試適合習(xí)慣用 CLI 干活的開發(fā)者。它本身是 Node.js 寫的理論上 Windows 也能裝但真正上手你會發(fā)現(xiàn)裝是裝上了跑起來卻各種報錯。核心原因有兩個——一是 Claude Code 內(nèi)部依賴 Git Bash 來執(zhí)行 shell 命令Windows 原生 CMD/PowerShell 的語法和它預(yù)期的不一樣二是官方 API 對國內(nèi)網(wǎng)絡(luò)和新用戶注冊都有限制登錄環(huán)節(jié)經(jīng)常直接卡死。這篇就把 Windows 下從零安裝 Claude Code 的全流程拆開講包括 Node.js 和 Git Bash 的準(zhǔn)備、三種安裝方式的取舍、settings.json 的骨架寫法以及怎么用 TaoToken 的統(tǒng)一 Key 把 API 通道接進(jìn)來。最后附一份我實際踩過的報錯清單和對應(yīng)排查命令照著走能省掉大半天折騰。適合誰看Windows 10/11 用戶、想用 Claude Code 但被環(huán)境問題勸退的人、以及需要給團(tuán)隊統(tǒng)一配置 API 通道的開發(fā)者。先說清楚一件事Claude Code 的安裝本身不復(fù)雜復(fù)雜的是環(huán)境依賴和網(wǎng)絡(luò)通道。把這兩塊理順后面就是改一個配置文件的事。2. 前置準(zhǔn)備Node.js、Git Bash 與 TaoToken 統(tǒng)一 Key2.1 Node.js 版本要求Claude Code 要求 Node.js 18 以上。裝之前先確認(rèn)版本別用系統(tǒng)里躺了三年的老版本。node -v npm -v如果版本低于 18去 Node.js 官網(wǎng)下 LTS 版重裝。裝完記得重開終端否則 PATH 不刷新。2.2 Git Bash 是硬依賴這是 Windows 上最容易忽略的一步。Claude Code 在 Windows 下會去找bash.exe找不到就直接報Claude Code on Windows requires git-bash。所以 Git for Windows 必須裝而且安裝時有個關(guān)鍵選項在安裝向?qū)У?Adjusting your PATH environment 這一步務(wù)必選Git from the command line and also from 3rd-party software。選錯的話bash命令不會進(jìn) PATHClaude Code 就找不到它。裝完驗證bash --version git --version兩條都能輸出版本號說明 Git Bash 就緒。如果你把 Git 裝到了 D 盤比如D:\git\Git記住這個路徑后面配環(huán)境變量要用。2.3 TaoToken 統(tǒng)一 Key 的作用Claude Code 默認(rèn)走 Anthropic 官方 API國內(nèi)直連基本不通而且新用戶注冊經(jīng)常被限制。TaoToken 提供的是統(tǒng)一 Key 和 API 通道你只需要在配置里把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址再用 TaoToken 生成的 Key 做鑒權(quán)Claude Code 就能正常發(fā)請求了。這樣一套 Key 可以同時給多個工具用團(tuán)隊里統(tǒng)一管理也方便。先去 TaoToken 官網(wǎng)注冊賬號然后在控制臺創(chuàng)建 API Key。地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊后在控制臺里生成 Key復(fù)制出來備用。Key 只在創(chuàng)建時完整顯示一次記得存好。3. 安裝 Claude Code 與 settings.json 配置骨架3.1 三種安裝方式怎么選npm 安裝是最穩(wěn)的推薦優(yōu)先用npm install -g anthropic-ai/claude-codewinget 方式適合喜歡用包管理器的winget install Anthropic.ClaudeCode官方 PowerShell 腳本方式irm https://claude.ai/install.ps1 | iex實測下來PowerShell 腳本方式最容易出Checksum verification failed因為下載過程中腳本可能不完整。如果你遇到這個報錯直接換 npm 方式別在腳本上耗時間。3.2 驗證安裝與 PATH 檢查裝完先看命令能不能找到claude --version如果報claude 不是內(nèi)部或外部命令說明 npm 全局路徑?jīng)]進(jìn) PATH。查一下全局路徑npm config get prefix把這個路徑比如D:\program\GlobalNpm加到系統(tǒng)環(huán)境變量 PATH 里重開終端再試。3.3 settings.json 骨架Claude Code 的配置放在用戶目錄下的.claude/settings.json。Windows 上路徑是C:\Users\你的用戶名\.claude\settings.json。如果目錄不存在就手動建。一個可用的骨架長這樣{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken_API_Key, CLAUDE_CODE_GIT_BASH_PATH: D:\\git\\Git\\bin\\bash.exe }, permissions: { allow: [], deny: [] } }幾個要點說明ANTHROPIC_BASE_URL填 TaoToken 的 API 地址https://taotoken.net/api注意這里不加 UTM 參數(shù)就是純 API 端點。ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制臺生成的 Key。CLAUDE_CODE_GIT_BASH_PATH填你實際的bash.exe完整路徑。Windows 路徑里的反斜杠在 JSON 里要寫成雙反斜杠\\否則解析會出錯。如果你 Git 裝在默認(rèn)的 C 盤這條可以省略Claude Code 會自己找。3.4 環(huán)境變量的兩種設(shè)置方式除了寫進(jìn) settings.json你也可以用系統(tǒng)環(huán)境變量。臨時設(shè)置當(dāng)前終端會話有效set ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKEN你的Key set CLAUDE_CODE_GIT_BASH_PATHD:\git\Git\bin\bash.exe claude永久設(shè)置走「系統(tǒng)屬性 → 環(huán)境變量 → 新建用戶變量」把上面三個變量名和值分別加進(jìn)去。settings.json 和環(huán)境變量同時存在時settings.json 優(yōu)先級更高建議統(tǒng)一放 settings.json 里管理換機器時復(fù)制一個文件就行。4. 驗證請求確認(rèn)通道真的通了配置寫完別急著開干先驗證 API 通道是否正常。最直接的方式是啟動 Claude Code 后發(fā)一條測試請求。cd D:\你的項目路徑 claude首次啟動如果配置正確不會再彈瀏覽器登錄而是直接進(jìn)入交互界面。輸入一句簡單的話測試你好幫我看看當(dāng)前目錄下有哪些文件如果它能正常調(diào)用工具列出文件說明 Git Bash 和 API 通道都通了。如果卡在連接階段看下一節(jié)的排查清單。另一種驗證方式是直接用 curl 打 TaoToken 的 API確認(rèn) Key 本身有效curl https://taotoken.net/api/v1/messages \ -H x-api-key: 你的Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:50,messages:[{role:user,content:ping}]}返回里有正常的 JSON 響應(yīng)說明 Key 和通道都沒問題那問題就出在 Claude Code 的本地配置上。這個區(qū)分方法很實用能幫你快速定位是通道問題還是環(huán)境問題。成功啟動后建議在項目里跑一次初始化/init它會生成.claude/CLAUDE.md文件你可以編輯這個文件寫項目規(guī)范、技術(shù)棧說明、代碼風(fēng)格要求Claude Code 每次啟動會讀它相當(dāng)于給 AI 一份項目說明書。5. 本篇常見報錯排查清單把我在 Windows 上實際遇到的坑整理成表對照現(xiàn)象找原因報錯現(xiàn)象根本原因解決方式claude 不是內(nèi)部或外部命令npm 全局路徑不在 PATHnpm config get prefix查路徑加進(jìn)系統(tǒng) PATHChecksum verification failedPowerShell 腳本下載不完整改用npm install -g anthropic-ai/claude-codeClaude Code on Windows requires git-bashGit 未裝或路徑未設(shè)設(shè)CLAUDE_CODE_GIT_BASH_PATH指向 bash.exeGit 裝在 D 盤找不到默認(rèn)路徑假設(shè)在 C 盤手動指定完整路徑注意 JSON 里用雙反斜杠Unable to connect to Anthropic servicesBASE_URL 沒指向 TaoToken檢查 settings.json 里ANTHROPIC_BASE_URL登錄時提示新用戶不可用走了官方登錄流程改用 API Key 方式配ANTHROPIC_AUTH_TOKENJSON 解析報錯路徑反斜杠沒轉(zhuǎn)義Windows 路徑寫成D:\\git\\Git\\bin\\bash.exe幾個排查技巧補充查 Git 實際安裝位置在開始菜單搜 Git Bash右鍵打開文件位置就能看到真實路徑?；蛘哂益I任意文件夾看有沒有 Open Git Bash here。確認(rèn)環(huán)境變量有沒有生效新開一個終端跑echo %ANTHROPIC_BASE_URL%能打印出你設(shè)的值就說明生效了。如果打印的是%ANTHROPIC_BASE_URL%本身說明變量沒設(shè)上。settings.json 改完一定要重啟 Claude Code它只在啟動時讀配置運行中改文件不生效。如果所有配置都對但還是連不上先用第 4 節(jié)的 curl 命令單獨測 Key把通道問題和環(huán)境問題分開排查別混在一起猜。6. 后續(xù)怎么用模型對話、Coding Plan 與接入文檔環(huán)境通了之后日常使用主要圍繞幾個入口。想快速驗證模型響應(yīng)、測試不同 prompt 效果可以直接用模型對話功能地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在網(wǎng)頁里就能試不用每次開終端。如果你打算長期用 Claude Code 做編碼或者搭 Agent 工作流建議看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它針對高頻編碼場景做了額度優(yōu)化比按量付費更劃算。Key 的管理和新建在控制臺https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以給不同項目建不同的 Key方便追蹤用量。API Key 的具體創(chuàng)建步驟看 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。完整的接入?yún)?shù)說明和更多客戶端配置示例在接入文檔里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到配置項不確定的可以對照查。最后提一個實際經(jīng)驗Windows 下這套配置最脆弱的環(huán)節(jié)是 Git Bash 路徑。換電腦或者重裝 Git 后第一件事就是確認(rèn)CLAUDE_CODE_GIT_BASH_PATH還指向正確的位置。把這個路徑記在項目 README 或者團(tuán)隊文檔里下次部署能少走很多彎路。