【配置指南】Claude Code + MiniMax
整理版優先睇
Claude Code 連 MiniMax 嘅關鍵係正確設定環境變量,尤其認證變量要用 ANTHROPIC_AUTH_TOKEN 唔係 API_KEY
呢篇文章係由嬌姐寫嘅,佢係一個持續日更 AI 乾貨嘅自媒體人,專門分享 Claude Code、OpenClaw 等工具嘅實戰經驗。文章針對嘅係第一次配置 Claude Code 接 MiniMax 時成日卡住嘅小白,核心想解決嘅問題係:點解跟足網上教程都仲係行唔到?嬌姐認為,根本原因係多數教程只教「點樣填」,冇解釋每一步背後嘅原理,所以遇到細節偏差就好易卡死。
佢嘅整體結論係:配置本質上得兩件事——第一,話畀 Claude Code 請求要發去邊度(地址);第二,話畀佢你用咩憑證證明權限(認證)。大部分失敗都離唔開地址錯、變量名錯、新變量未生效、用錯終端或者 API 本身唔通。嬌姐特別強調,認證變量一定要用 ANTHROPIC_AUTH_TOKEN,因為 MiniMax 國內節點係讀 Authorization header,唔係 x-api-key,如果用 ANTHROPIC_API_KEY 就會出 401。
文章仲提供咗一套完整嘅配置步驟同排查方法,包括用管理員 cmd 設 setx 永久變量、一定要重開終端先生效、先 echo 驗證再行 Claude Code,同埋按症狀排查嘅思路。最後俾咗一個 6 步最簡行動清單,確保第一次配置嘅人都可以成功。
- 配置核心係設定請求地址同身份憑證,搞錯認證變量名係最常見嘅死因
- 必須用管理員身份開 cmd,用 setx 設永久變量,然後關閉所有終端再開新窗先會生效
- 認證變量要用 ANTHROPIC_AUTH_TOKEN,唔係 ANTHROPIC_API_KEY,否則會不斷 401 重試
- 出現問題時按層次排查:終端類型→變量寫入→重開窗口→API 直連→Claude Code 日誌
- 最簡單嘅 6 步行動清單:管理員 cmd → 設 AUTH_TOKEN → 設 BASE_URL → 統一模模型 → 重開終端 → echo 驗證再啓動
搞清配置本質:得兩件事
Claude Code 配 MiniMax,表面上好似裝軟件,本質上只係客戶端讀取配置 → 發請求 → 服務端返回結果嘅流程。核心得兩件事:第一,話畀 Claude Code 請求要發去邊度;第二,話畀佢你用咩憑證證明自己有權限。
絕大多數失敗都離唔開地址配錯、密鑰變量名設錯、新變量冇喺當前窗口生效、終端用錯或者 API 本身唔通
一旦你理解呢個邏輯,好多問題都可以自己判斷。例如經常見到嘅反覆重試,好大機會係認證變量名錯咗,唔係網絡問題。
最容易錯嘅位:Key 變量名
好多人直覺覺得 API Key 就應該設 ANTHROPIC_API_KEY,但 MiniMax 國內節點係讀 Authorization header,所以要用 ANTHROPIC_AUTH_TOKEN。如果你設錯咗,系統唔會直接話你知,只會不斷重試,好易令人以為係網絡問題。
- 1 ANTHROPIC_API_KEY → 請求頭字段 x-api-key → 接 MiniMax 無效,會 401
- 2 ANTHROPIC_AUTH_TOKEN → 請求頭字段 Authorization → MiniMax 必須用呢個
一次過正確配置步驟
呢度係完整嘅配置步驟,建議你逐條做,確保每個環節都啱。
- 1 準備好 MiniMax API Key,確認可用、冇多餘空格
- 2 用管理員身份打開 cmd(Win + R → cmd → Ctrl + Shift + Enter)
- 3 逐條執行 setx 命令:setx ANTHROPIC_AUTH_TOKEN "你的Key";setx ANTHROPIC_BASE_URL "https://api.minimaxi.com/anthropic";setx ANTHROPIC_MODEL "MiniMax-M2.7";setx ANTHROPIC_SMALL_FAST_MODEL "MiniMax-M2.7";其餘子模型變量同樣設成 MiniMax-M2.7
- 4 關閉所有終端視窗,再開一個新 cmd
- 5 先 echo 驗證變量:echo %ANTHROPIC_AUTH_TOKEN% 等,確認輸出正確
- 6 輸入 claude 啓動,入去後打 hi,如果正常回覆就代表通咗
注意:setx 設置成功後一定要重開終端先會生效,呢個係 Windows 嘅工作方式
如果唔通,按症狀排查
當你遇到問題時,唔好亂改,先根據現象判斷問題層級。
- 現象一:一直重試 → 開 --debug 睇錯誤,優先檢查 Key、地址同變量名
- 現象二:變量明明設咗但讀唔到 → 確認用 setx 同埋有冇重開 terminal
- 現象三:懷疑 API 唔通 → 用 curl 直接測試 API,唔好盲試 Claude Code
- 現象四:PowerShell 命令表現唔同 → 返去 cmd 重做關鍵驗證
呢個判斷方法好重要:先睇終端對唔對,再睇變量有冇寫入,再睇當前窗口讀到冇,再睇 API 直連,最後先睇 Claude Code 本身
最簡行動清單
如果你而家只係想快啲搞掂,照呢 6 步做就得:
- 1 用管理員身份打開 cmd
- 2 設置 ANTHROPIC_AUTH_TOKEN(注意,唔係 API_KEY)
- 3 設置 ANTHROPIC_BASE_URL
- 4 將所有模型變量統一指向 MiniMax-M2.7
- 5 關閉所有終端,重新打開新 cmd
- 6 先 echo 驗證變量,再啓動 claude
呢 6 步做啱,絕大部分「點樣都跑唔起」嘅問題都可以繞開
先關注後閲讀,嬌姐怕失去上進嘅你
文末嬌姐整理咗 hermes、openclaw 所有文章連結
想了解嬌姐就點擊文末連結
今日呢篇係嬌姐開公眾號以嚟嘅第524篇,我係持續堅持日更分享 AI 乾貨嘅嬌姐。
好多人第一次配 Claude Code 駁 MiniMax,都以為好簡單。無非就係:攞個 API Key,填落去,跑起嚟。
但係到自己動手嗰陣,最常見嘅結果唔係「10 分鐘搞掂」,而係——命令跟住敲咗,視窗又開咗,變數又set咗,最後 Claude Code 仲喺度重複重試,或者直頭冇反應。
呢件事我後來越來越確定:新手配唔好 Claude Code,通常唔係因為佢唔認真,而係因為網上大多數教學只話俾你聽「點樣填」,冇話俾你聽「點解會錯」。一旦你唔知每一步其實係做緊乜,遇到一個細節偏差,你就會卡好耐。
所以呢篇我唔想淨係俾你一份「複製貼上清單」。我想做嘅係:將 Claude Code × MiniMax 呢套配置,講成一套你真正理解、出錯之後都知點樣排查嘅嘢。
目標:如果你係第一次接觸,我希望你睇完之後可以配置成功;如果你已經踩過坑,我希望你睇完之後知自己究竟卡喺邊。
先講結論:本質上得兩件事
Claude Code 配 MiniMax,表面上似「裝軟件」,本質上只係一次好典型嘅「用戶端讀取配置 → 發請求 → 伺服器返還結果」嘅流程,核心淨係做兩件事:
- 第一件事:
話俾 Claude Code 聽,請求要發去邊度。 - 第二件事:
話俾 Claude Code 聽,你用咩憑證證明自己有權限。
你將呢個邏輯諗清楚,後面好多問題都可以自己判斷。因為絕大多數失敗,都離唔開呢幾類:地址配錯咗、密鑰變數名set錯咗、新變數未喺當前視窗生效、終端用錯咗、或者 API 本身唔通。
一、先唔好急住配置,先搞懂你喺配置緊乜
1)cmd 同 PowerShell,到底應該用邊個?
如果你只係想穩穩陣陣做完呢件事,我嘅建議好直接:配置階段,優先揀 cmd。
原因唔係 PowerShell 唔好,而係佢「更強大」嘅同時,亦代表佢同 cmd 嘅命令行為唔完全一致。好多人卡住,唔係因為唔識敲命令,而係明明睇緊 cmd 教學,但喺 PowerShell 入面執行,結果一啲本來應該正常顯示嘅內容,因為特殊字符、變數展開方式、轉義邏輯唔同,出現完全唔一樣嘅結果。
你可以咁樣快速區分:
2)環境變數到底係乜嘢?
你可以完全將佢理解成:Windows 俾程式準備嘅一本「全局設置本」。程式啟動嘅時候,會去揭呢本簿,睇嚇自己需要咩參數。
呢度最重要嘅認知,係分清兩類變數:
- 臨時變數:
淨係喺當前終端視窗有效,關咗視窗就消失。 - 永久變數:
用 setx設定咗之後,新開嘅視窗同其他程式都讀到,重新開機之後仍然保留。
注意:setx 設定成功,唔代表當前視窗即刻讀到。你一定要熄咗當前終端,再開一個新視窗,新變數先會生效。好多人明明已經set成功,但因為冇重開視窗,以為自己又配錯咗。呢個唔係 bug,係 Windows 嘅工作方式。
3)呢套系統實際上係點樣運行起嚟?
你可以將成個過程理解成呢條鏈路:
① 你輸入訊息
喺 Claude Code 嘅互動介面輸入你嘅問題或指令。
② Claude Code 讀取環境變數
知道要請求邊個地址、帶邊個憑證。呢個就係配置嘅核心所在。
③ 發 HTTPS 請求俾 MiniMax
請求帶住你嘅身份憑證同訊息內容,發去 MiniMax 伺服器。
④ MiniMax 返還結果
AI 嘅回答經由同一條鏈路返嚟,Claude Code 顯示俾你睇。
當你知道問題喺邊一層,就唔會再陷入「我係咪全部配錯曬」嘅恐慌:
Claude Code 根本讀唔到變數 → 問題喺本地配置 變數讀到咗,但請求報 401 → 好大機會係 Key 或認證方式 請求發出咗,但服務唔通 → 地址或網絡問題
二、真正最容易搞到人卡死嘅,唔係模型名,而係 Key 變數名
呢部分係成個配置裏面最關鍵嘅一點,亦係網上好多教學最易寫得模糊嘅地方。
好多人直覺覺得,既然係 API Key,咁我應該設定 ANTHROPIC_API_KEY,聽落好合理。但問題就喺呢度:Claude Code 駁 MiniMax 國內節點嗰陣,真正應該設定嘅係 ANTHROPIC_AUTH_TOKEN,唔係前者。
ANTHROPIC_API_KEY
請求頭字段x-api-key
結論駁 MiniMax 國內節點時設呢個無效,會導致 401 反覆重試
ANTHROPIC_AUTH_TOKEN
請求頭字段Authorization(Claude Code 內部直接讀取)
正確MiniMax 國內節點必須用呢個變數名
如果你呢度set錯咗,最麻煩嘅地方唔係「系統會話俾你聽邊度錯」,而係佢成日淨係表現成:一路重試、請求失敗、似網絡問題。但根本原因,往往就係認證變數名set錯咗。
三、一次過正確配置:跟住做,但你要知自己做緊乜
第一步:準備好你嘅 MiniMax API Key
先去 MiniMax 平台拎自己嘅 API Key,確認兩件事:Key 係當前賬號下用得嘅,複製時冇帶多餘空格或者漏字符。好多後續 401,本質上根本唔係配置邏輯問題,而係 Key 本身已經唔啱。
第二步:以系統管理員身份打開 cmd
按 Win + R,輸入 cmd,按 Ctrl + Shift + Enter(以管理員身份執行)。第一次配置嗰陣,最優先追求嘅係環境穩定,呢一步唔好慳。
第三步:設定環境變數(逐行執行)
一條一條貼上,每行回車,等命令返還成功再繼續:
:: 你嘅 API Key(替換引號內嘅內容)
setx ANTHROPIC_AUTH_TOKEN "YOUR_KEY"
:: MiniMax 國內節點地址
setx ANTHROPIC_BASE_URL "https://api.minimaxi.com/anthropic"
:: 主模型
setx ANTHROPIC_MODEL "MiniMax-M2.7"
:: 內部子任務統一用同一個模型
setx ANTHROPIC_SMALL_FAST_MODEL "MiniMax-M2.7"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "MiniMax-M2.7"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "MiniMax-M2.7"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "MiniMax-M2.7"
第四步:關閉所有終端,再開一個新嘅 cmd
注意:呢條唔係建議,係必須。setx完之後,一定要重開終端。如果你唔重開,新變數就唔會喺當前視窗生效。
第五步:先驗證變數,再啟動 Claude Code
唔好一開波就直接行 Claude Code。先喺新 cmd 入面驗證:
echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%
如果輸出嘅係你頭先set好嘅值,說明本地呢一步已經生效。如果輸出係空,或者原樣印出變數名本身,說明環境變數仲未俾當前視窗讀到,先將重開視窗呢件事做啱。
第六步:啟動 Claude Code 測試
確認變數冇問題之後,輸入 claude 啟動,入去之後輸入 hi,如果 AI 正常回覆,說明成條鏈路通咗。
四、每個變數到底係做乜嘅
真正有用嘅,係以後你想換模型、換節點、換服務嗰陣,都知要改邊度。
ANTHROPIC_AUTH_TOKEN
作用你嘅身份憑證,相當於「會員卡號」
錯誤後果最常見結果係 401、反覆重試,或者完全返還唔到正常內容
ANTHROPIC_BASE_URL
作用伺服器地址,決定請求發去邊度
錯誤後果地址錯咗,就好似快遞單填錯門牌號,Key 再啱都送唔到
ANTHROPIC_MODEL
作用主模型,Claude Code 喺主要對話任務裏面優先使用呢個
Haiku / Sonnet / Opus / SmallFast 系列
作用Claude Code 內部按任務難度查唔同「默認模型槽位」
建議當前只用一個模型時,全部統一指向 MiniMax-M2.7,減少變數分歧
五、如果仲係唔通,按症狀排查
現象一:一路喺度重試
看到 Retrying in Xs · attempt N/10,說明請求已經發出咗,但未正常完成。呢個時候最有價值嘅唔係亂改,而係開 --debug 去睇具體錯誤。優先檢查:Key 係咪正確、地址係咪正確、認證變數名係咪set啱。
現象二:變數明明set咗,Claude Code 依然讀唔到
先確認兩件事:你係咪用 setx set嘅永久變數,以及你係咪重新開咗一個新嘅終端視窗。好多時候,呢一步就解決到。
現象三:懷疑唔係 Claude Code 嘅問題,而係 API 根本唔通
呢種時候唔好繼續盲目試 Claude Code,直接攞 curl 去驗證 API。如果 API 直連都唔通,喺 Claude Code 入面反覆試都唔會有結果。呢個判斷好重要,因為佢可以幫你分清楚:問題喺 Claude Code,定係問題喺底層 API / 網絡 / Key。
現象四:用咗 PowerShell,命令表現唔啱
直接返去 cmd 裏面重新做關鍵驗證。對於新手嚟講,配置階段減少變數,就係最高級嘅技巧。
六、最值得你掌握嘅,係呢套判斷方法
如果你淨係將呢篇文章當成「命令大全」,咁你下次換個服務商、換個模型名,又要重新揾教學。但如果你真正掌握咗下面呢套判斷邏輯,以後好多配置類問題你都識得自己拆:
① 先睇終端啱唔啱
確認自己用緊 cmd,唔係 PowerShell。
② 再睇變數有冇真係寫入去
用 PowerShell 嘅 GetEnvironmentVariable 命令直接查註冊表。
③ 再睇當前視窗讀唔讀到
新開視窗之後 echo 驗證,如果讀唔到就係未重開視窗。
④ 再睇 API 直連通唔通
用 curl 直接測試 API,分清楚係網絡/Key 嘅問題,定係 Claude Code 嘅問題。
⑤ 最後先睇 Claude Code 自身表現
前四層都確認冇問題,再用 --debug 睇 Claude Code 嘅詳細日誌。
呢套順序可以幫你將「我全部唔識」變成「我知道問題卡喺邊一層」。而呢個,就係技術新手真正開始變強嘅分界點。
七、俾第一次配置嘅人,最簡行動清單
如果你而家淨係想搞掂先,唔想睇曬成篇,至少跟呢 6 步做:
用管理員身份打開 cmd 設置 ANTHROPIC_AUTH_TOKEN(注意,唔係 API_KEY)設置 ANTHROPIC_BASE_URL將所有模型變數統一指向 MiniMax-M2.7 關閉所有終端,重新打開新 cmd 先 echo 驗證變數,再啟動 claude
提示:你只要將呢 6 步做啱,絕大部分「點都行唔起」嘅問題,其實都可以繞開。
我後來越來越相信一件事:好嘅教學,唔係將步驟寫得更長,而係將判斷寫得更清楚。因為真正困住人嘅,從來唔係「唔識複製命令」,而係出咗問題之後,唔知要查邊度。
如果呢篇對你有幫助,可以先收藏起嚟,等你下次換模型、換節點、或者幫人配置環境嗰陣,再返嚟對照睇。
關於微信信息嘅助手(支援羣組聊天同私訊)
微信嘅聊天記錄其實存在你電腦本地,有辦法讀取佢出嚟,經由 API 接口餵俾 AI。
有好多應用場景,將微信入面嘅聊天記錄作為你嘅數據資產
有需要嘅可以閲讀以下文章,或者私訊我搭建方案

【支援一對一諮詢】我用 hermes 搭建咗一個助手,每個人都應該用得着
關於 openclaw、hermes 資料包同系列文章
配套資料包
私信 kekohu 獲取,內容不定期持續更新。
注意:付費社羣包含資料包全部內容,唔使重複購買。
hermes 系列文章
持續更新,建議每篇認真閲讀
【唔推薦用官方命令】Windows 環境下安裝 Hermes 及遷移 Openclaw 嘅實操分享
Hermes Agent 實戰:雙模式字卡,認字 + 親子互動一張搞掂
修改呢幾個配置項,令 MiniMax 模型喺 Claude Code 中發揮到極致
【hermes 保姆教學】B站影片逐字稿自動入 obsidian 知識庫
告別生圖 API,我用 Hermes Skill 免費出圖無限次
清華大學 MAIC 團隊,GitHub 上已經 16.5k Star 嘅一個開源項目
分享我自己用緊嘅 Hermes 嘅 Obsidian skill
【保姆教學】我用 Obsidian + hermes 搭咗一個會自己整理嘅知識庫
借鑑劉小排嘅 BuilderPulse:我用 Hermes 發現值得睇嘅 github 項目
【Hermes整理】OpenClaw 變現項目地圖:6 大賽道
我將 OpenClaw 嘅 Agent 無縫遷移咗去 Hermes——就靠呢一份 Skill
借鑑 Hermes 優化 OpenClaw:令你嘅 AI 學會記、會覆盤、會巡檢
openclaw 系列文章
openclaw 系列文章
持續更新,建議每篇認真閲讀
配置與理解
唔好俾人呃,OpenClaw 可以 24 小時做嘢——但你要先做啱呢 6 件事
紅咗三個月嘅「龍蝦」,普通人裝咗真係有用咩?
用 OpenClaw 將 AI 失憶醫好:開關、精簡、外掛三步走
多 Agent 與協作
技能與工具
實戰與案例
排錯與安全
關於嬌姐
40+ IT 從業者,前榮耀員工,而家專注 AI 效率工具研究與實踐。持續輸出 OpenClaw 及 AI 工具嘅乾貨教學同落地案例,間中分享職場思考同生活感悟。
提示:覺得有用,點讚、關注、轉發,係我持續創作嘅動力。
先關注後閲讀,嬌姐怕失去上進的你
文末嬌姐整理heremes、openclaw所有文章連結
想了解嬌姐點擊文末連結
今天這篇是嬌姐開公眾號以來的第524篇,我是持續堅持日更分享AI乾貨的嬌姐。
很多人第一次配 Claude Code 接 MiniMax,都以為這事很簡單。無非就是:拿個 API Key,填進去,跑起來。
但真到自己動手時,最常見的結果不是"10 分鐘搞定",而是——命令照着敲了,窗口也開了,變量也設了,最後 Claude Code 還是在那兒反覆重試,或者乾脆沒反應。
這件事我後來越來越確定:小白配不好 Claude Code,通常不是因為他不認真,而是因為網上大多數教程只告訴你"怎麼填",沒有告訴你"為什麼會錯"。一旦你不知道每一步到底在幹嘛,遇到一個細節偏差,你就會卡很久。
所以這篇我不想只給你一份"複製粘貼清單"。我想做的是:把 Claude Code × MiniMax 這套配置,講成一套你能真正理解、出錯後也知道怎麼排查的東西。
目標:如果你是第一次接觸,我希望你看完能配成功;如果你已經踩過坑,我希望你看完能知道自己到底卡在哪。
先說結論:本質上只有兩件事
Claude Code 配 MiniMax,表面上像"裝軟件",本質上只是一次很典型的"客戶端讀取配置 → 發請求 → 服務端返回結果"的流程,核心只做兩件事:
- 第一件事:
告訴 Claude Code,請求要發到哪裏。 - 第二件事:
告訴 Claude Code,你用什麼憑證證明自己有權限。
你把這個邏輯想明白,後面很多問題都能自己判斷。因為絕大多數失敗,不外乎這幾類:地址配錯了、密鑰變量名設錯了、新變量沒在當前窗口生效、終端用錯了、或者 API 本身沒通。
一、先別急着配,先搞懂你在配置什麼
1)cmd 和 PowerShell,到底該用哪個?
如果你只是想把這件事穩穩做完,我的建議很直接:配置階段,優先用 cmd。
原因不是 PowerShell 不好,而是它"更強大"的同時,也意味着它和 cmd 的命令行為並不完全一致。很多人卡住,不是因為不會敲命令,而是明明看的是 cmd 教程,卻在 PowerShell 裏執行,結果一些本來應該正常顯示的內容,因為特殊字符、變量展開方式、轉義邏輯不同,表現出完全不一樣的結果。
你可以這樣快速區分:
2)環境變量到底是什麼?
你完全可以把它理解成:Windows 給程序準備的一本"全局設置本"。程序啓動的時候,會去翻這本本子,看自己需要什麼參數。
這裏最重要的認知,是分清兩類變量:
- 臨時變量:
只在當前終端窗口有效,關窗口即消失。 - 永久變量:
用 setx設置,新開的窗口和其他程序都能讀到,重啓後依然保留。
注意:setx 設置成功,不代表當前窗口立刻能讀到。你必須關掉當前終端,再開一個新窗口,新變量才會生效。很多人明明已經設成功了,卻因為沒重開窗口,以為自己又配錯了。這不是 bug,是 Windows 的工作方式。
3)這套系統實際是怎麼跑起來的?
你可以把整個過程理解成這條鏈路:
① 你輸入消息
在 Claude Code 的交互界面輸入你的問題或指令。
② Claude Code 讀取環境變量
知道要請求哪個地址、帶哪個憑證。這就是配置的核心所在。
③ 發 HTTPS 請求給 MiniMax
請求攜帶你的身份憑證和消息內容,發往 MiniMax 服務器。
④ MiniMax 返回結果
AI 的回答通過同一條鏈路返回,Claude Code 展示給你。
當你知道問題在哪一層,就不會再陷入"我是不是全都配錯了"的恐慌裏:
Claude Code 根本沒讀到變量 → 問題在本地配置 變量讀到了,但請求報 401 → 大概率是 Key 或認證方式 請求發出去了,但服務不通 → 地址或網絡問題
二、真正最容易把人卡死的,不是模型名,而是 Key 變量名
這部分是整個配置裏最關鍵的一點,也是網上很多教程最容易寫得模糊的地方。
很多人直覺會覺得,既然是 API Key,那我就應該設置 ANTHROPIC_API_KEY,聽起來特別合理。但問題就在這裏:Claude Code 接 MiniMax 國內節點時,真正應該設置的是 ANTHROPIC_AUTH_TOKEN,而不是前者。
ANTHROPIC_API_KEY
請求頭字段x-api-key
結論接 MiniMax 國內節點時設這個無效,會導致 401 反覆重試
ANTHROPIC_AUTH_TOKEN
請求頭字段Authorization(Claude Code 內部直接讀取)
正確MiniMax 國內節點必須用這個變量名
如果你這裏設錯了,最麻煩的地方不是"系統會告訴你哪兒錯了",而是它經常只表現成:一直重試、請求失敗、感覺像網絡問題。但根本原因,往往就是認證變量名設錯了。
三、一次性正確配置:照着做,但你要知道自己在做什麼
第一步:準備好你的 MiniMax API Key
先去 MiniMax 平台拿到自己的 API Key,確認兩件事:Key 是當前賬號下可用的,複製時沒有帶多餘空格或漏字符。很多後續 401,本質上根本不是配置邏輯問題,而是 Key 本身就不對。
第二步:用管理員身份打開 cmd
按 Win + R,輸入 cmd,按 Ctrl + Shift + Enter(以管理員身份運行)。第一次配置時,最優先追求的是環境穩定,這一步不要省。
第三步:設置環境變量(逐行執行)
一條一條粘貼,每行回車,等命令返回成功再繼續:
:: 你的 API Key(替換引號內的內容)
setx ANTHROPIC_AUTH_TOKEN "YOUR_KEY"
:: MiniMax 國內節點地址
setx ANTHROPIC_BASE_URL "https://api.minimaxi.com/anthropic"
:: 主模型
setx ANTHROPIC_MODEL "MiniMax-M2.7"
:: 內部子任務統一用同一個模型
setx ANTHROPIC_SMALL_FAST_MODEL "MiniMax-M2.7"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "MiniMax-M2.7"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "MiniMax-M2.7"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "MiniMax-M2.7"
第四步:關掉所有終端,再開一個新的 cmd
注意:這一條不是建議,是必須。設完 setx,一定要重開終端。如果你不重開,新變量就不會在當前窗口生效。
第五步:先驗證變量,再啓動 Claude Code
不要一上來就直接跑 Claude Code。先在新 cmd 裏驗證:
echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%
如果輸出的是你剛剛設置的值,說明本地這一步已經生效。如果輸出為空,或原樣打印變量名本身,說明環境變量還沒被當前窗口讀到,先把重開窗口這件事做對。
第六步:啓動 Claude Code 測試
確認變量沒問題之後,輸入 claude 啓動,進去後輸入 hi,如果 AI 正常回復,說明整條鏈路通了。
四、每個變量到底是幹什麼的
真正有用的,是以後你想換模型、換節點、換服務時,也知道該動哪裏。
ANTHROPIC_AUTH_TOKEN
作用你的身份憑證,相當於"會員卡號"
錯誤後果最常見結果是 401、反覆重試,或者完全返回不了正常內容
ANTHROPIC_BASE_URL
作用服務器地址,決定請求發去哪裏
錯誤後果地址錯了,就像快遞單填錯了門牌號,Key 再對也送不到
ANTHROPIC_MODEL
作用主模型,Claude Code 在主要對話任務裏優先使用這個
Haiku / Sonnet / Opus / SmallFast 系列
作用Claude Code 內部按任務難度查不同"默認模型槽位"
建議當前只用一個模型時,全部統一指向 MiniMax-M2.7,減少變量分歧
五、如果還是不通,按症狀排查
現象一:一直在重試
看到 Retrying in Xs · attempt N/10,說明請求已經發出去了,但沒有正常完成。這時候最有價值的不是瞎改,而是開 --debug 去看具體錯誤。優先檢查:Key 是否正確、地址是否正確、認證變量名是否設對。
現象二:變量明明設了,Claude Code 還是讀不到
先確認兩件事:你是不是用 setx 設的永久變量,以及你是不是重新開了一個新的終端窗口。很多時候,這一步就能解決。
現象三:懷疑不是 Claude Code 的問題,而是 API 根本不通
這種時候不要繼續盲測 Claude Code,直接拿 curl 去驗證 API。如果 API 直連都不通,在 Claude Code 裏反覆試也不會有結果。這個判斷非常重要,因為它能幫你分清:問題在 Claude Code,還是問題在底層 API / 網絡 / Key。
現象四:用了 PowerShell,命令表現不對
直接回到 cmd 裏重做關鍵驗證。對於小白來說,配置階段減少變量,就是最高級的技巧。
六、最值得你掌握的,是這套判斷方法
如果你只把這篇文章當成"命令大全",那你下次換個服務商、換個模型名,又得重新找教程。但如果你真正掌握了下面這套判斷邏輯,以後很多配置類問題你都能自己拆:
① 先看終端對不對
確認自己在用 cmd,而不是 PowerShell。
② 再看變量有沒有真的寫進去
用 PowerShell 的 GetEnvironmentVariable 命令直接查註冊表。
③ 再看當前窗口能不能讀到
新開窗口後 echo 驗證,如果讀不到就是沒重開窗口。
④ 再看 API 直連通不通
用 curl 直接測試 API,分清是網絡/Key 的問題,還是 Claude Code 的問題。
⑤ 最後才看 Claude Code 自身表現
前四層都確認沒問題,再用 --debug 看 Claude Code 的詳細日誌。
這套順序能幫你把"我全都不會"變成"我知道問題卡在哪一層"。而這,就是技術小白真正開始變強的那個分界點。
七、給第一次配置的人,最簡行動清單
如果你現在只想先搞定,不想先看完整篇,至少按這 6 步做:
用管理員身份打開 cmd 設置 ANTHROPIC_AUTH_TOKEN(注意,不是 API_KEY)設置 ANTHROPIC_BASE_URL把所有模型變量統一指向 MiniMax-M2.7 關閉所有終端,重新打開新 cmd 先 echo 驗證變量,再啓動 claude
提示:你只要把這 6 步做對,絕大部分"怎麼都跑不起來"的問題,其實都能繞開。
我後來越來越相信一件事:好的教程,不是把步驟寫得更長,而是把判斷寫得更清楚。因為真正把人困住的,從來不是"不會複製命令",而是出了問題以後,不知道該查哪裏。
如果這篇對你有幫助,可以先收藏起來,等你下一次換模型、換節點、或者幫別人配環境時,再回來對照看。
關於微信信息的助手(支持羣聊和私聊)
微信的聊天記錄其實存在你電腦本地,有辦法把它讀出來,通過 API 接口餵給 AI。
非常多的應用場景,把微信裏的聊天記錄作為你的數據資產
有需要的可以閲讀如下文章,或私信我搭建方案

【支持一對一諮詢】我用hermes搭建了一個助手,每個人應該用得上
關於openclaw、hermes資料包和系列文章
配套資料包
私信 kekohu 獲取,內容不定期持續更新。
注意:付費社羣包含資料包全部內容,無需重複購買。
hermes系列文章
持續更新,建議每篇認真閲讀
【不推薦用官方命令】Windows 環境下安裝Hermes及遷移Openclaw的實操分享
Hermes Agent 實戰:雙模式字卡,認字 + 親子互動一張搞定
修改這幾個配置項,讓 MiniMax 模型在 Claude Code 中發揮到極致
【hermes保姆教程】B站視頻逐字稿自動進obsidian知識庫
告別生圖 API,我用 Hermes Skill 免費出圖無限次
清華大學 MAIC 團隊,GitHub 上已經 16.5k Star的一個開源項目
分享我自己在用的Hermes 的Obsidian skill
【保姆教程】我用 Obsidian +hermes搭了一個會自己整理的知識庫
借鑑劉小排的 BuilderPulse :我用 Hermes 發現值得看的github項目
【Hermes整理】OpenClaw 變現項目地圖:6 大賽道
我把 OpenClaw 的 Agent 無縫遷移到了 Hermes——就靠這一份 Skill
借鑑 Hermes 優化 OpenClaw:讓你的 AI 學會記、會覆盤、會巡檢
openclaw系列文章
openclaw系列文章
持續更新,建議每篇認真閲讀
配置與理解
別被騙,OpenClaw 可以 24 小時幹活——但你得先做對這 6 件事
火了三個月的"龍蝦",普通人裝了真的有用嗎?
用 OpenClaw 把 AI 失憶治好:開關、精簡、外掛三步走
多 Agent 與協作
技能與工具
實戰與案例
排錯與安全
關於嬌姐
40+ IT 從業者,前榮耀員工,現專注 AI 效率工具研究與實踐。持續輸出 OpenClaw 及 AI 工具的乾貨教程與落地案例,偶爾分享職場思考與生活感悟。
提示:覺得有用,點贊、關注、轉發,是我持續創作的動力。
