【配置指南】Claude Code + MiniMax

作者:嬌姐話AI圈
日期:2026年5月13日 下午2:49
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

Claude CodeMiniMax 嘅關鍵係正確設定環境變量,尤其認證變量要用 ANTHROPIC_AUTH_TOKEN 唔係 API_KEY

整理版摘要

呢篇文章係由嬌姐寫嘅,佢係一個持續日更 AI 乾貨嘅自媒體人,專門分享 Claude CodeOpenClaw 等工具嘅實戰經驗。文章針對嘅係第一次配置 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 CodeMiniMax,表面上好似裝軟件,本質上只係客戶端讀取配置 → 發請求 → 服務端返回結果嘅流程。核心得兩件事:第一,話畀 Claude Code 請求要發去邊度;第二,話畀佢你用咩憑證證明自己有權限。

絕大多數失敗都離唔開地址配錯、密鑰變量名設錯、新變量冇喺當前窗口生效、終端用錯或者 API 本身唔通

一旦你理解呢個邏輯,好多問題都可以自己判斷。例如經常見到嘅反覆重試,好大機會係認證變量名錯咗,唔係網絡問題。

整理重點

最容易錯嘅位:Key 變量名

好多人直覺覺得 API Key 就應該設 ANTHROPIC_API_KEY,但 MiniMax 國內節點係讀 Authorization header,所以要用 ANTHROPIC_AUTH_TOKEN。如果你設錯咗,系統唔會直接話你知,只會不斷重試,好易令人以為係網絡問題。

  1. 1 ANTHROPIC_API_KEY → 請求頭字段 x-api-key → 接 MiniMax 無效,會 401
  2. 2 ANTHROPIC_AUTH_TOKEN → 請求頭字段 AuthorizationMiniMax 必須用呢個
整理重點

一次過正確配置步驟

呢度係完整嘅配置步驟,建議你逐條做,確保每個環節都啱。

  1. 1 準備好 MiniMax API Key,確認可用、冇多餘空格
  2. 2 用管理員身份打開 cmd(Win + R → cmd → Ctrl + Shift + Enter
  3. 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. 4 關閉所有終端視窗,再開一個新 cmd
  5. 5 先 echo 驗證變量:echo %ANTHROPIC_AUTH_TOKEN% 等,確認輸出正確
  6. 6 輸入 claude 啓動,入去後打 hi,如果正常回覆就代表通咗

注意:setx 設置成功後一定要重開終端先會生效,呢個係 Windows 嘅工作方式

整理重點

如果唔通,按症狀排查

當你遇到問題時,唔好亂改,先根據現象判斷問題層級。

  • 現象一:一直重試 → 開 --debug 睇錯誤,優先檢查 Key、地址同變量名
  • 現象二:變量明明設咗但讀唔到 → 確認用 setx 同埋有冇重開 terminal
  • 現象三:懷疑 API 唔通 → 用 curl 直接測試 API,唔好盲試 Claude Code
  • 現象四PowerShell 命令表現唔同 → 返去 cmd 重做關鍵驗證

呢個判斷方法好重要:先睇終端對唔對,再睇變量有冇寫入,再睇當前窗口讀到冇,再睇 API 直連,最後先睇 Claude Code 本身

整理重點

最簡行動清單

如果你而家只係想快啲搞掂,照呢 6 步做就得:

  1. 1 用管理員身份打開 cmd
  2. 2 設置 ANTHROPIC_AUTH_TOKEN(注意,唔係 API_KEY)
  3. 3 設置 ANTHROPIC_BASE_URL
  4. 4 將所有模型變量統一指向 MiniMax-M2.7
  5. 5 關閉所有終端,重新打開新 cmd
  6. 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 入面執行,結果一啲本來應該正常顯示嘅內容,因為特殊字符、變數展開方式、轉義邏輯唔同,出現完全唔一樣嘅結果。

你可以咁樣快速區分:

終端
提示符樣式
cmd(推薦配置用)
C:\Users\你嘅用戶名>
PowerShell(開頭有 PS)
PS C:\Users\你嘅用戶名>

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 步做:

  1. 用管理員身份打開 cmd
  2. 設置 ANTHROPIC_AUTH_TOKEN(注意,唔係 API_KEY)
  3. 設置 ANTHROPIC_BASE_URL
  4. 將所有模型變數統一指向 MiniMax-M2.7
  5. 關閉所有終端,重新打開新 cmd
  6. 先 echo 驗證變數,再啟動 claude

提示:你只要將呢 6 步做啱,絕大部分「點都行唔起」嘅問題,其實都可以繞開。


我後來越來越相信一件事:好嘅教學,唔係將步驟寫得更長,而係將判斷寫得更清楚。因為真正困住人嘅,從來唔係「唔識複製命令」,而係出咗問題之後,唔知要查邊度。

如果呢篇對你有幫助,可以先收藏起嚟,等你下次換模型、換節點、或者幫人配置環境嗰陣,再返嚟對照睇。


關於微信信息嘅助手(支援羣組聊天同私訊)

微信嘅聊天記錄其實存在你電腦本地,有辦法讀取佢出嚟,經由 API 接口餵俾 AI。

有好多應用場景,將微信入面嘅聊天記錄作為你嘅數據資產

有需要嘅可以閲讀以下文章,或者私訊我搭建方案

圖片


五一唔好再碌羣組訊息啦

【支援一對一諮詢】我用 hermes 搭建咗一個助手,每個人都應該用得着

關於 openclaw、hermes 資料包同系列文章

配套資料包

私信 kekohu 獲取,內容不定期持續更新。

選項
內容
價格
資料包
《入門到精通》+《102個實戰案例》+《避坑手冊》+《數百 skill 技能包》+《AI日報》,付款後即發飛書權限
69元
付費社羣
包含上述全套資料包 + 羣組內實操答疑 + 不定期乾貨分享 + 同行交流
99 元

注意:付費社羣包含資料包全部內容,唔使重複購買。

hermes 系列文章

持續更新,建議每篇認真閲讀

【唔推薦用官方命令】Windows 環境下安裝 Hermes 及遷移 Openclaw 嘅實操分享

Hermes Agent 實戰:雙模式字卡,認字 + 親子互動一張搞掂

【家長老師收藏】AI輔助學習全科提示詞寶典

修改呢幾個配置項,令 MiniMax 模型喺 Claude Code 中發揮到極致

【hermes 保姆教學】B站影片逐字稿自動入 obsidian 知識庫

告別生圖 API,我用 Hermes Skill 免費出圖無限次

清華大學 MAIC 團隊,GitHub 上已經 16.5k Star 嘅一個開源項目

分享我自己用緊嘅 Hermes 嘅 Obsidian skill

【保姆教學】我用 Obsidian + hermes 搭咗一個會自己整理嘅知識庫

借鑑劉小排嘅 BuilderPulse:我用 Hermes 發現值得睇嘅 github 項目

Hermes 入門到實操中文文檔

【Hermes整理】OpenClaw 變現項目地圖:6 大賽道

Hermes 裝好之後,我最建議先做嘅 8 個實操動作

我將 OpenClaw 嘅 Agent 無縫遷移咗去 Hermes——就靠呢一份 Skill

借鑑 Hermes 優化 OpenClaw:令你嘅 AI 學會記、會覆盤、會巡檢

openclaw 系列文章

持續更新,建議每篇認真閲讀

配置與理解

徹底搞懂 OpenClaw 配置體系:呢個先係 AI Agent 嘅正確打開方式
【支援一對一諮詢】我用 hermes 搭建咗一個助手,每個人都應該用得着
【唔推薦用官方命令】Windows 環境下安裝 Hermes 及遷移 Openclaw 嘅實操分享
我嘅個人成長助手 Agent 罷工咗,Claude max 定位總結嘅呢幾點分享俾大家
【今日唔講 STBI 測試】我用 OpenClaw 搭咗一個自動抓多個公眾號、AI整理、發飛書嘅 Agent,核心就係呢四步
OpenClaw openclaw.json 全量小白教學:一篇講清楚每個配置項嘅作用
你喺飛書或者微信打咗句「你好」,OpenClaw 到底用咗幾多 Token?
詳細指南 微信插件支援 OpenClaw
OpenClaw 龍蝦如何自我糾錯 5步自我迭代法
【網友話靚到爆】我讓 openclaw 開發咗一個屬於自己嘅互動式說明書

唔好俾人呃,OpenClaw 可以 24 小時做嘢——但你要先做啱呢 6 件事

紅咗三個月嘅「龍蝦」,普通人裝咗真係有用咩?

用 OpenClaw 將 AI 失憶醫好:開關、精簡、外掛三步走

OpenClaw 命令完整手冊
OpenClaw 到底點樣行?部署方式與玩法全景
如何申請 Brave Search API 密鑰並配置 OpenClaw
用大白話講清楚 OpenClaw 嘅記憶術
OpenClaw 長任務必讀:用 Sub-Agent 隔離上文下理,token 消耗降 85%
OpenClaw 慳 Token 實操手冊:八個維度,節省 60–90%
OpenClaw 曲線救國:經由 CLI 後端使用 Claude 模型
飛書同 openclaw 集成實操教學
【呢篇文係 openclaw 輸出】OpenClaw 超簡單且免費嘅安裝實操教學

多 Agent 與協作

OpenClaw 多 Agent 協作實戰完全教學
OpenClaw 多代理配置指南:讓 AI 團隊幫你同時做幾件事

技能與工具

OpenClaw 官方 53 個技能完整指南:功能詳解 + 風險評估 + 安裝建議
【GitHub Skill 】 OpenClaw 多 Agent 交付俾客戶嘅流程 Skill
呢個 Skill 太適合「小白偷懶式」情報蒐集:唔使 API Key,直接將 Reddit 變成你嘅選題庫
【免費領取】7套唔同賽道風格公眾號排版 Skill(有效果圖)
12 類人士必裝嘅 OpenClaw Skills
唔寫 code,點樣令 OpenClaw Agent 學識新技能

實戰與案例

本地部署 OpenClaw 自動發佈公眾號:小白完整教學
本地部署 OpenClaw 自動發佈小紅書:小白完整教學
我用 OpenClaw,將小朋友嘅學習情況整理成可以長期追蹤嘅學情檔案
【實操分享】OpenClaw 多文檔多輸入源筆記整理 Agent 搭建
【保姆教學】OpenClaw 作業錯題分析師,每個家長都可以學起嚟
OpenClaw 完全指南:從零搭建你嘅 AI 員工團隊
睇嚇呢個龍蝦速度,就知道呢個 OpenClaw 有幾火爆,速度跟上去
OpenClaw 完全指南:從零搭建你嘅 AI 員工團隊
OpenClaw 實戰:從0到1搭建你嘅雲端 AI 工作流程
我嘅 OpenClaw 多 Agent 會主動 send 嚟「返工打卡」
OpenClaw 實戰操作指南:12 大熱門應用案例詳細教學
我嘅 openclaw 龍蝦開始自己賺錢喇
用咗 openclaw,同 telegram 可以雙向通訊喇

排錯與安全

OpenClaw 排錯指南
OpenClaw 龍蝦玩家嘅安全指南

關於嬌姐

40+ IT 從業者,前榮耀員工,而家專注 AI 效率工具研究與實踐。持續輸出 OpenClaw 及 AI 工具嘅乾貨教學同落地案例,間中分享職場思考同生活感悟。

高考嘅堅持與感恩:我心中嘅嗰座橋,跨越咗命運
40 + IT 女從榮耀離職:揾工碰壁、陪娃焦慮嘅日子裏面,我靠 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 裏執行,結果一些本來應該正常顯示的內容,因為特殊字符、變量展開方式、轉義邏輯不同,表現出完全不一樣的結果。

你可以這樣快速區分:

終端
提示符樣式
cmd(推薦配置用)
C:\Users\你的用戶名>
PowerShell(開頭有 PS)
PS C:\Users\你的用戶名>

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 步做:

  1. 用管理員身份打開 cmd
  2. 設置 ANTHROPIC_AUTH_TOKEN(注意,不是 API_KEY)
  3. 設置 ANTHROPIC_BASE_URL
  4. 把所有模型變量統一指向 MiniMax-M2.7
  5. 關閉所有終端,重新打開新 cmd
  6. 先 echo 驗證變量,再啓動 claude

提示:你只要把這 6 步做對,絕大部分"怎麼都跑不起來"的問題,其實都能繞開。


我後來越來越相信一件事:好的教程,不是把步驟寫得更長,而是把判斷寫得更清楚。因為真正把人困住的,從來不是"不會複製命令",而是出了問題以後,不知道該查哪裏。

如果這篇對你有幫助,可以先收藏起來,等你下一次換模型、換節點、或者幫別人配環境時,再回來對照看。


關於微信信息的助手(支持羣聊和私聊)

微信的聊天記錄其實存在你電腦本地,有辦法把它讀出來,通過 API 接口餵給 AI。

非常多的應用場景,把微信裏的聊天記錄作為你的數據資產

有需要的可以閲讀如下文章,或私信我搭建方案

圖片


五一不要刷羣聊消息了

【支持一對一諮詢】我用hermes搭建了一個助手,每個人應該用得上

關於openclaw、hermes資料包和系列文章

配套資料包

私信 kekohu 獲取,內容不定期持續更新。

選項
內容
價格
資料包
《入門到精通》+《102個實戰案例》+《避坑手冊》+《數百skill技能包》+《AI日報》,付款後即發飛書權限
69元
付費社羣
含上述全套資料包 + 羣內實操答疑 + 不定期乾貨分享 + 同行交流
99 元

注意:付費社羣包含資料包全部內容,無需重複購買。

hermes系列文章

持續更新,建議每篇認真閲讀

【不推薦用官方命令】Windows 環境下安裝Hermes及遷移Openclaw的實操分享

Hermes Agent 實戰:雙模式字卡,認字 + 親子互動一張搞定

【家長老師收藏】AI輔助學習全科提示詞寶典

修改這幾個配置項,讓 MiniMax 模型在 Claude Code 中發揮到極致

【hermes保姆教程】B站視頻逐字稿自動進obsidian知識庫

告別生圖 API,我用 Hermes Skill 免費出圖無限次

清華大學 MAIC 團隊,GitHub 上已經 16.5k Star的一個開源項目

分享我自己在用的Hermes 的Obsidian skill

【保姆教程】我用 Obsidian +hermes搭了一個會自己整理的知識庫

借鑑劉小排的 BuilderPulse :我用 Hermes 發現值得看的github項目

Hermes 入門到實操中文文檔

【Hermes整理】OpenClaw 變現項目地圖:6 大賽道

Hermes 裝好之後,我最建議先做的 8 個實操動作

我把 OpenClaw 的 Agent 無縫遷移到了 Hermes——就靠這一份 Skill

借鑑 Hermes 優化 OpenClaw:讓你的 AI 學會記、會覆盤、會巡檢

openclaw系列文章

持續更新,建議每篇認真閲讀

配置與理解

徹底搞懂 OpenClaw 配置體系:這才是 AI Agent 的正確打開方式
【支持一對一諮詢】我用hermes搭建了一個助手,每個人應該用得上
【不推薦用官方命令】Windows 環境下安裝Hermes及遷移Openclaw的實操分享
我的個人成長助手Agent罷工了,Claude max定位總結的這幾點分享給大家
【今天不聊STBI測試】我用OpenClaw搭了一個自動抓多公眾號、AI整理、發飛書的Agent,核心就這四步
OpenClaw openclaw.json 全量小白教程:一篇講清每個配置項的作用
你在飛書或者微信發了句"你好",OpenClaw 到底花了多少 Token?
詳細指南  微信插件支持OpenClaw
OpenClaw龍蝦如何自我糾錯   5步自我迭代法
【網友都說賊好看】我讓openclaw開發了一個自己的交互式說明書

別被騙,OpenClaw 可以 24 小時幹活——但你得先做對這 6 件事

火了三個月的"龍蝦",普通人裝了真的有用嗎?

用 OpenClaw 把 AI 失憶治好:開關、精簡、外掛三步走

OpenClaw 命令完整手冊
OpenClaw 到底怎麼跑?部署方式與玩法全景
如何申請 Brave Search API 密鑰並配置 OpenClaw
大白話講清楚OpenClaw的記憶術
OpenClaw 長任務必讀:用 Sub-Agent 隔離上下文,token 消耗降 85%
OpenClaw 省 Token 實操手冊:八個維度,節省 60–90%
OpenClaw 曲線救國:通過 CLI 後端使用 Claude 模型
飛書跟openclaw集成實操教程
【該文為openclaw輸出】OpenClaw超簡單且免費的安裝實操教程

多 Agent 與協作

OpenClaw 多 Agent 協作實戰完全教程
OpenClaw 多代理配置指南:讓 AI 團隊幫你同時幹多件事

技能與工具

OpenClaw 官方 53 個技能完整指南:功能詳解 + 風險評估 + 安裝建議
【GitHub Skill 】 OpenClaw多Agent交付給客戶的流程Skill
這個 Skill 太適合“小白摸魚式”情報蒐集了:不用 API Key,直接把 Reddit 變成你的選題庫
【免費領取】7套不同賽道風格公眾號排版Skill(有效果圖)
12類人羣必裝的OpenClaw Skills
不寫代碼,如何讓 OpenClaw Agent 學會新技能

實戰與案例

本地部署 OpenClaw 自動發佈公眾號:小白完整教程
本地部署 OpenClaw 自動發佈小紅書:小白完整教程
我用 OpenClaw,把孩子學習情況整理成能長期追蹤的學情檔案
【實操分享】OpenClaw多文檔多輸入源筆記整理Agent搭建
【保姆教程】OpenClaw作業錯題分析師,每個家長都可以學起來
OpenClaw 完全指南:從零搭建你的 AI 員工團隊
看看這個龍蝦速度,就知道這OpenClaw有多火,速度跟上
OpenClaw 完全指南:從零搭建你的 AI 員工團隊
OpenClaw 實戰:從0到1搭建你的雲端AI工作流
我的OpenClaw 多Agent 會主動發來 “上班打卡”
OpenClaw 實戰操作指南:12大熱門應用案例詳細教程
我的openclaw龍蝦開始自己賺錢了
用上了openclaw,跟telegram能雙向通信了

排錯與安全

OpenClaw 排錯指南
OpenClaw 龍蝦玩家的安全指南

關於嬌姐

40+ IT 從業者,前榮耀員工,現專注 AI 效率工具研究與實踐。持續輸出 OpenClaw 及 AI 工具的乾貨教程與落地案例,偶爾分享職場思考與生活感悟。

高考的堅持與感恩:我心中的那座橋,跨越了命運
40 + IT女從榮耀離職:找工作碰壁、陪娃焦慮的日子裏,我靠 AI 公眾號找到了自我

提示:覺得有用,點贊、關注、轉發,是我持續創作的動力。