生活分享
CLI 指令總表:語法、範例與深入教學
這份指令總表整理 Gemini CLI 0.59.0 的內建操作,讓你先找到用途,再跳到負責講解的文章。清單由本機已安裝版本的指令載入器核對,並對照官方文件;自訂命令、MCP 提示詞與開發版專用命令不混入固定內建清單。部分專案必須先開啟功能或符合登入條件。
更新日期: 閱讀時間約 10 分鐘

本篇目錄
這份指令總表整理 Gemini CLI 0.59.0 的內建操作,讓你先找到用途,再跳到負責講解的文章。清單由本機已安裝版本的指令載入器核對,並對照官方文件;自訂命令、MCP模型上下文協定(MCP)是什麼:連接工具與資料的共同介面MCP 是讓 AI 應用程式與外部工具、資料和提示範本交換資訊的開放協定,不是模型本身,也不保證接上就能完成任務。本文用查詢社區圖書室資料的例子,說明主機、用戶端、伺服器及工具、資源、提示的分工,並比較 MCP、A2A 與 Agent Skills。附連線驗證與權限檢查方法,幫你區分已設定、已連接、可呼叫與真正取得結果。閱讀全文 提示詞與開發版專用命令不混入固定內建清單。部分專案必須先開啟功能或符合登入條件。
開始前:辨識三種輸入位置
先完成安裝Gemini CLI 安裝:第一次在終端機對話Gemini CLI 是在終端機使用的 AI 工具,可以讀取專案檔案、協助修改程式與執行工作流程。本篇帶你在 Windows、macOS 或 Linux 完成安裝,確認版本,建立獨立練習資料夾並完成第一次對話。它與 Gemini 網頁、手機 App 的入口不同,適合需要處理本機檔案與程式的人。閱讀全文與認證CLI 認證:Google 帳號、API Key 與計費Gemini CLI 的登入方式會影響可使用的服務、額度與計費歸屬。本篇帶你比較 Google 帳號登入、Gemini API Key 與 Vertex AI,完成適合自己的認證,並用最小對話驗證。重點是知道目前到底使用哪個帳號與專案,而不是只看到登入成功就假設所有功能都包含在訂閱裡。閱讀全文。gemini --version 是在 PowerShell 或 shell 執行的終端機命令;/memory list 是在 Gemini CLI 裡輸入的斜線指令;「幫我摘要這份公告」則是交給模型的提示詞。若放錯位置,即使文字完全正確,也不會得到同樣結果。
本文核對時,將可選的使用者功能開啟以取得完整清單,但沒有執行每個指令的動作,也沒有替讀者安裝服務或更改帳號。你的 /help 若少了某一項,先檢查版本、功能開關與管理者政策,不要直接認定安裝損壞。詳細差異請回到對應教學檢視。
常用操作:先學會看狀態
先輸入 /help 與 /about,確認可用命令和版本。接著用 /tools desc 看工具說明;這可以告訴你 CLI 現在有哪些能力,但不代表所有工具都已獲得外部服務授權。要確認專案指示,用 /memory list、/memory show;改檔後再 reload,詳見記憶載入GEMINI.md 進階:範圍、匯入與 /memory同時使用多個專案時,GEMINI.md 不一定只有一份。Gemini CLI 可以從全域設定、工作目錄與相關子目錄取得指示,並合併成模型看到的上下文。本篇教你追查實際載入了哪些檔案、匯入共用規則,以及用可重現的測試確認更新是否生效。閱讀全文。
/help
/about
/tools desc
/memory list
/memory show
/memory reload
0.59.0 的 /memory reload 保留 refresh 別名;/compress 也有 compact 與 summarize 別名。這些別名都指向同一類操作,不需要建立多份設定。官方不同頁面可能尚未使用相同名稱,本篇以實際版本清單為準,升級後再重新核對。
完整內建指令:依名稱找到深入教學
每一行列出指令、用途、直接子指令及負責說明的文章。子指令後仍可能需要名稱、檔案或其他引數,請先看 CLI 補全提示與深入教學。具有刪除、還原、登入或安裝效果的命令,不應為了測試清單而全部執行一次。
/about:查看 CLI 版本資訊。延伸:CLI 疑難排解CLI 疑難排解:登入、PATH 與設定失效Gemini CLI 發生問題時,先找出失敗層級,通常比重新安裝所有工具更有效。本篇建立一條可重複使用的排查路線:從找不到命令、登入失敗,到檔案權限、額度及設定未載入。你會得到能儲存的診斷紀錄,並知道修正後要重跑哪個最小測試。閱讀全文。
/agents:管理子代理子代理(Subagent)是什麼:把有邊界的工作交出去子代理是由主代理委派特定工作的代理,通常有自己的任務上下文,再把結果交回主代理整合;它不一定使用不同模型,也不必永久保存記憶。本文以社區刊物的資料查核為例,說明交辦範圍、證據格式、同步與背景執行的差別,以及為什麼子代理說完成仍需要驗收。附交接圖與實用檢查表,幫你判斷何時分派能減少負擔。閱讀全文;需啟用代理功能;子指令:list、reload、enable、disable、config。延伸:SubagentsSubagents:拆分任務與整合結果Subagents(子代理)讓 Gemini CLI 把範圍明確的工作交給獨立上下文處理,再將結果交回主對話。本篇建立一個只讀指定檔案、找出資料缺漏的子代理,練習任務拆分、工具限制與結果整合。重點是交付可核對的證據,而不是同時開越多代理越好。閱讀全文。
/auth:登入、登出與切換認證;子指令:signin、signout。延伸:CLI 認證CLI 認證:Google 帳號、API Key 與計費Gemini CLI 的登入方式會影響可使用的服務、額度與計費歸屬。本篇帶你比較 Google 帳號登入、Gemini API Key 與 Vertex AI,完成適合自己的認證,並用最小對話驗證。重點是知道目前到底使用哪個帳號與專案,而不是只看到登入成功就假設所有功能都包含在訂閱裡。閱讀全文。
/bug:準備問題回報;送出前檢查包含的資料。延伸:CLI 疑難排解CLI 疑難排解:登入、PATH 與設定失效Gemini CLI 發生問題時,先找出失敗層級,通常比重新安裝所有工具更有效。本篇建立一條可重複使用的排查路線:從找不到命令、登入失敗,到檔案權限、額度及設定未載入。你會得到能儲存的診斷紀錄,並知道修正後要重跑哪個最小測試。閱讀全文。
/bug-memory:將記憶體快照寫入磁碟供除錯;可能包含工作資料。延伸:CLI 疑難排解CLI 疑難排解:登入、PATH 與設定失效Gemini CLI 發生問題時,先找出失敗層級,通常比重新安裝所有工具更有效。本篇建立一條可重複使用的排查路線:從找不到命令、登入失敗,到檔案權限、額度及設定未載入。你會得到能儲存的診斷紀錄,並知道修正後要重跑哪個最小測試。閱讀全文。
/chat:瀏覽對話與管理命名檢查點;子指令:list、save、resume、delete、share、checkpoints。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/clear(別名:/new):清除畫面並開始新工作階段。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/commands:列出與重新載入自訂指令;子指令:list、reload。延伸:自訂斜線指令自訂斜線指令:TOML、參數與重新載入自訂斜線指令可以把經常重複的提示詞存成 Gemini CLI 的快捷操作。例如每次整理公告都要保留日期、地點與缺漏資料,可以包成 /summary。本篇從不執行 shell 的純提示詞指令開始,教你建立 TOML、傳入引數、重新載入及檢查結果。閱讀全文。
/compress(別名:/summarize、/compact):以摘要壓縮目前上下文。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/copy:將最近結果或程式碼複製到剪貼簿。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/corgi:切換柯基趣味顯示模式,不改變工作資料。
/docs:在瀏覽器開啟官方文件。延伸:CLI 疑難排解CLI 疑難排解:登入、PATH 與設定失效Gemini CLI 發生問題時,先找出失敗層級,通常比重新安裝所有工具更有效。本篇建立一條可重複使用的排查路線:從找不到命令、登入失敗,到檔案權限、額度及設定未載入。你會得到能儲存的診斷紀錄,並知道修正後要重跑哪個最小測試。閱讀全文。
/export-session:將目前對話匯出成 JSON 檔案。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/directory(別名:/dir):查看或加入工作區目錄;子指令:add、show。延伸:CLI 檔案與命令CLI 檔案與命令:@、! 與路徑Gemini CLI 可以引用檔案,也能執行作業系統命令,但這兩種輸入的效果完全不同。本篇用一份虛構公告示範 @ 檔案引用、! shell 命令、路徑與工具結果核對。學完後,你能清楚知道資料有沒有被讀取、命令有沒有執行,以及下一步應檢查哪個結果。閱讀全文。
/editor:設定外部編輯器偏好。延伸:CLI 寫程式CLI 寫程式:理解、規劃、修改與測試用 Gemini CLI 寫程式,可靠的流程是先理解專案與重現問題,再規劃小範圍修改、檢查差異並執行相關測試。本篇用一個簡單的活動人數函式示範完整工作順序。你不需要一開始就交出整個應用程式,也能學會如何給資料、判斷修改是否對題,以及儲存驗證結果。閱讀全文。
/extensions:探索、安裝、更新與管理擴充套件;子指令:list、update、explore、reload、disable、enable、install、uninstall、link、config。延伸:MCP 與 ExtensionsMCP 與 Extensions:安裝、驗證與停用MCP(模型上下文協定)讓 Gemini CLI 使用外部工具與資料;Extensions(擴充套件)則把工具設定、提示詞與其他資源包成可安裝的套件。本篇教你分辨兩者,完成安裝前檢查、檢視連線狀態、執行一個小型讀取測試,再停用不需要的能力。閱讀全文。
/help:查看目前 CLI 的指令說明。
/footer(別名:/statusline):調整底部狀態列顯示項目。
/shortcuts:切換輸入區上方的快捷鍵提示。
/hooks:查看與啟停事件掛鉤;需啟用 Hooks 介面;子指令:panel、enable、disable、enable-all、disable-all。延伸:HooksHooks:在指定事件執行檢查Hooks(事件掛鉤)讓 Gemini CLI 在特定事件發生時執行你寫的程式。本篇用一個小型檢查器示範:在 CLI 準備呼叫 shell 工具前先回傳阻擋原因,讓練習階段保持唯讀。學完後,你會知道事件、設定與程式輸出如何接起來,以及如何分開驗證每一層。閱讀全文。
/rewind:選擇較早的對話與檔案還原點。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/ide:查看編輯器整合;依實際連線環境提供操作。延伸:CLI 寫程式CLI 寫程式:理解、規劃、修改與測試用 Gemini CLI 寫程式,可靠的流程是先理解專案與重現問題,再規劃小範圍修改、檢查差異並執行相關測試。本篇用一個簡單的活動人數函式示範完整工作順序。你不需要一開始就交出整個應用程式,也能學會如何給資料、判斷修改是否對題,以及儲存驗證結果。閱讀全文。
/init:分析專案並建立 GEMINI.md。延伸:GEMINI.md 入門GEMINI.md 入門:建立規則與 /initGEMINI.md 是 Gemini CLI 用來取得專案指示的檔案。把專案目的、語言、測試方式與修改界線寫在這裡,就不必每次重新貼同一段背景。本篇用獨立練習資料夾建立最小規則,並檢查載入結果;這套操作適用 CLI,不會讓 Gemini 網頁版自動讀取電腦中的檔案。閱讀全文。
/mcp:查看工具伺服器、結構、認證與連線狀態;子指令:list、desc、schema、auth、reload、enable、disable。延伸:MCP 與 ExtensionsMCP 與 Extensions:安裝、驗證與停用MCP(模型上下文協定)讓 Gemini CLI 使用外部工具與資料;Extensions(擴充套件)則把工具設定、提示詞與其他資源包成可安裝的套件。本篇教你分辨兩者,完成安裝前檢查、檢視連線狀態、執行一個小型讀取測試,再停用不需要的能力。閱讀全文。
/memory:檢查與重新載入專案記憶;inbox 需 Auto Memory;子指令:show、reload、list、inbox。延伸:GEMINI.md 進階GEMINI.md 進階:範圍、匯入與 /memory同時使用多個專案時,GEMINI.md 不一定只有一份。Gemini CLI 可以從全域設定、工作目錄與相關子目錄取得指示,並合併成模型看到的上下文。本篇教你追查實際載入了哪些檔案、匯入共用規則,以及用可重現的測試確認更新是否生效。閱讀全文。
/model:選擇模型或設定模型識別名稱;子指令:manage、set。
/permissions:管理資料夾信任與權限;子指令:trust。延伸:CLI 權限CLI 權限:忽略檔案、可信任資料夾與沙箱Gemini CLI 能讀取檔案與呼叫工具,因此開始使用前,要理解忽略檔案、資料夾信任與沙箱各控制什麼。本篇在獨立練習專案中建立 .geminiignore,檢查資料夾信任選項,再辨識啟動沙箱所需條件。完成後,你能說明每一層的用途,而不會把文字規則當成檔案存取的完整隔離。閱讀全文。
/plan:進入規劃模式與查看計畫;需啟用功能;子指令:copy。延伸:CLI 寫程式CLI 寫程式:理解、規劃、修改與測試用 Gemini CLI 寫程式,可靠的流程是先理解專案與重現問題,再規劃小範圍修改、檢查差異並執行相關測試。本篇用一個簡單的活動人數函式示範完整工作順序。你不需要一開始就交出整個應用程式,也能學會如何給資料、判斷修改是否對題,以及儲存驗證結果。閱讀全文。
/policies:列出適用的工具政策;子指令:list。延伸:CLI 權限CLI 權限:忽略檔案、可信任資料夾與沙箱Gemini CLI 能讀取檔案與呼叫工具,因此開始使用前,要理解忽略檔案、資料夾信任與沙箱各控制什麼。本篇在獨立練習專案中建立 .geminiignore,檢查資料夾信任選項,再辨識啟動沙箱所需條件。完成後,你能說明每一層的用途,而不會把文字規則當成檔案存取的完整隔離。閱讀全文。
/privacy:顯示 CLI 隱私說明。延伸:CLI 認證CLI 認證:Google 帳號、API Key 與計費Gemini CLI 的登入方式會影響可使用的服務、額度與計費歸屬。本篇帶你比較 Google 帳號登入、Gemini API Key 與 Vertex AI,完成適合自己的認證,並用最小對話驗證。重點是知道目前到底使用哪個帳號與專案,而不是只看到登入成功就假設所有功能都包含在訂閱裡。閱讀全文。
/quit(別名:/exit):離開 CLI 工作階段。延伸:Gemini CLI 安裝Gemini CLI 安裝:第一次在終端機對話Gemini CLI 是在終端機使用的 AI 工具,可以讀取專案檔案、協助修改程式與執行工作流程。本篇帶你在 Windows、macOS 或 Linux 完成安裝,確認版本,建立獨立練習資料夾並完成第一次對話。它與 Gemini 網頁、手機 App 的入口不同,適合需要處理本機檔案與程式的人。閱讀全文。
/restore:恢復工具檢查點;需有可用的檢查點紀錄。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/resume:尋找先前工作階段與命名檢查點;子指令:list、save、resume、delete、share、checkpoints。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/stats(別名:/usage):查看工作階段、模型或工具使用工具呼叫(Tool Calling)是什麼:模型如何請程式做事工具呼叫是模型依工具說明產生結構化請求,交由程式執行,再讀取結果的流程;產生參數不等於操作已成功。本文用借用社區器材的情境,說明工具名稱、輸入格式、查詢與寫入的差異,以及為什麼合法 JSON 仍可能包含錯誤內容。附完整往返圖與故障判讀表,幫你看懂代理何時只是提議,何時才有真正的外部結果。閱讀全文統計;子指令:session、model、tools。延伸:CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文。
/theme:變更終端機介面主題。
/tools:列出目前可用工具與用途;子指令:list、desc。延伸:CLI 檔案與命令CLI 檔案與命令:@、! 與路徑Gemini CLI 可以引用檔案,也能執行作業系統命令,但這兩種輸入的效果完全不同。本篇用一份虛構公告示範 @ 檔案引用、! shell 命令、路徑與工具結果核對。學完後,你能清楚知道資料有沒有被讀取、命令有沒有執行,以及下一步應檢查哪個結果。閱讀全文。
/skills代理技能(Agent Skills)是什麼:可重用的工作方法包Agent Skills 是把工作指示、參考資料與可選腳本放進資料夾的開放格式,讓相容代理在需要時載入特定做法。本文用社區月報整理的情境,說明 SKILL.md、名稱與描述、逐步載入及附屬資源的角色,分清技能、系統提示詞、MCP 和 A2A。附內容設計與驗收方法,幫你判斷技能是否真的可重用,而不是只把長提示詞換個檔名。閱讀全文:查看、連結、啟停與重載技能;子指令:list、link、disable、enable、reload。延伸:Agent SkillsAgent Skills:建立可重用的 SKILL.mdAgent Skills(代理技能)把一套工作方法包成可重複使用的資料夾。你可以讓 Gemini CLI 在整理活動資料時,依固定步驟讀取來源、找出缺漏,再交付可核對的表格。本篇會建立一個不需要額外服務的技能,並教你確認它有被發現、啟用與正確使用。閱讀全文。
/settings:開啟 CLI 設定介面。延伸:settings.jsonsettings.json:全域、專案與環境變數settings.json 管理 Gemini CLI 的程式設定;GEMINI.md 則提供專案指示。這篇帶你辨識全域與專案設定,編輯一個最小 JSON 範例,並用實際載入結果檢查是否生效。你也會學到如何處理環境變數,避免把金鑰直接寫進可分享的設定檔。閱讀全文。
/gemma:查看本機 Gemma 模型路由狀態,非雲端 Gemini 方案。
/tasks(別名:/bg、/background):查看背景工作;別名 bg、background。延伸:CLI 檔案與命令CLI 檔案與命令:@、! 與路徑Gemini CLI 可以引用檔案,也能執行作業系統命令,但這兩種輸入的效果完全不同。本篇用一份虛構公告示範 @ 檔案引用、! shell 命令、路徑與工具結果核對。學完後,你能清楚知道資料有沒有被讀取、命令有沒有執行,以及下一步應檢查哪個結果。閱讀全文。
/vim:切換 Vim 風格輸入模式。
/setup-github:啟動 GitHub Actions 設定流程,需另查專案權限。延伸:CLI 寫程式CLI 寫程式:理解、規劃、修改與測試用 Gemini CLI 寫程式,可靠的流程是先理解專案與重現問題,再規劃小範圍修改、檢查差異並執行相關測試。本篇用一個簡單的活動人數函式示範完整工作順序。你不需要一開始就交出整個應用程式,也能學會如何給資料、判斷修改是否對題,以及儲存驗證結果。閱讀全文。
/terminal-setup:設定支援的編輯器終端機多行輸入快捷鍵。
/voice:切換 CLI 語音輸入;需啟用對應功能;子指令:model。
/upgrade:查看 Code Assist 升級入口;Google 登入條件適用。延伸:CLI 認證CLI 認證:Google 帳號、API Key 與計費Gemini CLI 的登入方式會影響可使用的服務、額度與計費歸屬。本篇帶你比較 Google 帳號登入、Gemini API Key 與 Vertex AI,完成適合自己的認證,並用最小對話驗證。重點是知道目前到底使用哪個帳號與專案,而不是只看到登入成功就假設所有功能都包含在訂閱裡。閱讀全文。
模型與對話:操作後確認影響
模型選擇可從 /model manage 開啟介面,或用 /model set 加上你帳號可用的模型識別字;需要持續儲存時,先檢視該版本提供的 persist 行為。不要把網頁版模式名稱當成 API 或 CLI 模型識別字,也不要把切換成功當成所有工具都已支援新模型。
對話太長時用 /compress 整理上下文,但重要需求仍應儲存在你可查閱的檔案。要找舊工作用 /resume,要另開新工作階段用 /clear;這些操作與清除本機檔案不同。完整恢復、匯出與還原範例見對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文,執行還原前先讀清楚會影響對話、檔案或兩者。
終端機引數與語法速查
終端機命令以 gemini 開頭。單次非互動提問使用 -p,選輸出格式用 -o;恢復最近工作階段可用 --resume latest。先用 --help 檢視當前版本,再把需要的引數放入腳本,不要從不同年代文章各抄一段組合。
gemini --version
gemini --help
gemini --resume latest
gemini -p "請列出公告摘要應核對的欄位,不使用工具。" -o json
@ 是檔案與資源引用入口,! 是 shell 命令入口;兩者都不是一般的文字裝飾。需要路徑、引號與背景工作說明時閱讀檔案與 shellCLI 檔案與命令:@、! 與路徑Gemini CLI 可以引用檔案,也能執行作業系統命令,但這兩種輸入的效果完全不同。本篇用一份虛構公告示範 @ 檔案引用、! shell 命令、路徑與工具結果核對。學完後,你能清楚知道資料有沒有被讀取、命令有沒有執行,以及下一步應檢查哪個結果。閱讀全文。要把短提示詞存成自己的 /summary,閱讀TOML 自訂指令自訂斜線指令:TOML、參數與重新載入自訂斜線指令可以把經常重複的提示詞存成 Gemini CLI 的快捷操作。例如每次整理公告都要保留日期、地點與缺漏資料,可以包成 /summary。本篇從不執行 shell 的純提示詞指令開始,教你建立 TOML、傳入引數、重新載入及檢查結果。閱讀全文,不要把自訂名稱誤列為所有讀者都有的內建命令。
常見問題與版本更新
「官方文件有 /shells,我卻找不到」這份 0.59.0 載入器清單提供 /tasks,另有 bg 與 background 別名。遇到檔案差異時,以本機 help 與版本化清單交叉核對。不要為了讓舊指令可用,就任意安裝不明套件。
「/extensions install 能不能在 CLI 裡用」0.59.0 在啟用對應功能時提供互動子指令,但部分官方文件仍以終端機管理為主。本系列完整安裝範例採 gemini extensions,讀者比較容易辨識輸入位置;擴充教學MCP 與 Extensions:安裝、驗證與停用MCP(模型上下文協定)讓 Gemini CLI 使用外部工具與資料;Extensions(擴充套件)則把工具設定、提示詞與其他資源包成可安裝的套件。本篇教你分辨兩者,完成安裝前檢查、檢視連線狀態、執行一個小型讀取測試,再停用不需要的能力。閱讀全文會帶你完成安裝、重啟與連線驗證。
「/bug-memory 可以當一般記憶功能嗎」不適合,它是寫出程式記憶體快照供除錯的功能,可能包含工作資料。專案規則請使用 GEMINI.md 與 /memory;需要回報問題時先檢查資料內容與儲存位置,不把診斷檔直接當作普通教學附件公開。
新增命令前,先記錄來源屬於內建、專案 TOML、擴充套件或 MCP。把這四種來源分清楚,才知道更新或停用應到哪裡操作。若清單與預期不同,依疑難排解CLI 疑難排解:登入、PATH 與設定失效Gemini CLI 發生問題時,先找出失敗層級,通常比重新安裝所有工具更有效。本篇建立一條可重複使用的排查路線:從找不到命令、登入失敗,到檔案權限、額度及設定未載入。你會得到能儲存的診斷紀錄,並知道修正後要重跑哪個最小測試。閱讀全文從版本、目錄與功能狀態開始查。
完成後的檢核
| 檢查項目 | 通過條件 |
|---|---|
| 操作 | 能依正文重做一次,說明每一步使用的輸入。 |
| 結果 | 能用原始資料或可重現測試核對輸出,而非只看語氣。 |
| 延伸 | 知道下一篇教學解決的問題,以及什麼時候需要它。 |
接著可以閱讀 CLI 檔案與命令CLI 檔案與命令:@、! 與路徑Gemini CLI 可以引用檔案,也能執行作業系統命令,但這兩種輸入的效果完全不同。本篇用一份虛構公告示範 @ 檔案引用、! shell 命令、路徑與工具結果核對。學完後,你能清楚知道資料有沒有被讀取、命令有沒有執行,以及下一步應檢查哪個結果。閱讀全文、CLI 對話管理CLI 對話管理:恢復、壓縮與匯出長對話、工作中斷與切換任務,是使用 Gemini CLI 時常見的情況。本篇教你找回工作階段、儲存命名檢查點、壓縮上下文與匯出資料,並分清楚清除畫面、恢復對話和還原檔案的效果。目標是保留能繼續工作的資訊,也知道哪些狀態必須重新確認。閱讀全文,把本篇的操作接到下一個工作流程。
返回 Gemini 教學總目錄Gemini 完整教學:電腦、手機、CLI 與 Google AI 應用這裡整理 Gemini、Google AI 與開發工具的教學。可以按分類找功能、按自己的需求走學習路線,也可以搜尋「MD」「手機」「PDF」「/memory」等關鍵字。每篇都提供步驟、可複製範例、結果核對方式與延伸閱讀,不需要從第一篇一路讀到底。閱讀全文
覺得這篇整理實用嗎?分享給需要的朋友
同主題延伸閱讀
生活分享
完整實作:文件摘要與資料擷取工具
這篇把前面學過的提示詞、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 的操作直接套程式式。
引用本文的文章
資料來源
- Gemini CLI:官方指令參考查證日期:
- Gemini CLI 官方程式碼查證日期:
本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。