本指南目標:在 Windows 安裝 Hermes Agent(Nous Research 出品的本機 AI agent),並接上自己的 MYAI168 API,使用 Claude Opus 4.8。
Windows 原生安裝器(不用 WSL)會自動裝好 uv、Python、Node、ripgrep、ffmpeg、可攜式 Git,不需事先安裝。全程用 PowerShell 操作,設定檔用記事本編輯。
Anthropic 原生端點 https://www.myai168.com/cgu/api/anthropic (不含 /v1)
OpenAI 相容端點 https://www.myai168.com/cgu/api/openai/v1
主模型 claude-opus-4-8(走 Anthropic 端點)
安裝中(可能在中途任何一步)會自動開啟瀏覽器,並在 PowerShell 顯示類似:
To continue: 1. Open: https://portal.nousresearch.com/...
Waiting for approval (polling every 1s)...
那是 Nous 自家訂閱服務,不是我們要用的 MYAI168。看到就:在 PowerShell 按 Ctrl + C 中斷、把瀏覽器頁面關掉,「不要登入、不要輸入畫面上的 code」。略過不影響後續設定(詳見「二、略過 Nous Portal 登入」)。
%LOCALAPPDATA%\hermes\config.yaml%LOCALAPPDATA%\hermes\.envC:\Users\你的帳號\AppData\Local\hermes\)開 PowerShell(不需系統管理員),執行:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
安裝中會問是否安裝系統套件:
安裝程式會自動處理相依套件的下載與安裝(官方文件明載不需手動安裝 ripgrep/ffmpeg),全程不需系統管理員權限、也不會要求輸入密碼。
接著(若登入步驟沒被中斷的話)會進設定精靈;但通常你會在登入那步按 Ctrl + C 略過,精靈也會「跟著一起中斷」——這完全沒關係,因為本指南的 MYAI168 設定「不靠設定精靈」,而是用「三、接上 MYAI168」手動編 config.yaml。所以精靈有沒有跑完都無所謂,不需要重裝。
(若精靈有跑完,選項為:Terminal backend → Keep current (local);通訊平台 → 全不選;工具/各種 provider → 一律 Skip。)
只要下面這個指令能顯示版本號,就代表 Hermes 本體已裝好,可直接進「三、接上 MYAI168」設定——開「新的」PowerShell 視窗,確認:
hermes --version
如「安裝總覽」的提醒所述:安裝過程自動跳出「Not logged into Nous Portal / Starting login」並開瀏覽器要登入時——那是 Nous 自家訂閱服務,不是 MYAI168。
Ctrl + C 中斷。第一步:寫金鑰到 .env(換成真正金鑰,兩行各貼一次、Enter):
echo 'MYAI168_CLAUDE_API_KEY=你的-key' >> $env:LOCALAPPDATA\hermes\.env
echo 'MYAI168_API_KEY=你的-key' >> $env:LOCALAPPDATA\hermes\.env
第二步:用記事本開 config.yaml:
notepad $env:LOCALAPPDATA\hermes\config.yaml
檔案最上面通常是這 5 行預設值:
model:
default: anthropic/claude-opus-4.6
provider: auto
base_url: https://openrouter.ai/api/v1
providers: {}
把這 5 行「選取刪除」,改成下面的內容(下方原有的 fallback_providers、toolsets、agent 等區塊全部保留不動):
model:
provider: custom:myai168_claude
default: claude-opus-4-8
context_length: 200000
custom_providers:
- name: myai168_claude
base_url: https://www.myai168.com/cgu/api/anthropic
key_env: MYAI168_CLAUDE_API_KEY
api_mode: anthropic_messages
providers: {}
★★ 貼上注意 ★★YAML 對縮排極度敏感。model:/custom_providers:/providers: 這三個頂層項目必須「頂格」(前面 0 個空格);它們底下的子項才縮排。在記事本貼上後,檢查這三個項目有沒有頂到最左邊、前面沒有空格;縮排只能用空格,不要用 Tab。
存檔 Ctrl + S(若問編碼選 UTF-8),關閉。
.../anthropic(不含 /v1)。若存檔後 hermes 報「Failed to parse config.yaml」之類錯誤,多半是縮排跑掉或頂層項目前面多了空格——重開 notepad 檢查那三個頂層項目有沒有頂格,修正後再存。
注意:cc-switch 對 Hermes 的寫入可能失效(設定不會真的寫進 config.yaml),因此 Hermes 建議用本節「記事本手動設定」,不要依賴 cc-switch。
開新的 PowerShell,直接打:
hermes
進畫面後直接打字送出。底部狀態列顯示 claude-opus-4-8 即成功。(若出現 "Auxiliary title generation failed: HTTP 404",那是輔助模型小功能失敗,不影響主對話,可忽略。)
確認設定有寫入(可選):
Get-Content $env:LOCALAPPDATA\hermes\config.yaml -TotalCount 12
.../anthropic 改成 .../anthropic/v1 再試。/model;新增供應商則離開後跑 hermes model。