AI CLI 工具是在 terminal 裡工作的助手和 coding agent。你描述任務後,工具會依它的權限設定讀取專案、提出或執行修改、執行指令,再回報結果。它們不會取代你界定範圍、核准有風險的動作,以及檢查成果的責任。
這篇指南寫給從沒打開過 terminal、也沒裝過開發工具的人。你會學到足以在暫存專案資料夾開始的基本操作,比較三個目前常見的工具,並依帳號和預算選擇路線。範例是起點,不保證每個專案都不用設定、審查或付費用量就能完成。
Terminal 是什麼?為什麼你要在意?
你已經知道怎麼跟電腦溝通。你點東西、拖東西、按按鈕,那是圖形介面:圖示、視窗和選單。Terminal 是另一種介面。你輸入指令並收到文字回覆,適合重複性的工作,也適合需要存取本機專案的工具。
一般瀏覽器聊天主要是在瀏覽器裡回傳文字。CLI 工具則設計成在你啟動它的資料夾裡工作,因此可以使用你允許的本機檔案和指令。這份存取權很有用,也代表你要先進入正確資料夾、閱讀權限提示,並在分享或部署前檢查修改。
搞定一切的四個指令
你不用背一百個指令,先從四個開始。
ls:看看四周。
顯示目前位置的檔案和資料夾。它就像在 Mac 打開 Finder,或在 Windows 打開檔案總管查看資料夾。
ls
cd:移動到一個資料夾。
cd 是「change directory」的縮寫,用來進入資料夾。
cd Documents
cd .. 會往上移一層,兩個點代表上層資料夾。
mkdir:建立新資料夾。
建立資料夾,不會改動電腦其他地方。
mkdir my-project
接著可以執行 cd my-project 進入它。
pwd:我在哪裡?
印出目前位置的完整路徑。
pwd
你可能會看到 /Users/yourname/Documents/my-project。請在要求 agent 修改檔案前先確認位置。
這四個指令足以讓你用文字瀏覽專案。Agent 可以協助其他指令,但你仍應知道它在哪個資料夾工作。
怎麼打開 Terminal
- Mac:按
Cmd + Space,輸入「Terminal」,按 Enter。 - Windows:按 Windows 鍵,輸入「PowerShell」,按 Enter。
- Linux:打開你的發行版提供的 terminal 應用程式。
Terminal 會執行你核准的指令。因此,看到不熟悉的指令時先停一下,特別是會刪檔案、改系統設定、下載軟體或把資料送到服務的指令。
安裝你的第一個 AI CLI 工具
這篇先用 Claude Code 完成第一次對話。Claude Code 由 Anthropic 開發,設計成在 terminal 裡讀取和修改專案。目前的 Claude Code 安裝文件建議使用原生安裝。原生 binary 執行時不需要 Node.js runtime。
第一步:用原生安裝器安裝 Claude Code
目前的 Claude Code 安裝文件建議使用原生安裝器。安裝後的 binary 執行時不需要 Node.js runtime,因此這條路線不必先裝 Node.js。依你的作業系統選擇指令,完成後開一個新的 terminal 視窗確認安裝:
macOS 或 Linux(在 Bash 或 Zsh 執行):
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows 命令提示字元(Command Prompt):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
原生 Windows 安裝不需要 Administrator 權限。如果使用 WSL,請在 WSL terminal 裡執行 macOS/Linux 指令,不要從 PowerShell 或命令提示字元執行。安裝完成後開新的 terminal,執行:
claude --version
如果找不到指令,先依安裝文件的 PATH 排查處理,不要猜測是缺少 Node.js。
替代路線:npm 安裝
原生安裝成功後,可以跳過這一節,直接進行下方的登入步驟。npm 是另一條安裝路線。如果選擇 npm,官方目前要求安裝套件時使用 Node.js 22 以上。先查看版本:
node --version
接著安裝套件:
npm install -g @anthropic-ai/claude-code
npm 套件安裝的也是原生 binary,執行時不會呼叫 Node.js。-g 代表依你設定的 npm prefix 全域安裝套件。確認指令可用:
claude --version
不要執行 sudo npm install -g。官方安裝文件提醒,這可能造成權限和安全問題。
第二步:登入並理解帳號邊界
在專案資料夾執行 Claude Code:
claude
目前設定文件列出的 Claude Code 存取方式包括 Pro、Max、Team、Enterprise 或 Console 帳號,以及 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 等支援的第三方服務。免費 claude.ai 方案不包含 Claude Code 存取權。依你選擇的帳號路線,跟著瀏覽器提示登入。
Claude 訂閱和 Anthropic Console/API 用量是不同的計費路線。Console 使用 API credits,依 API 標準價格計費;訂閱不會自動把 API 呼叫變成免費。選方案前查看 Anthropic 最新定價、Claude Code 安裝與驗證文件,以及 API credit 說明。價格、額度和功能可能因地區而異,也會變動。
比較想用 Google 的 CLI?
個人使用者應從 Antigravity CLI 開始,不要再照舊的 Gemini CLI 免費帳號教學操作。Google 的轉換公告自 2026 年 6 月 18 日起適用於免費 Gemini Code Assist 個人方案及 Google AI Pro/Ultra 使用者。
打開官方入門文件,選擇 Antigravity CLI 及你的作業系統,依文件完成安裝與登入。安裝後,在專案資料夾確認版本並啟動:
agy --version
agy
Antigravity 的使用限制依目前方案計算,不要套用 Gemini CLI 舊的每天 1,000 次或 250 次數字。既有 Gemini CLI 使用者可依移轉指南處理設定。Gemini CLI 本身仍可用於受支援的 Code Assist Standard/Enterprise 和付費 API 路徑,不是舊教學描述的免費個人帳號路線。查核日為 2026 年 10 月 27 日。
本文後面的範例使用 Claude Code。其他 client 的指令和額度不同,但基本循環相近:在確認過的資料夾工作,描述任務,閱讀權限和修改,最後驗證結果。
Codex CLI 呢?
OpenAI 目前的 Codex CLI 文件列出 macOS/Linux、Windows、npm 和 Homebrew 的安裝選項。安裝後,進入專案資料夾,執行 codex,再選 Sign in with ChatGPT 或其他可用的驗證方式。請依作業系統選擇官方文件中的安裝方式。
依 OpenAI 最新的 ChatGPT 方案說明,Codex 包含在 Free、Go 等 ChatGPT 方案中,但各方案額度不同。Codex Cloud 的資格條件另計。API key 用量則是獨立的 OpenAI API 計費路線,不要把 ChatGPT 訂閱寫成一般 API credits 餘額。
在 Terminal 裡和 Agent 的第一次對話
先建立新的資料夾,確定 agent 能看到哪些檔案:
mkdir my-first-project
cd my-first-project
啟動 Claude Code:
claude
你會看到輸入提示。先問一個小問題:
What can you do in this project, and what would you need permission to change?
它應該會說明可用工具和限制。不要假設所有工具、shell 指令或外部連線都已啟用,先讀它的回答。
接著請它製作一個小型靜態頁面:
Create a single index.html webpage about cats. Include a title and three fun facts. Use a modern, accessible layout and explain which files you plan to create before editing them.
先看它提出的檔案和指令。若 agent 要求核准,只核准你理解的內容。完成後檢查檔案,再用瀏覽器開啟:
- Mac:
open index.html - Windows:
start index.html
本機 HTML 頁面適合作為第一次練習,因為影響範圍小。但它不能證明大型應用程式安全、正確或可以直接發布。
你今天可以做的四個專案
下面每個專案都有獨立文章,提供步驟說明。請把它們當成範例:依專案和服務商不同,相依套件、主機條款、權限和成果品質都會變。
從一句話到一個跑起來的 App
描述一個小型 app 點子,例如習慣追蹤器、記帳工具或閱讀清單。請 agent 先提出技術選擇、建立專案、說明相依套件和執行方式,再逐一檢查產生的檔案與指令。
打造和上線一個 Landing Page
你可以描述版面、配色方向和內容,再請 agent 產生 HTML 和 CSS。部分主機商提供免費方案,但網域、頻寬、建置時間和其他服務可能收費。承諾免費部署前,先查看服務商目前條款。
把你的專業變成一個工具
描述你熟悉的規則或工作流程,例如餐食規劃計算機、紅酒搭配指南或語言學習練習。請 agent 把規則做成小型介面,再用自己的領域知識測試邊界案例。
整理多年散落各處的筆記
先把筆記匯出一份副本到工作資料夾,為分類方式訂出計畫。保留原檔不動。請 agent 先提出資料結構和一小批轉換結果,再處理大量檔案。個人、機密或受法規規範的資料,需要額外做隱私檢查。
選擇適合你的工具
下面幾種選項的開發者、安裝路線、登入方式和費用邊界都不同。先確認自己能使用的帳號、電腦適用的安裝方式,以及願意負擔的費用。
| Claude Code | Google CLI 選項 | Codex CLI | |
|---|---|---|---|
| 開發者 | Anthropic | OpenAI | |
| 安裝 | 建議原生安裝;npm 替代路線安裝時需要 Node.js 22 以上,但原生 binary 執行時不需要 Node | 個人使用者用 Antigravity CLI 安裝程式;Gemini CLI 須先確認帳號仍受支援 | 依目前官方文件選 standalone、npm、Homebrew 或 Windows 路線 |
| 登入 | 執行 claude,再使用支援的 Claude/Console/第三方服務帳號或 API key | 以適用的 Antigravity 帳號執行 agy;Gemini CLI 的企業/API 路徑另計 | 執行 codex,再使用 ChatGPT 或其他可用方式 |
| 費用邊界 | Claude 方案用量和 Console/API credits 分開;免費 claude.ai 方案不含 Claude Code | Antigravity 方案限制不是 Gemini CLI 舊的每日額度 | ChatGPT 方案額度和 API key 用量分開;Codex Cloud 另有資格條件 |
| 官方起點 | 安裝與驗證 | Antigravity 入門文件 · 轉換公告 | Codex CLI 文件 |
想看持續變動的更大範圍,可讀 AI CLI 工具指南。安裝或估算預算前,再次查看各家的官方文件。
常見的恐懼,以及比較安全的預設
「我會不會把電腦弄壞?」
在專案資料夾啟動 agent,不代表核准的指令只能影響該資料夾。如果你允許,它仍可能修改外部檔案或系統。先使用暫存目錄、保留備份、閱讀指令和檔案清單,在熟悉流程前不要給過寬的權限。專案資料夾是整理邊界,不保證電腦其他地方無法存取。
「我需要學寫程式嗎?」
你可以沒有程式經驗就開始。如果你學會辨識檔案、相依套件、資料處理和檢查方式,成果會更容易掌握。不必在求助前讀懂每一行,但你應該能審查哪些內容會執行,以及哪些內容會被發布。
「這貴嗎?」
沒有一個適用所有新手專案的可靠固定成本。Claude Code 可以走訂閱或 Console/API credits;Google 的個人使用者路線依 Antigravity 目前方案計算,受支援的 Gemini CLI 企業/API 路徑另有計費方式;Codex 可以使用 ChatGPT 方案額度或獨立 API 憑證。主機、網域和套件也可能增加費用。開始前先查看上面連結的官方價格和額度頁。
「如果 AI 犯錯怎麼辦?」
它有時會產生不完整、不安全或錯誤的成果。請它解釋修改,檢查 diff,執行相關測試,並把重要結果和可信來源比對。視覺頁面要在瀏覽器檢查;資料轉換要保留原檔,先比對一小批再處理全部。
「我以前試過寫程式,覺得很痛苦。」
你可以用白話提出需求,不必先背語法。Terminal 仍是技術環境,因此要預期會學幾個指令、讀錯誤訊息,並決定權限和資料如何流動。目標不是假裝這些決策消失,而是在你掌握結果的前提下,把重複工作交給工具協助。
下一步:從新手到進階使用者
熟悉 terminal 之後,可以增加一些結構。第一次做網頁不需要立刻使用以下功能。
專案指令。 Claude Code 可以讀專案中的 CLAUDE.md,套用其中記錄的慣例。內容要具體、可檢查,而且只放這個專案需要的規則。Claude Code 文件說明目前的載入和設定行為。
MCP servers。 Model Context Protocol 能把 agent 連接到外部工具和資料。每個 connector 都是新的權限和資料分享邊界。啟用前先看文件、憑證政策和允許的動作。
Multi-agent workflows。 多個 agent 可以分別處理不同任務,但平行工作也會增加協調、權限和審查成本。先從一個小任務開始,定義輸出如何檢查,再依你的專案實際衡量是否有幫助,不要先假設一定提高生產力。
想深入了解 multi-agent workflow、context engineering 和進階 AI CLI 策略,可讀 AI Agent Workflow Guide。
在 Termdock 試一次交接
想先練習,不必一開始就開很多 agent。在 Termdock 開啟一個你有權使用的小專案,於終端啟動已安裝的 CLI,請它修改一個小地方並列出改動和測試結果。完成後,你可以開另一個終端,讓已安裝的另一個 CLI 或新 session 對照需求檢查修改;記得把需求和檔案位置再說一次。最後由你檢查結果。需要自動交接時,再看 Termdock 教學;兩個工具各自的登入和費用不包含在 Termdock 裡。
實際的下一步
AI CLI 工具可以縮短從想法到本機原型的距離,但不會取代規劃、權限、來源查核、測試和人類責任。先在小資料夾做一個可以檢查的修改,再加入相依套件、外部服務或部署。
這篇指南的四個專案是起點:小型 app、Landing Page、特定領域工具,或可搜尋的筆記結構。選一個你有權使用的資料集,保留原始副本,讓 agent 協助你能驗證的工作。
打開 terminal,輸入一個清楚的要求,先看它打算做什麼。