1. Windows 上跑 Claude Code 和 Codex卡在哪一步如果你剛在 Windows 上裝完 Node.js興沖沖敲下npm install -g anthropic-ai/claude-code結(jié)果終端里蹦出一串紅字或者裝完了卻不知道 API Key 往哪填——這篇就是寫給你的。Claude Code 是 Anthropic 出的命令行編程助手Codex 是 OpenAI 的命令行編程工具兩者都能在終端里直接讀代碼、改文件、跑命令。它們本身不綁定某個(gè)模型服務(wù)只要給對(duì) Base URL、Key 和 Model ID就能把請(qǐng)求發(fā)到兼容的接口上。問(wèn)題在于Windows 新手最容易踩三個(gè)坑一是 Node.js 裝完沒(méi)勾 Add to Path導(dǎo)致node命令找不到二是 npm 全局安裝時(shí)權(quán)限不夠報(bào) EACCES 或 EPERM三是裝完 Claude Code 或 Codex 后不知道配置文件該放哪、環(huán)境變量該怎么寫。我見(jiàn)過(guò)太多人卡在“裝是裝上了但一運(yùn)行就提示未授權(quán)”這一步。這篇教程的目標(biāo)很明確讓你在 Windows 上從零把 Claude Code 和 Codex 裝好用 TaoToken 的統(tǒng)一 Key 和 API 地址接入最后用一條命令驗(yàn)證連通性一次跑通對(duì)話。全程不需要你懂后端也不需要你改系統(tǒng)底層設(shè)置跟著敲命令、改配置文件就行。適合誰(shuí)適合剛接觸命令行、想在 Windows 上用 AI 輔助寫代碼、但被各種配置勸退的新手。下面按順序來(lái)別跳步。2. TaoToken 統(tǒng)一 Key 與 API 地址準(zhǔn)備在裝 Claude Code 和 Codex 之前先把“鑰匙”準(zhǔn)備好。TaoToken 的作用是給你一個(gè)統(tǒng)一的 API 入口Claude Code 和 Codex 都指向同一個(gè) Base URL用同一個(gè) Key省得你分別去申請(qǐng)兩套憑證。你需要拿到三樣?xùn)|西Base URL、API Key、Model ID。Base URL 是https://taotoken.net/api注意這里不加任何多余路徑Claude Code 和 Codex 的配置里都填這個(gè)。API Key 需要你登錄 TaoToken 控制臺(tái)在 API Keys 頁(yè)面創(chuàng)建一個(gè)。創(chuàng)建時(shí)建議給 Key 起個(gè)名字比如windows-claude-code方便以后區(qū)分。創(chuàng)建完立刻復(fù)制頁(yè)面刷新后就看不全了。Model ID 根據(jù)你要用的模型來(lái)填。Claude Code 通常填 Claude 系列模型 IDCodex 填 GPT 系列或 Codex 專用模型 ID。具體可用的 Model ID 在 TaoToken 的模型列表或文檔里能查到填的時(shí)候注意大小寫和連字符別自己造名字。注意API Key 只顯示一次復(fù)制后先存到記事本里等會(huì)兒配置要用。不要把它提交到 Git 倉(cāng)庫(kù)也不要貼在公開(kāi)聊天里。如果你還沒(méi)創(chuàng)建 Key可以先去控制臺(tái)操作https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole 。創(chuàng)建完 Key 后順手把接入文檔也打開(kāi)對(duì)照著看文檔里有最新的 Base URL 和 Model ID 列表https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc 。這兩步做完前置準(zhǔn)備就齊了。3. Node.js 環(huán)境與 Claude Code/Codex 安裝配置先確認(rèn) Node.js 裝好。打開(kāi) PowerShell 或 CMD輸入node -v npm -v如果兩個(gè)都輸出版本號(hào)比如v20.11.0和10.2.4說(shuō)明環(huán)境沒(méi)問(wèn)題。如果提示“不是內(nèi)部或外部命令”說(shuō)明安裝時(shí)沒(méi)勾 Add to Path重新跑一遍 Node.js 安裝包勾上那個(gè)選項(xiàng)。Node.js 建議用 LTS 版本別用最新嘗鮮版兼容性更穩(wěn)。接著全局安裝 Claude Code 和 Codexnpm install -g anthropic-ai/claude-code npm install -g openai/codexlatest如果報(bào) EACCES 或 EPERM用管理員身份打開(kāi) PowerShell 再跑一次。裝完驗(yàn)證claude --version codex --version能輸出版本號(hào)就說(shuō)明安裝成功。接下來(lái)是配置環(huán)節(jié)Claude Code 和 Codex 的配置方式不太一樣分開(kāi)說(shuō)。Claude Code 在 Windows 上讀取用戶目錄下的配置文件。路徑是C:\Users\你的用戶名\.claude\settings.json。如果.claude文件夾不存在手動(dòng)建一個(gè)。settings.json 內(nèi)容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken API Key, ANTHROPIC_MODEL: 你的Model ID } }把你的TaoToken API Key和你的Model ID替換成實(shí)際值。注意 JSON 里不能有多余逗號(hào)字符串用雙引號(hào)。Codex 的配置在C:\Users\你的用戶名\.codex\auth.json和config.toml。auth.json 寫 Key{ OPENAI_API_KEY: 你的TaoToken API Key }config.toml 寫 Base URL 和 Model IDmodel 你的Model ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api wire_api chat這兩個(gè)文件都在.codex文件夾下沒(méi)有就新建。改完保存關(guān)掉終端重新開(kāi)一個(gè)讓配置生效。如果你用 CC Switch 這類切換工具配置邏輯一樣Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填你要用的模型。三件套缺一不可少一個(gè)都會(huì)報(bào)錯(cuò)。4. 一條命令驗(yàn)證連通性配置寫完后別急著寫代碼先驗(yàn)證能不能通。Claude Code 直接輸入claude回車后會(huì)進(jìn)入交互界面你輸入一句“你好幫我寫一個(gè) Python 的 hello world”如果能看到模型正?；貜?fù)說(shuō)明 Base URL、Key、Model ID 都對(duì)了。如果卡住或報(bào)錯(cuò)看下一節(jié)的排查。Codex 驗(yàn)證方式類似codex進(jìn)入后同樣發(fā)一句測(cè)試消息。Codex 有時(shí)會(huì)先讓你確認(rèn)工作目錄按提示操作即可。成功的話你會(huì)看到模型返回的內(nèi)容而不是 401 或連接超時(shí)。想更直接地測(cè)接口連通性可以用 curl。在 PowerShell 里跑curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的TaoToken API Key -H Content-Type: application/json -d {\model\:\你的Model ID\,\messages\:[{\role\:\user\,\content\:\test\}]}如果返回 JSON 里有choices字段和內(nèi)容說(shuō)明 Key 和地址都沒(méi)問(wèn)題。這個(gè)命令的好處是繞過(guò)了 Claude Code 和 Codex 本身直接測(cè)服務(wù)端能快速定位是配置問(wèn)題還是工具問(wèn)題。驗(yàn)證通過(guò)后你就可以在項(xiàng)目目錄里正常用 Claude Code 和 Codex 了。Claude Code 適合讀整個(gè)倉(cāng)庫(kù)、改多個(gè)文件Codex 適合快速生成代碼片段和命令。兩個(gè)都指向 TaoToken 的同一個(gè)入口Key 也是同一個(gè)管理起來(lái)省事。5. 常見(jiàn)報(bào)錯(cuò)排查401、local proxy failed、reading choices報(bào)錯(cuò)一401 Unauthorized。這是最常見(jiàn)的原因通常是 Key 填錯(cuò)、Key 過(guò)期、或者 Key 前面多了空格。檢查 settings.json 和 auth.json 里的 Key 是否和 TaoToken 控制臺(tái)里的一致。注意復(fù)制時(shí)別把換行符帶進(jìn)去。如果 Key 沒(méi)問(wèn)題檢查 Base URL 是不是https://taotoken.net/api多一個(gè)斜杠或少一個(gè)/v1都可能導(dǎo)致鑒權(quán)失敗。報(bào)錯(cuò)二local proxy failed 或 connection refused。這種一般是本地網(wǎng)絡(luò)或代理設(shè)置干擾。先確認(rèn)你沒(méi)有開(kāi)系統(tǒng)代理或者代理規(guī)則把taotoken.net攔了。在 PowerShell 里跑curl https://taotoken.net/api看能不能通。如果 curl 也失敗說(shuō)明網(wǎng)絡(luò)層有問(wèn)題檢查防火墻或 DNS。如果 curl 能通但 Claude Code 報(bào)這個(gè)錯(cuò)檢查 settings.json 里 Base URL 有沒(méi)有寫錯(cuò)比如寫成了http而不是https。報(bào)錯(cuò)三reading choices 或 cannot read property choices of undefined。這說(shuō)明請(qǐng)求發(fā)出去了但返回結(jié)構(gòu)不對(duì)。常見(jiàn)原因是 Model ID 填錯(cuò)服務(wù)端返回了錯(cuò)誤信息而不是正常的 choices 數(shù)組。去 TaoToken 文檔里核對(duì) Model ID 的準(zhǔn)確寫法注意大小寫。另一個(gè)原因是 wire_api 配置不對(duì)Codex 的 config.toml 里wire_api chat要和你用的模型匹配如果模型走的是 responses API這里要改。報(bào)錯(cuò)四OAuth 相關(guān)錯(cuò)誤比如OAuth token expired或invalid_grant。Claude Code 有時(shí)會(huì)嘗試用 OAuth 登錄但你用的是 API Key 模式不需要 OAuth。檢查 settings.json 里有沒(méi)有多余的 OAuth 配置項(xiàng)刪掉。如果 Claude Code 啟動(dòng)時(shí)強(qiáng)制走 OAuth用claude --api-key參數(shù)顯式指定 Key或者在環(huán)境變量里設(shè)ANTHROPIC_API_KEY。報(bào)錯(cuò)五npm 安裝時(shí)報(bào)EACCES或EPERM。這是 Windows 權(quán)限問(wèn)題用管理員身份打開(kāi) PowerShell 再裝。如果還不行檢查 npm 全局目錄權(quán)限或者用npm config set prefix改到一個(gè)你有寫權(quán)限的目錄。排查順序建議先 curl 測(cè)接口再檢查配置文件最后看工具版本。大部分問(wèn)題出在 Key 和 Base URL 上仔細(xì)核對(duì)這兩項(xiàng)能解決八成報(bào)錯(cuò)。6. 接入后的日常使用與 Key 管理配置跑通后日常使用就簡(jiǎn)單了。Claude Code 在項(xiàng)目根目錄輸入claude它會(huì)自動(dòng)讀取當(dāng)前目錄的代碼上下文。你可以讓它“解釋這個(gè)函數(shù)”“重構(gòu)這個(gè)文件”“寫單元測(cè)試”。Codex 輸入codex適合快速生成命令或代碼片段。兩個(gè)工具都走 TaoToken 的同一個(gè) Key額度是共享的所以別同時(shí)跑太多大任務(wù)。Key 管理方面建議在 TaoToken 控制臺(tái)里給不同的工具創(chuàng)建不同的 Key比如claude-code-win和codex-win。這樣萬(wàn)一某個(gè) Key 泄露可以單獨(dú)禁用不影響另一個(gè)。控制臺(tái)里還能看每個(gè) Key 的用量方便你控制額度。如果團(tuán)隊(duì)多人用每人一個(gè) Key別共用。長(zhǎng)期編碼或跑 Agent 任務(wù)的話可以考慮 Coding Plan額度更充裕適合高頻使用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan 。如果只是想先試試模型對(duì)話效果用模型對(duì)話頁(yè)面快速驗(yàn)證https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel 。需要管理多個(gè) Key 或查看用量去 API Keys 頁(yè)面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys 。最后提醒一句配置文件改完一定要重啟終端環(huán)境變量和 JSON 配置不會(huì)熱加載。如果換了 Model ID也要重啟工具。Windows 上路徑里的反斜杠和正斜杠在 JSON 里統(tǒng)一用正斜杠或雙反斜杠別寫單反斜杠否則 JSON 解析會(huì)報(bào)錯(cuò)。按這個(gè)流程走基本能一次跑通。