行)
1. Windows 上 Claude Code 到底卡在哪從安裝到 settings 的完整鏈路Claude Code 是 Anthropic 推出的終端編程助手能在命令行里讀代碼、改文件、跑命令、做重構(gòu)。它本身是個 npm 全局包Windows 10/11 完全能跑但初次上手的人十有八九會卡在三個地方一是 Node.js 裝完終端沒重開npm命令找不到二是 CMD 和 PowerShell 的環(huán)境變量語法混用$env:丟進 CMD 直接報「文件名、目錄名或卷標語法不正確」三是 endpoint 和鑒權(quán)沒配對啟動后一直彈登錄或者請求發(fā)出去返回 401。這篇面向 Windows 初次上手 Claude Code 的開發(fā)者把從零安裝到 settings 配置的鏈路走一遍。核心思路是不把密鑰散落在每個終端窗口里而是統(tǒng)一走 TaoToken 通道把 endpoint 和鑒權(quán)收斂到一處再接入 DeepSeek API最后開啟自動執(zhí)行模式。這樣你換項目、換終端、換模型只改一個配置文件就行。適合誰看剛在 Windows 上裝完 Node 想試 Claude Code 的人被 CMD/PowerShell 語法坑過的人想讓 Claude Code 自動執(zhí)行命令、不想每次點確認的人以及想把模型切到 DeepSeek 省錢的人。下面每一步都給可復制的命令和配置跟著敲就行。2. 前置準備Node.js、Claude Code 與 TaoToken 通道2.1 裝 Node.js 并確認 npm 可用Claude Code 依賴 Node.js 和 npm。用 Winget 裝最省事打開 CMD 或 PowerShellwinget install OpenJS.NodeJS.LTS裝完必須關(guān)掉當前終端重新開一個新窗口否則 PATH 不刷新。然后檢查node -v npm -v npx -v正常會輸出v22.x.x、10.x.x、10.x.x這樣的版本號。如果提示npm 不是內(nèi)部或外部命令先看程序位置where node where npm臨時補 PATH 可以這樣僅當前窗口有效set PATHC:\Program Files\nodejs;%APPDATA%\npm;%PATH%2.2 全局安裝 Claude Code確認 npm 能用后npm install -g anthropic-ai/claude-code claude --version能打印版本號就說明裝好了。如果claude找不到檢查全局命令目錄npm config get prefix where claudeWindows 上 npm 全局命令通常在C:\Users\你的用戶名\AppData\Roaming\npm把這個目錄加進系統(tǒng) Path 即可。2.3 為什么走 TaoToken 統(tǒng)一通道Claude Code 默認連 Anthropic 官方端點鑒權(quán)用ANTHROPIC_AUTH_TOKEN。如果你直接用官方得處理賬號和額度如果每個項目都手寫一套 endpoint密鑰就會散落在各個腳本里。TaoToken 的作用是把 endpoint 和鑒權(quán)統(tǒng)一到一個通道你只需要在 settings 里寫一次 Base URL 和 KeyClaude Code 的所有請求都走這里模型可以隨時切到 DeepSeek。先去 TaoToken 控制臺拿 Key打開 https://taotoken.net/console 在 API Keys 頁面創(chuàng)建一個新密鑰復制出來。注意別把 Key 貼進聊天記錄、截圖或 Git 倉庫。拿 Key 的入口在 https://taotoken.net/api-keys 接入文檔在 https://taotoken.net/doc 需要的話可以先在模型對話頁 https://taotoken.net/models 試一下模型通不通。3. 可復制配置settings.json 與三件套Base URL Key Model IDClaude Code 在 Windows 上讀取配置的優(yōu)先級是項目級.claude/settings.json 用戶級%USERPROFILE%\.claude\settings.json 環(huán)境變量。推薦用項目級 settings把三件套寫死在一個文件里換項目復制一份就行。3.1 項目級 settings.json 完整片段在你的項目根目錄建.claude文件夾新建settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken密鑰, ANTHROPIC_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, CLAUDE_CODE_SUBAGENT_MODEL: deepseek-v4-flash, CLAUDE_CODE_EFFORT_LEVEL: max }, permissions: { allow: [], deny: [] } }三件套對應關(guān)系Base URL 是https://taotoken.net/apiKey 是你在控制臺創(chuàng)建的那串Model ID 是deepseek-v4-pro[1m]主模型和deepseek-v4-flash子代理/輕量任務。模型名必須以 TaoToken 實際開放的列表為準寫錯會報模型不存在。3.2 用戶級 settings 與 CMD/PowerShell 環(huán)境變量如果你想讓所有項目共用一套配置寫到用戶級%USERPROFILE%\.claude\settings.json內(nèi)容同上。也可以用環(huán)境變量臨時覆蓋但要注意語法區(qū)別。CMD 用setset ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKEN你的TaoToken密鑰 set ANTHROPIC_MODELdeepseek-v4-pro[1m]PowerShell 用$env:$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN你的TaoToken密鑰 $env:ANTHROPIC_MODELdeepseek-v4-pro[1m]最容易踩的坑就是把 PowerShell 語法復制進 CMD報「文件名、目錄名或卷標語法不正確」。這不是接口問題是語法問題。3.3 開啟自動執(zhí)行Claude Code 默認在執(zhí)行命令、改文件前會反復詢問。想讓它自動執(zhí)行啟動時加參數(shù)claude --dangerously-skip-permissions或者用權(quán)限模式參數(shù)claude --permission-mode bypassPermissions這個模式會跳過 Bash、文件編輯、創(chuàng)建文件的確認。風險很實在它可能直接刪文件、覆蓋源碼、裝依賴、跑腳本。所以啟動前一定先cd進具體項目目錄別在用戶主目錄或磁盤根目錄開。先git status確認干凈必要時git add . git commit -m backup before claude code備份。4. 驗證請求啟動自檢與成功結(jié)果4.1 啟動前自檢在 CMD 里進項目目錄并檢查配置cd /d D:\Code\demo-project echo %ANTHROPIC_BASE_URL% echo %ANTHROPIC_MODEL% if defined ANTHROPIC_AUTH_TOKEN (echo AUTH_TOKEN is set) else (echo AUTH_TOKEN is not set)正常輸出https://taotoken.net/api、deepseek-v4-pro[1m]、AUTH_TOKEN is set。不要執(zhí)行echo %ANTHROPIC_AUTH_TOKEN%否則完整密鑰會打在終端和錄屏里。4.2 啟動并驗證模型響應claude進入交互界面后輸入一句簡單指令比如「讀一下當前目錄的 README用三句話總結(jié)」。如果配置正確Claude Code 會走 TaoToken 通道用 DeepSeek 模型返回結(jié)果。第一次請求可能稍慢屬于正常。想驗證自動執(zhí)行用claude --dangerously-skip-permissions然后讓它「列出當前目錄所有 .js 文件并統(tǒng)計行數(shù)」。如果它不再逐條詢問、直接執(zhí)行并返回結(jié)果說明自動執(zhí)行已生效。4.3 用模型對話頁快速驗證 Key如果啟動后一直報鑒權(quán)錯誤先別懷疑 Claude Code去 https://taotoken.net/models 用同一個 Key 發(fā)一條消息。模型對話頁能通說明 Key 和通道沒問題問題在本地配置模型對話頁也不通說明 Key 或額度有問題去控制臺檢查。5. 本篇常見錯排查401、local proxy failed、reading choices、OAuth5.1 401 鑒權(quán)失敗報錯通常是401 Unauthorized或invalid api key。原因Key 復制時帶了空格Key 已刪除或過期settings 里的ANTHROPIC_AUTH_TOKEN沒生效。排查確認 settings.json 路徑正確重啟終端用if defined檢查變量是否存在。如果 Key 曾經(jīng)公開過立刻去 https://taotoken.net/api-keys 刪舊建新。5.2 local proxy failed報錯local proxy failed或連接超時多半是 Base URL 寫錯或網(wǎng)絡到不了。確認寫的是https://taotoken.net/api不要多寫斜杠或路徑。如果公司網(wǎng)絡有出口限制換網(wǎng)絡環(huán)境再試。5.3 reading choices 報錯reading choices或cannot read property choices這類錯誤通常是返回體不是預期格式常見于模型名寫錯或通道返回了錯誤頁。檢查ANTHROPIC_MODEL是否在 TaoToken 模型列表里deepseek-v4-pro[1m]和deepseek-v4-flash要以實際開放為準。把模型名改成列表里確認存在的再試。5.4 OAuth 登錄循環(huán)配置后仍然彈 OAuth 登錄說明 Claude Code 沒讀到你的 settings。原因環(huán)境變量沒在啟動 Claude Code 的同一個終端里設(shè)置變量名拼錯終端是在設(shè)置永久變量之前打開的。解決關(guān)掉所有終端重開確認echo %ANTHROPIC_BASE_URL%有輸出再啟動。5.5 模型名無效不同通道支持的模型名不同。如果報模型不存在或無權(quán)限優(yōu)先檢查ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、CLAUDE_CODE_SUBAGENT_MODEL這五個字段全部對齊 TaoToken 的模型列表。5.6 永久保存與隱藏輸入臨時變量關(guān)窗口就失效。要長期用CMD 里用setxsetx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_MODEL deepseek-v4-pro[1m]執(zhí)行后必須關(guān)掉 CMD 重開才生效。不建議用setx永久保存 Key會長期留在用戶環(huán)境變量里。更安全的做法是每次啟動用 PowerShell 隱藏輸入$secureToken Read-Host 請輸入 API Key -AsSecureString $ptr [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secureToken) try { $env:ANTHROPIC_AUTH_TOKEN [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr) } finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr) }5.7 啟動腳本與 .gitignore可以建一個start-claude.cmd一鍵啟動echo off setlocal cd /d D:\Code\demo-project || (echo 項目目錄不存在 pause exit /b 1) set ANTHROPIC_BASE_URLhttps://taotoken.net/api set ANTHROPIC_AUTH_TOKEN你的TaoToken密鑰 set ANTHROPIC_MODELdeepseek-v4-pro[1m] echo Base URL: %ANTHROPIC_BASE_URL% if not defined ANTHROPIC_AUTH_TOKEN (echo API Key 未配置 pause exit /b 1) claude --dangerously-skip-permissions endlocal腳本里明文寫 Key 有泄露風險務必把start-claude.cmd、.env、.env.local加進.gitignore別提交到倉庫。6. 長期編碼與 Agent 場景把配置沉淀成可復用資產(chǎn)單次跑通只是開始。如果你打算長期用 Claude Code 做重構(gòu)、寫測試、跑 Agent 任務建議把配置沉淀成兩層用戶級%USERPROFILE%\.claude\settings.json放通用的 Base URL 和模型項目級.claude/settings.json只覆蓋項目特有的模型或權(quán)限。這樣新項目克隆下來復制一份.claude就能用。需要更穩(wěn)定的額度和多模型切換可以看 Coding Planhttps://taotoken.net/coding-plan 。它適合長期編碼和 Agent 場景不用每次擔心額度。接入文檔在 https://taotoken.net/doc API Keys 管理在 https://taotoken.net/api-keys 模型驗證在 https://taotoken.net/models 。Claude Code 相關(guān)的接入細節(jié)也可以參考 https://taotoken.net/claude-code 。最后提醒一句自動執(zhí)行模式權(quán)限很高務必先cd進具體項目、用 Git 做好備份、別在用戶主目錄或磁盤根目錄開。把 Key 管好把 settings 收斂到一處Windows 上跑 Claude Code 接 DeepSeek 這件事就穩(wěn)了。