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 的準備、三種安裝方式的取舍、settings.json 的骨架寫法以及怎么用 TaoToken 的統(tǒng)一 Key 把 API 通道接進來。最后附一份我實際踩過的報錯清單和對應(yīng)排查命令照著走能省掉大半天折騰。適合誰看Windows 10/11 用戶、想用 Claude Code 但被環(huán)境問題勸退的人、以及需要給團隊統(tǒng)一配置 API 通道的開發(fā)者。先說清楚一件事Claude Code 的安裝本身不復(fù)雜復(fù)雜的是環(huán)境依賴和網(wǎng)絡(luò)通道。把這兩塊理順后面就是改一個配置文件的事。2. 前置準備Node.js、Git Bash 與 TaoToken 統(tǒng)一 Key2.1 Node.js 版本要求Claude Code 要求 Node.js 18 以上。裝之前先確認版本別用系統(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命令不會進 PATHClaude Code 就找不到它。裝完驗證bash --version git --version兩條都能輸出版本號說明 Git Bash 就緒。如果你把 Git 裝到了 D 盤比如D:\git\Git記住這個路徑后面配環(huán)境變量要用。2.3 TaoToken 統(tǒng)一 Key 的作用Claude Code 默認走 Anthropic 官方 API國內(nèi)直連基本不通而且新用戶注冊經(jīng)常被限制。TaoToken 提供的是統(tǒng)一 Key 和 API 通道你只需要在配置里把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址再用 TaoToken 生成的 Key 做鑒權(quán)Claude Code 就能正常發(fā)請求了。這樣一套 Key 可以同時給多個工具用團隊里統(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)]進 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 裝在默認的 C 盤這條可以省略Claude Code 會自己找。3.4 環(huán)境變量的兩種設(shè)置方式除了寫進 settings.json你也可以用系統(tǒng)環(huán)境變量。臨時設(shè)置當前終端會話有效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)境變量 → 新建用戶變量」把上面三個變量名和值分別加進去。settings.json 和環(huán)境變量同時存在時settings.json 優(yōu)先級更高建議統(tǒng)一放 settings.json 里管理換機器時復(fù)制一個文件就行。4. 驗證請求確認通道真的通了配置寫完別急著開干先驗證 API 通道是否正常。最直接的方式是啟動 Claude Code 后發(fā)一條測試請求。cd D:\你的項目路徑 claude首次啟動如果配置正確不會再彈瀏覽器登錄而是直接進入交互界面。輸入一句簡單的話測試你好幫我看看當前目錄下有哪些文件如果它能正常調(diào)用工具列出文件說明 Git Bash 和 API 通道都通了。如果卡在連接階段看下一節(jié)的排查清單。另一種驗證方式是直接用 curl 打 TaoToken 的 API確認 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 每次啟動會讀它相當于給 AI 一份項目說明書。5. 本篇常見報錯排查清單把我在 Windows 上實際遇到的坑整理成表對照現(xiàn)象找原因報錯現(xiàn)象根本原因解決方式claude 不是內(nèi)部或外部命令npm 全局路徑不在 PATHnpm config get prefix查路徑加進系統(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 盤找不到默認路徑假設(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。確認環(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 后第一件事就是確認CLAUDE_CODE_GIT_BASH_PATH還指向正確的位置。把這個路徑記在項目 README 或者團隊文檔里下次部署能少走很多彎路。