CLI ≠ 免費 API

為什麼本機 CLI
可以吃訂閱方案

Claude CLI 和 Codex CLI 是裝在這台機器上、已經登入訂閱帳號的外部 coding agent。Hermes 用 terminal 啟動它們,就會沿用本機的登入狀態,所以走的是訂閱額度,而不是 API 帳單。

SCROLL
PART 1 | 它們是什麼

CLI 是外部工具,
不是 Hermes 的底層模型

先把角色分清楚。Hermes 是主模型,負責直接跟你對話、調度工具。claudecodex 這兩個命令列程式,是它可以呼叫的外部 coding agent,各自有自己的廠商、登入帳號和模型。它們不是 Hermes 換上的另一顆腦袋。

ANTHROPIC

Claude CLI / Claude Code

官方命令列 coding agent
  • 裝在本機,用 claude 啟動
  • 是獨立的 agent,不是 Hermes 主模型
  • 沿用本機已登入的 OAuth / session
實測狀態:已登入 Claude Max account
OPENAI

Codex CLI

OpenAI 的命令列 coding agent
  • 裝在本機,用 codex 啟動
  • 是獨立的 agent,不是 Hermes 主模型
  • 沿用本機已登入的 OAuth / session
實測狀態:已登入 ChatGPT

關鍵在這裡:Hermes 是透過 terminal 啟動它們的。所以執行時用的是「這台機器上這個使用者」當下的登入身份——也就是已經登入的訂閱帳號,而不是任何 API key。

PART 2 | 兩條不同的路

同樣是叫 Claude,
走 CLI 和走 /model 不是同一件事

當你在 Hermes 裡用 /model 切換模型時,那是 Hermes 直接呼叫模型 provider 的 API——通常是 Anthropic API、OpenRouter、OpenAI API 之類。這條路吃的是 API key、算的是 API 帳單。

而透過 terminal 叫起 claudecodex,是另一條完全不同的路:它去問的是本機已登入的訂閱帳號,額度從訂閱方案扣。

A · 本機 CLI(訂閱)
Hermes terminal claude / codex 本機 OAuth / session
帳單來源:訂閱方案額度(Claude Max、ChatGPT)
B · Hermes /model(API)
Hermes provider API(Anthropic API、OpenRouter、OpenAI API…)
帳單來源:API key / 按 token 計費的 API 帳單

不要誤會:CLI 用掉訂閱額度,不等於你把 API 變免費了。它只是換了一個「已經付過訂閱費、而且已登入」的外部工具來做事,並不是把 Hermes 的底層模型換成訂閱版。

PART 3 | 對照表

把差異攤平來看

面向
本機 CLI(claude / codex)
Hermes /model(API)
本質
外部工具型 coding agent
Hermes 直接呼叫的模型 provider
身份來源
本機已登入的 OAuth / session
設定好的 API key
帳單
訂閱方案額度
API 按量計費
啟動方式
terminal 叫起 claude / codex
/model 切換 provider
這台機器現況
claude → Claude Max;codex → ChatGPT
視 provider 與 API key 而定
PART 4 | 什麼時候會誤走 API

CLI 不一定永遠走訂閱,
有幾個情況會掉回 API

CLI 走訂閱的前提,是它讀到的是「訂閱帳號的登入狀態」。但如果環境裡設了 API key,或一開始就是用 API key 登入,CLI 可能改走 API、開始算 API 帳單。常見有三種:

⚠️
ANTHROPIC_API_KEY
環境變數存在時,Claude CLI 可能優先用它走 Anthropic API,而不是 Max 訂閱。
⚠️
OPENAI_API_KEY
同理,Codex 可能改用這把 key 走 OpenAI API,而不是 ChatGPT 訂閱。
⚠️
API-key login
如果當初是用 API key 登入而非 OAuth,那本來就是 API 路徑,不吃訂閱額度。

判斷原則很簡單:登入身份決定走哪條路。OAuth / 訂閱帳號 → 訂閱額度;API key → API 帳單。想吃訂閱,就確認 CLI 是用訂閱帳號登入、而且環境沒有把它導去 API key。

PART 5 | 實務調度原則

Hermes 怎麼決定
哪件事交給誰

知道誰是誰之後,調度就有了次序。短的事 Hermes 自己答;重的 coding 工作優先丟給已登入訂閱的 Claude CLI;需要 OpenAI / Codex 的特長時才動用 Codex;最後一律由 Hermes 收尾驗證。

調度順序
1
短問題 → Hermes 直接答最快
小問題、快速查詢、單純對話,不需要外部 agent,Hermes 直接處理。
2
中大型 coding / review / debug → 優先 Claude CLI訂閱優先
需要動手寫、改、審、除錯的工程任務,優先交給已登入 Claude Max 的 Claude CLI。
3
OpenAI / Codex 特長或明確指定 → 才用 Codex
當任務需要 OpenAI 生態的特長,或你明確點名要用 Codex 時,才動用 Codex CLI。
4
最後 → Hermes 做真實驗證收尾
外部 agent 的產出,由 Hermes 實際驗證、跑過、確認無誤再回報,而不是直接照單全收。

CLI 是「已登入訂閱帳號的外部代理」,API 是「Hermes 直接呼叫模型 provider」。

總結

一句話記住兩條路

CLI
本機上、已登入訂閱帳號的外部 coding agent。Hermes 用 terminal 叫起它,沿用既有登入,走訂閱額度。它不是把 Hermes 的底層模型換成訂閱版。
API
Hermes 透過 /model 直接呼叫 Anthropic API、OpenRouter、OpenAI API 等 provider,吃 API key、算 API 帳單。

所以「CLI 吃訂閱」不是把 API 變免費,而是換了一個已經付過訂閱、而且已登入的工具來做事。只要登入身份是訂閱帳號、環境沒被 API key 導走,這條路就成立。