hermes: command not found 怎麼解

📅 2026年7月23日適用版本 >=2026.5 ✅ 最後驗證 2026年7月4日 ✍️ HermesAgent.download Contributors

安裝腳本跑完,畫面看起來一切正常,你興沖沖打了 hermes,結果:

zsh: command not found: hermes

先別重裝。 九成的情況安裝是成功的,問題出在你現在這個終端機視窗還不知道它的存在。

為什麼會這樣

安裝腳本把 hermes 執行檔放在 ~/.local/bin,並把這個路徑寫進你的 shell 設定檔¹。

但已經開著的終端機視窗是在安裝之前啟動的,它讀到的是舊的 PATH——就像你改了設定檔卻沒重啟程式。

source ~/.zshrc

macOS 從 Catalina 起預設是 zsh。如果你用 bash:

source ~/.bashrc

成功判準:這行指令不會有任何輸出(沒消息就是好消息)。接著打 hermes doctor,有反應就是好了。

不用記指令。新視窗會重新讀 shell 設定檔,自動拿到新的 PATH¹。

用 VS Code 或 IDE 內建終端機的話,可能要完全重啟編輯器才生效,只關掉分頁不夠。

echo $PATH | tr ':' '\n' | grep local

預期輸出:應該看到一行包含 /.local/bin 的路徑,例如 /Users/yourname/.local/bin。

什麼都沒印出來代表安裝腳本沒能改到你的 shell 設定檔。手動加:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

(bash 使用者把兩處 .zshrc 換成 .bashrc)

PATH 沒問題卻還是找不到,直接看檔案在不在:

ls -l ~/.local/bin/hermes

預期輸出:一行檔案資訊。如果是 No such file or directory,那才是真的安裝失敗——重跑一次安裝指令,並注意過程中有沒有紅色錯誤訊息。

hermes doctor

官方的環境診斷指令,逐項檢查相依套件與設定²。

Hermes 預設載入 ~/.bashrc。用其他 shell 要在 config.yaml 的 terminal.shell_init_files 加入你自己的初始化檔¹。

不會。桌面版是圖形介面應用程式,不透過 PATH 啟動。但你想從終端機呼叫的話,還是要走上面的流程。

不用。source 只是讓當前視窗立刻生效;設定檔已經改好了,之後新開的視窗會自動載入。