生活分享

CLI 指令總表:語法、範例與深入教學

這份指令總表整理 Gemini CLI 0.59.0 的內建操作,讓你先找到用途,再跳到負責講解的文章。清單由本機已安裝版本的指令載入器核對,並對照官方文件;自訂命令、MCP 提示詞與開發版專用命令不混入固定內建清單。部分專案必須先開啟功能或符合登入條件。

更新日期: 閱讀時間約 10 分鐘

LINE 分享
三種指令輸入位置的原創插畫,以文件、裝置與流程等物件呼應語法、範例與深入教學;非產品介面。
圖片:Mokaair (© Mokaair)
本篇目錄
  1. 1. 開始前:辨識三種輸入位置
  2. 2. 常用操作:先學會看狀態
  3. 3. 完整內建指令:依名稱找到深入教學
  4. 4. 模型與對話:操作後確認影響
  5. 5. 終端機引數與語法速查
  6. 6. 常見問題與版本更新
  7. 7. 完成後的檢核

這份指令總表整理 Gemini CLI 0.59.0 的內建操作,讓你先找到用途,再跳到負責講解的文章。清單由本機已安裝版本的指令載入器核對,並對照官方文件;自訂命令、 提示詞與開發版專用命令不混入固定內建清單。部分專案必須先開啟功能或符合登入條件。

提示詞:輸入自然語言需求;斜線指令:在 CLI 裡輸入 /help;終端機命令:在 shell 執行 gemini
三種指令輸入位置。此為原創教學圖解,並非產品畫面或實測輸出。 · 圖片:Mokaair (© Mokaair)

開始前:辨識三種輸入位置

先完成與。gemini --version 是在 PowerShell 或 shell 執行的終端機命令;/memory list 是在 Gemini CLI 裡輸入的斜線指令;「幫我摘要這份公告」則是交給模型的提示詞。若放錯位置,即使文字完全正確,也不會得到同樣結果。

本文核對時,將可選的使用者功能開啟以取得完整清單,但沒有執行每個指令的動作,也沒有替讀者安裝服務或更改帳號。你的 /help 若少了某一項,先檢查版本、功能開關與管理者政策,不要直接認定安裝損壞。詳細差異請回到對應教學檢視。

常用操作:先學會看狀態

先輸入 /help 與 /about,確認可用命令和版本。接著用 /tools desc 看工具說明;這可以告訴你 CLI 現在有哪些能力,但不代表所有工具都已獲得外部服務授權。要確認專案指示,用 /memory list、/memory show;改檔後再 reload,詳見。

Gemini CLI 內輸入 · text
/help
/about
/tools desc
/memory list
/memory show
/memory reload

0.59.0 的 /memory reload 保留 refresh 別名;/compress 也有 compact 與 summarize 別名。這些別名都指向同一類操作,不需要建立多份設定。官方不同頁面可能尚未使用相同名稱,本篇以實際版本清單為準,升級後再重新核對。

完整內建指令:依名稱找到深入教學

每一行列出指令、用途、直接子指令及負責說明的文章。子指令後仍可能需要名稱、檔案或其他引數,請先看 CLI 補全提示與深入教學。具有刪除、還原、登入或安裝效果的命令,不應為了測試清單而全部執行一次。

/about:查看 CLI 版本資訊。延伸:。

/agents:管理;需啟用代理功能;子指令:list、reload、enable、disable、config。延伸:。

/auth:登入、登出與切換認證;子指令:signin、signout。延伸:。

/bug:準備問題回報;送出前檢查包含的資料。延伸:。

/bug-memory:將記憶體快照寫入磁碟供除錯;可能包含工作資料。延伸:。

/chat:瀏覽對話與管理命名檢查點;子指令:list、save、resume、delete、share、checkpoints。延伸:。

/clear(別名:/new):清除畫面並開始新工作階段。延伸:。

/commands:列出與重新載入自訂指令;子指令:list、reload。延伸:。

/compress(別名:/summarize、/compact):以摘要壓縮目前上下文。延伸:。

/copy:將最近結果或程式碼複製到剪貼簿。延伸:。

/corgi:切換柯基趣味顯示模式,不改變工作資料。

/docs:在瀏覽器開啟官方文件。延伸:。

/export-session:將目前對話匯出成 JSON 檔案。延伸:。

/directory(別名:/dir):查看或加入工作區目錄;子指令:add、show。延伸:。

/editor:設定外部編輯器偏好。延伸:。

/extensions:探索、安裝、更新與管理擴充套件;子指令:list、update、explore、reload、disable、enable、install、uninstall、link、config。延伸:。

/help:查看目前 CLI 的指令說明。

/footer(別名:/statusline):調整底部狀態列顯示項目。

/shortcuts:切換輸入區上方的快捷鍵提示。

/hooks:查看與啟停事件掛鉤;需啟用 Hooks 介面;子指令:panel、enable、disable、enable-all、disable-all。延伸:。

/rewind:選擇較早的對話與檔案還原點。延伸:。

/ide:查看編輯器整合;依實際連線環境提供操作。延伸:。

/init:分析專案並建立 GEMINI.md。延伸:。

/mcp:查看工具伺服器、結構、認證與連線狀態;子指令:list、desc、schema、auth、reload、enable、disable。延伸:。

/memory:檢查與重新載入專案記憶;inbox 需 Auto Memory;子指令:show、reload、list、inbox。延伸:。

/model:選擇模型或設定模型識別名稱;子指令:manage、set。

/permissions:管理資料夾信任與權限;子指令:trust。延伸:。

/plan:進入規劃模式與查看計畫;需啟用功能;子指令:copy。延伸:。

/policies:列出適用的工具政策;子指令:list。延伸:。

/privacy:顯示 CLI 隱私說明。延伸:。

/quit(別名:/exit):離開 CLI 工作階段。延伸:。

/restore:恢復工具檢查點;需有可用的檢查點紀錄。延伸:。

/resume:尋找先前工作階段與命名檢查點;子指令:list、save、resume、delete、share、checkpoints。延伸:。

/stats(別名:/usage):查看工作階段、模型或統計;子指令:session、model、tools。延伸:。

/theme:變更終端機介面主題。

/tools:列出目前可用工具與用途;子指令:list、desc。延伸:。

/:查看、連結、啟停與重載技能;子指令:list、link、disable、enable、reload。延伸:。

/settings:開啟 CLI 設定介面。延伸:。

/gemma:查看本機 Gemma 模型路由狀態,非雲端 Gemini 方案。

/tasks(別名:/bg、/background):查看背景工作;別名 bg、background。延伸:。

/vim:切換 Vim 風格輸入模式。

/setup-github:啟動 GitHub Actions 設定流程,需另查專案權限。延伸:。

/terminal-setup:設定支援的編輯器終端機多行輸入快捷鍵。

/voice:切換 CLI 語音輸入;需啟用對應功能;子指令:model。

/upgrade:查看 Code Assist 升級入口;Google 登入條件適用。延伸:。

模型與對話:操作後確認影響

模型選擇可從 /model manage 開啟介面,或用 /model set 加上你帳號可用的模型識別字;需要持續儲存時,先檢視該版本提供的 persist 行為。不要把網頁版模式名稱當成 API 或 CLI 模型識別字,也不要把切換成功當成所有工具都已支援新模型。

對話太長時用 /compress 整理上下文,但重要需求仍應儲存在你可查閱的檔案。要找舊工作用 /resume,要另開新工作階段用 /clear;這些操作與清除本機檔案不同。完整恢復、匯出與還原範例見,執行還原前先讀清楚會影響對話、檔案或兩者。

終端機引數與語法速查

終端機命令以 gemini 開頭。單次非互動提問使用 -p,選輸出格式用 -o;恢復最近工作階段可用 --resume latest。先用 --help 檢視當前版本,再把需要的引數放入腳本,不要從不同年代文章各抄一段組合。

終端機命令 · bash
gemini --version
gemini --help
gemini --resume latest
gemini -p "請列出公告摘要應核對的欄位,不使用工具。" -o json

@ 是檔案與資源引用入口,! 是 shell 命令入口;兩者都不是一般的文字裝飾。需要路徑、引號與背景工作說明時閱讀。要把短提示詞存成自己的 /summary,閱讀,不要把自訂名稱誤列為所有讀者都有的內建命令。

常見問題與版本更新

「官方文件有 /shells,我卻找不到」這份 0.59.0 載入器清單提供 /tasks,另有 bg 與 background 別名。遇到檔案差異時,以本機 help 與版本化清單交叉核對。不要為了讓舊指令可用,就任意安裝不明套件。

「/extensions install 能不能在 CLI 裡用」0.59.0 在啟用對應功能時提供互動子指令,但部分官方文件仍以終端機管理為主。本系列完整安裝範例採 gemini extensions,讀者比較容易辨識輸入位置;會帶你完成安裝、重啟與連線驗證。

「/bug-memory 可以當一般記憶功能嗎」不適合,它是寫出程式記憶體快照供除錯的功能,可能包含工作資料。專案規則請使用 GEMINI.md 與 /memory;需要回報問題時先檢查資料內容與儲存位置,不把診斷檔直接當作普通教學附件公開。

新增命令前,先記錄來源屬於內建、專案 TOML、擴充套件或 MCP。把這四種來源分清楚,才知道更新或停用應到哪裡操作。若清單與預期不同,依從版本、目錄與功能狀態開始查。

完成後的檢核

完成實作後逐項確認。
檢查項目通過條件
操作能依正文重做一次,說明每一步使用的輸入。
結果能用原始資料或可重現測試核對輸出,而非只看語氣。
延伸知道下一篇教學解決的問題,以及什麼時候需要它。

接著可以閱讀 、,把本篇的操作接到下一個工作流程。

覺得這篇整理實用嗎?分享給需要的朋友

LINE 分享
  • 生活分享

    完整實作:文件摘要與資料擷取工具

    這篇把前面學過的提示詞、API 呼叫與 JSON 驗證串成一個可執行的檔案工具。輸入一份 UTF-8 活動公告,程式產生摘要、五個固定欄位、原文引用與待確認問題,再存成待審 JSON。你會練習把模型當作資料處理的一個步驟,讓驗證與儲存仍由程式明確控制。

  • 生活分享

    API 額度與錯誤:費用、重試與成本控制

    Gemini API 的費用取決於模型、輸入輸出、服務模式及使用的工具;速率限制則決定你的專案在一段時間內能送出多少工作。本篇教你找到真正對應的用量頁面、估算一次檔案處理成本、分類錯誤,並設計有限重試與停止條件,避免把每個失敗都當成多按一次就能解決。

  • 生活分享

    API 檔案與 JSON:結構化輸出及驗證

    Gemini API 可以讀取 PDF,再把結果整理成指定的 JSON 結構。本篇用虛構活動公告示範檔案輸入、欄位設計與本地驗證。學完後,你會知道「收到合法 JSON」與「內容確實來自檔案」是兩件需要分別檢查的事,並能保留缺漏資訊而不讓模型自行補齊。

  • 生活分享

    AI Studio 與第一個 Gemini API 呼叫

    Google AI Studio 是試用模型與建立 Gemini API 金鑰的開發入口。本篇從一個簡單提示詞開始,帶你建立獨立專案環境,分別用 Python 與 JavaScript 呼叫 API。完成後,你會知道網頁試跑、程式執行與帳號用量各自在哪裡確認,不再把消費者版 Gemini 的操作直接套程式式。

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享