1. 為什么第一次裝 Claude Code 總卡在環(huán)境上Claude Code 是 Anthropic 推出的終端 AI 編程助手它跑在命令行里能直接讀寫(xiě)你本地的項(xiàng)目文件、執(zhí)行 Git 操作、跑測(cè)試命令。適合誰(shuí)適合已經(jīng)習(xí)慣用終端、想讓 AI 真正“動(dòng)手改代碼”而不是只聊天的開(kāi)發(fā)者。但它的安裝門(mén)檻不在 Claude Code 本身而在它依賴的一整條工具鏈Node.js、npm、Git缺一個(gè)都會(huì)在啟動(dòng)時(shí)報(bào)錯(cuò)。我見(jiàn)過(guò)太多人卡在第一步claude命令敲下去要么提示command not found要么彈出一堆 Node 版本不兼容的報(bào)錯(cuò)要么 Git Bash 找不到路徑。Windows 和 macOS 的坑還不一樣。這篇教程就按“先檢查環(huán)境、再全局安裝、最后配 settings.json 接入 TaoToken”的順序走一遍目標(biāo)很明確一次跑通安裝并且確認(rèn)請(qǐng)求能正常返回。核心檢索詞先擺出來(lái)Claude Code 安裝教程、Node.js、npm、Git、settings.json 配置。你跟著做每一步都有可復(fù)制的命令和預(yù)期結(jié)果。2. 裝之前先把 Node.js、npm、Git 三件套驗(yàn)一遍Claude Code 通過(guò) npm 分發(fā)npm 又跟著 Node.js 一起來(lái)所以 Node.js 是地基。Git 則是 Claude Code 執(zhí)行命令時(shí)的依賴尤其在 Windows 上它會(huì)調(diào)用 Git Bash。先別急著裝 Claude Code把這三個(gè)版本號(hào)打出來(lái)看看。打開(kāi)終端Windows 用 PowerShell 或 CMDmacOS 用 Terminal依次執(zhí)行node -v npm -v git --version預(yù)期結(jié)果類似v20.11.1 10.2.4 git version 2.43.0Node.js 建議 18 以上20 LTS 最穩(wěn)。如果node -v報(bào)“不是內(nèi)部或外部命令”說(shuō)明沒(méi)裝或沒(méi)進(jìn) PATH。Windows 可以用 winget 裝winget install OpenJS.NodeJS.LTS winget install Git.GitmacOS 用 Homebrewbrew install node brew install git裝完關(guān)掉終端重開(kāi)一次讓 PATH 生效再跑一遍上面三條驗(yàn)證命令。這一步別偷懶環(huán)境沒(méi)通后面全是玄學(xué)報(bào)錯(cuò)。注意Windows 上 Git 裝完后確認(rèn)C:\Program Files\Git\bin在系統(tǒng) PATH 里Claude Code 找 Git Bash 就靠它。3. 全局安裝 Claude Code 并確認(rèn)命令可用環(huán)境三件套都返回版本號(hào)之后全局安裝 Claude Code。命令就一行npm install -g anthropic-ai/claude-code-g是全局安裝裝完在任何目錄都能調(diào)用claude。安裝過(guò)程會(huì)拉取依賴網(wǎng)絡(luò)正常的話一兩分鐘。裝完驗(yàn)證claude --version能打印出版本號(hào)就說(shuō)明二進(jìn)制已經(jīng)就位。如果提示claude: command not found多半是 npm 全局 bin 目錄沒(méi)進(jìn) PATH。查一下全局路徑npm config get prefix把這個(gè)路徑下的binmacOS/Linux或根目錄Windows加進(jìn) PATH重開(kāi)終端再試。Windows 上還有一種情況是 PowerShell 執(zhí)行策略攔截用管理員權(quán)限跑一次Set-ExecutionPolicy RemoteSigned即可。到這一步Claude Code 本體裝好了但它還不知道該往哪個(gè) API 通道發(fā)請(qǐng)求。接下來(lái)配 settings.json。4. settings.json 接入 TaoToken 統(tǒng)一 Key 與 API 通道Claude Code 讀取配置的位置分全局和項(xiàng)目級(jí)。全局配置在用戶目錄下WindowsC:\Users\你的用戶名\.claude\settings.jsonmacOS~/.claude/settings.json沒(méi)有這個(gè)文件就手動(dòng)建。TaoToken 提供統(tǒng)一的 Key 和 API 通道把請(qǐng)求指向它即可。配置骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key } }說(shuō)明一下兩個(gè)字段ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制臺(tái)生成的 Key。Key 的獲取入口在控制臺(tái)的 API Keys 頁(yè)面先生成再?gòu)?fù)制別把 Key 提交到 Git 倉(cāng)庫(kù)里。如果你想讓某個(gè)項(xiàng)目單獨(dú)用不同配置可以在項(xiàng)目根目錄建.claude/settings.json字段結(jié)構(gòu)一樣項(xiàng)目級(jí)會(huì)覆蓋全局。改完保存Claude Code 下次啟動(dòng)就會(huì)讀取。提示settings.json 是標(biāo)準(zhǔn) JSON不能有注釋、不能有多余逗號(hào)格式錯(cuò)一行整個(gè)配置就失效。5. 發(fā)一條請(qǐng)求驗(yàn)證連通性配置寫(xiě)完進(jìn)任意一個(gè)項(xiàng)目目錄啟動(dòng)claude第一次啟動(dòng)會(huì)進(jìn)入交互界面。直接輸入一句測(cè)試比如幫我看看當(dāng)前目錄下有哪些文件如果配置正確Claude Code 會(huì)調(diào)用你配置的 API 通道返回結(jié)果并可能請(qǐng)求執(zhí)行l(wèi)s之類的命令?？吹秸；貜?fù)說(shuō)明從 Node.js 到 settings.json 整條鏈路通了。想更直接地驗(yàn)證 API 通道可以用 curl 打一次curl https://taotoken.net/api/v1/messages \ -H x-api-key: 你的TaoToken Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-3-5-sonnet-20241022,max_tokens:64,messages:[{role:user,content:ping}]}返回帶content字段的 JSON就證明 Key 和通道都沒(méi)問(wèn)題。如果返回 401檢查 Key 是否復(fù)制完整返回 404檢查 BASE_URL 有沒(méi)有多寫(xiě)或少寫(xiě)路徑。6. 安裝與接入常見(jiàn)報(bào)錯(cuò)排查報(bào)錯(cuò)一claude: command not foundnpm 全局 bin 沒(méi)進(jìn) PATH。跑npm config get prefix找到路徑加進(jìn)環(huán)境變量重開(kāi)終端。報(bào)錯(cuò)二Error: Cannot find moduleNode.js 版本過(guò)低或安裝損壞。升級(jí)到 20 LTS卸載后重裝npm install -g anthropic-ai/claude-code。報(bào)錯(cuò)三啟動(dòng)后一直轉(zhuǎn)圈或超時(shí)settings.json 里 BASE_URL 寫(xiě)錯(cuò)或者 Key 無(wú)效。用第 5 節(jié)的 curl 單獨(dú)測(cè)通道先排除配置問(wèn)題。報(bào)錯(cuò)四Windows 下提示找不到 bashGit 沒(méi)裝或 Git Bash 路徑不在 PATH。重裝 Git勾選“Add to PATH”確認(rèn)git --version能返回。報(bào)錯(cuò)五settings.json 改了不生效JSON 格式錯(cuò)誤或者改的是項(xiàng)目級(jí)但當(dāng)前目錄不對(duì)。用編輯器校驗(yàn) JSON確認(rèn)文件位置。排查順序建議先驗(yàn) Node/npm/Git 版本再驗(yàn)claude --version最后驗(yàn) API 通道。逐層排除別一上來(lái)就重裝。7. 裝完之后模型對(duì)話、Coding Plan 與文檔入口安裝跑通只是起點(diǎn)。日常想快速驗(yàn)證模型返回可以直接用模型對(duì)話頁(yè)面試 prompt不用每次開(kāi)終端。如果你打算長(zhǎng)期用 Claude Code 做編碼或搭 Agent 工作流Coding Plan 更適合按量長(zhǎng)期跑成本比單次調(diào)用可控。接入過(guò)程中遇到字段疑問(wèn)接入文檔里有完整的參數(shù)說(shuō)明Key 的管理和輪換在 API Keys 頁(yè)面操作。模型對(duì)話https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewriteCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewrite接入文檔https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewrite最后留一個(gè)實(shí)操習(xí)慣每次換機(jī)器或重裝系統(tǒng)先把第 2 節(jié)那三條版本命令跑一遍再動(dòng) Claude Code。環(huán)境這層穩(wěn)了后面 settings.json 和 Key 的問(wèn)題都好定位。