實戰：MiniMax OAuth 接入

這篇教學將手把手教你如何用瀏覽器登入的方式，免費接入 MiniMax 大模型，全程不需要 API Key 和信用卡。

---

為什麼選 OAuth 登入？

想像一下，以前用 API Key 就像拿著把備用鑰匙，得小心保管、定期更換；而 OAuth 登入就像刷臉進門——你在瀏覽器裡授權一次，Hermes 會自動幫你「續門禁卡」，省心又安全。

MiniMax 官方還貼心地提供了全球版（minimax.io）和中國版（minimaxi.com）兩個入口，本篇主要講全球版，中國版使用者文末有特別說明。

---

第 1 步：確認環境

• 已安裝 Hermes Agent（Python 3.9+）
• 有一個 MiniMax 帳號（去官網免費註冊）
• 本地電腦有瀏覽器（伺服器使用者請看第 5 步）

第 2 步：啟動並登入

打開終端機，輸入：

hermes model

在提供者清單裡選擇 MiniMax (OAuth)，Hermes 會自動彈出瀏覽器視窗，跳到 MiniMax 授權頁面。點擊「同意」後，回到終端機，選擇模型（推薦 MiniMax-M2.7），就可以開始聊天了！

登入資訊會安全地儲存在 ~/.hermes/auth.json，下次啟動自動續期，無需重複登入。

第 3 步：手動登入（可選）

如果只想登入、不急著選模型，可以單獨執行：

hermes auth add minimax-oauth

第 4 步：檢查登入狀態

hermes doctor

看到 ✓ MiniMax OAuth (logged in) 就說明一切正常。

第 5 步：遠端伺服器 / 無瀏覽器環境

在伺服器上登入，加個參數就行：

hermes auth add minimax-oauth --no-browser

終端機會顯示一個網址和驗證碼，在你自己電腦的瀏覽器打開網址、輸入驗證碼，就能完成遠端授權。

第 6 步：切換模型（隨時可換）

hermes model

或者直接指定：

hermes config set model.default MiniMax-M2.7
hermes config set model.provider minimax-oauth

---

中國版使用者特別說明

如果你的帳號在中國版平台（minimaxi.com），請改用 API Key 方式：

echo 'MINIMAX_CN_API_KEY=你的金鑰' >> ~/.hermes/.env

---

常見問題速查

問題	解決辦法
授權逾時	重新執行 hermes auth add minimax-oauth
提示重新登入	同上，重新授權即可
登入狀態遺失	執行 hermes model 重新選一次
想登出	hermes auth logout minimax-oauth

---

小結

用 OAuth 登入 MiniMax，零設定、免金鑰、自動續期，體驗非常順滑。而且 MiniMax-M2.7 支援 20 萬 token 上下文，複雜任務也能輕鬆應對。

下篇預告：我們將實戰另一個主流大模型——通義千問（Qwen）的接入，看看阿里系模型在 Hermes 裡表現如何，敬請期待！

---