Hermes Agent 內建的供應商不多，但真正的彈性在於 Custom endpoint（自訂端點） 選項：任何支援 OpenAI chat-completions 格式的服務，只要填入 Base URL、金鑰與模型名稱就能接入。這包括 MiniMax、DeepSeek、Google Gemini、xAI Grok、OpenAI、OpenRouter、私有 vLLM 伺服器、本機 Ollama 實例，而 haimaker.ai 可以一次涵蓋上述所有服務。

以下先說明一般設定方法，再逐一列出最常被詢問的供應商設定值。

一般設定方法

在 Hermes 中設定自訂供應商的流程都一樣：

hermes model
  1. 從選單中選擇 Custom endpoint（自訂端點）。
  2. 輸入 Base URL，也就是 OpenAI 相容的根路徑，以 /v1 結尾（Hermes 會自行附加 /chat/completions）。
  3. 輸入該供應商的 API 金鑰。
  4. 輸入供應商要求的模型識別碼。

Hermes 會儲存此設定，之後每次執行都會沿用。想更改供應商時，再執行一次 hermes model 即可。設定流程就是這樣，本文後續只是提供各家的正確設定值。

模型要在 Hermes 中正常運作，必須能正確處理工具 schema，並具備足夠的上下文長度供代理迴圈使用；建議至少要有約 64K 的可用上下文。實際該選哪個模型，請參考 Hermes Agent 最佳模型。

haimaker.ai — 一組金鑰存取所有模型

不必為每個供應商分別管理帳號、金鑰與 Base URL，只要將 Hermes 指向 haimaker.ai 一次，之後修改一個字串就能切換模型。最快的設定方式是用一行指令完成：

export HAIMAKER_API_KEY=your-haimaker-key
npx -y @haimaker/connect --hermes

@haimaker/connect 會寫入 Hermes 的自訂端點設定並驗證金鑰，驗證後即結束。加上 --model 可指定固定模型，加上 --pick-model 則可互動式選擇模型；執行 npx @haimaker/connect --uninstall --hermes 即可還原設定。請先到 app.haimaker.ai 取得金鑰；新帳號附有免費額度。

如果你偏好內建的 hermes model 流程，請在系統詢問時輸入以下內容：

  • Base URL： https://api.haimaker.ai/v1
  • API 金鑰： 你的 haimaker.ai 金鑰
  • 模型： 任何支援的模型，例如 anthropic/claude-sonnet-4-6、openai/gpt-5-4-codex、google/gemini-3-1-pro、minimax/minimax-m2-5、deepseek/deepseek-v3-2、xai/grok-4-1-fast、zai/glm-4-7、moonshot/kimi-k2-5

模型費用約比市場行情低 5%，而且只需要管理一個帳單帳戶。

在 Hermes 中使用 MiniMax

MiniMax M2.5 是 Hermes 中最受歡迎的平價選擇，便宜到可以持續運作，能力也足以處理工具呼叫迴圈。

  • Base URL： https://api.minimax.io/v1
  • API 金鑰： 從 MiniMax 平台主控台取得
  • 模型： MiniMax-M2.5（請使用 MiniMax 主控台顯示的精確 ID，大小寫必須完全一致）

或透過 haimaker.ai 使用模型 minimax/minimax-m2-5，即可省去另外註冊帳號。

在 Hermes 中使用 Google Gemini

Gemini 提供 OpenAI 相容層，因此可以直接當作 Hermes 的自訂端點使用。

  • Base URL： https://generativelanguage.googleapis.com/v1beta/openai
  • API 金鑰： 你的 Google AI Studio 金鑰
  • 模型： gemini-3-flash 適合成本低、速度快的工作；gemini-3.1-pro 適合長上下文研究

沒錯，Hermes Agent 就是以這種方式支援 Google Gemini，不需要另外啟用 Gemini 整合，它只是個自訂端點。也可以透過 haimaker.ai 使用 google/gemini-3-1-pro。

在 Hermes 中使用 DeepSeek

  • Base URL： https://api.deepseek.com/v1
  • API 金鑰： 從 DeepSeek 平台取得
  • 模型： deepseek-chat（指向目前的 V3.2 系列）或 deepseek-reasoner

透過 haimaker.ai 使用：deepseek/deepseek-v3-2。

在 Hermes 中使用 xAI Grok

  • Base URL： https://api.x.ai/v1
  • API 金鑰： 從 xAI 主控台取得
  • 模型： grok-4.1-fast 適合成本低、大上下文的工作；grok-code-fast 適合程式碼相關任務

透過 haimaker.ai 使用：xai/grok-4-1-fast。

在 Hermes 中使用 OpenAI / Codex 模型

如果你想在 Hermes 中使用 OpenAI 自家的模型（包括 Codex 系列）：

  • Base URL： https://api.openai.com/v1
  • API 金鑰： OpenAI 的 API 金鑰（ChatGPT Plus 訂閱不包含 API 存取權限；你需要另外一組已啟用帳單功能的 API 金鑰）
  • 模型： gpt-5.4-codex 適合撰寫程式，gpt-5.4 適合一般工作

透過 haimaker.ai 使用：openai/gpt-5-4-codex。

透過 Ollama 使用本機模型

  • Base URL： http://localhost:11434/v1
  • API 金鑰： 任何非空字串皆可（Ollama 會忽略，但 Hermes 要求必填）
  • 模型： gemma4:latest、qwen3.5:latest，或任何你已拉取的模型
ollama pull gemma4
hermes model   # Custom endpoint → base URL above → model gemma4:latest

常見問題

  • 長步驟逾時。 供應商速度較慢時，較長的代理回合可能超過 Hermes 預設的串流讀取逾時。啟動 Hermes 前，先將 HERMES_STREAM_READ_TIMEOUT（單位：秒）調高。
  • 401 / 身分驗證錯誤。 金鑰未生效，或你誤貼了主控台/工作階段權杖而非 API 金鑰。請重新執行 hermes model 並重新輸入。
  • 請求出現 404。 你的 Base URL 可能已包含 /chat/completions，或結尾多了斜線。Hermes 會自行附加路徑，URL 只寫到 /v1 即可。
  • 工具呼叫反覆失敗。 通常是模型本身的問題，不是設定問題。小型模型在工具 schema 上容易偏移；請改用更高一級的模型。

取得你的 haimaker.ai 金鑰

新帳號可獲得免費額度供測試。你可以在 haimaker.ai 瀏覽所有支援的模型、即時價格與效能評測，然後執行 npx -y @haimaker/connect --hermes 將 Hermes 指向該服務。

在 HAIMAKER 領取 $10 免費額度

相關文章：Hermes Agent 最佳模型 · Hermes Agent 定價 · Hermes Agent vs Codex CLI