tech

Claude Code / Codex / Grok / Antigravity 安裝教學：零基礎、Mac＋Windows 一步一步

完全沒碰過終端機也能跟著裝。手把手教你在 Mac 與 Windows 安裝四個桌面版 AI 命令列工具（Claude Code、Codex、Grok Build、Antigravity agy）：怎麼開終端機、複製貼上哪一行、裝完怎麼登入怎麼用，還有新手最常卡的坑。挑你訂的那一個裝就好。教學文。

  • claude-code
  • codex
  • grok
  • antigravity
  • cli
  • tutorial
  • beginner
  • education

這篇寫給完全沒碰過終端機、看到黑色視窗會怕的人。你訂了哪一個 AI 工具，就跟著那一段一步一步複製貼上，就能在電腦上裝好、開始用。四個（Claude Code / Codex / Grok / Antigravity）挑一個裝就好，不用全裝。 Mac、Windows 都有；不同終端機也都講清楚。

先搞懂三個名詞（30 秒）

  • 終端機（Terminal）：一個可以打字下指令給電腦的黑色（或白色）視窗。你等一下所有動作，都是「在終端機裡貼一行字、按 Enter」。
  • CLI：Command Line Interface，命令列。就是「用打字、而不是點滑鼠」來操作程式。
  • AI 命令列助手：像 Claude Code 這種，你在終端機裡用自然語言（中文也行）叫它幫你寫程式、改檔案、查資料，它會自己動手做。

你不需要會寫程式。 你只需要會「複製一行指令、貼進終端機、按 Enter」。

第 0 步：先打開終端機

Mac

  • 內建終端機：按 Command + 空白鍵 打開 Spotlight，輸入 Terminal（終端機），按 Enter。
  • 想更好用（選配）：可以裝 iTerm2（免費，功能更多），但內建的就完全夠用，新手直接用內建。

Windows（請放心，一步一步來）

Windows 的「終端機」有好幾種，名字很像、很容易搞混。先看這張表，知道各是什麼、什麼時候用哪個就好，不用全部背：

終端機名稱它是什麼這篇什麼時候用它
PowerShellWindows 內建的藍色（或黑色）視窗裝 Claude Code、Codex、agy 都用它
Windows Terminal比較新、比較漂亮的外殼，裡面一樣能開 PowerShell有就用，沒有也沒差
Git Bash讓 Windows 也能跑 Mac/Linux 指令的視窗（要另外裝）這篇四個工具都用不到（進階才會用）
命令提示字元（cmd）很舊的黑色視窗這篇用不到，別選它

新手只要記一句：這篇 Windows 全部都開「PowerShell」就好。（另外還有 Git Bash、WSL 等進階終端機，新手先完全不用管。）

怎麼打開 PowerShell（跟著做，一步都別跳）

  1. 按鍵盤左下角的 開始鍵（有 Windows 田字標誌那顆），或用滑鼠點螢幕左下角的開始按鈕。
  2. 直接用鍵盤打字：powershell（不用先點任何框，打了它就會自己開始搜尋）。
  3. 畫面上方會出現「Windows PowerShell」的圖示（一個藍色、有 >_ 符號的圖案）。用滑鼠點它一下。
  4. 跳出一個藍色（或黑色）的視窗、裡面有游標在閃 → 成功了！這就是「終端機」。等一下所有指令都是貼進這個視窗、按 Enter。

關於「系統管理員」：這篇大部分步驟不需要管理員權限，直接照上面開就好。萬一某一步真的叫你要管理員，再回到第 3 步時：對「Windows PowerShell」圖示按滑鼠右鍵 → 選「以系統管理員身分執行」。

怎麼把指令貼進 PowerShell：先在網頁上複製指令，滑鼠移到 PowerShell 視窗裡面，按一下右鍵就會自動貼上（或按鍵盤 Ctrl + V），再按 Enter。

開始前提醒

  • 安全：安裝指令會「下載並直接執行」網路上的東西，所以只從本文列出的官方網址複製指令，別從搜尋廣告、論壇、來路不明的貼文複製「安裝指令」（那可能是假的）。
  • 系統太舊可能裝不上：大致要 macOS 13 以上 ／ Windows 10 以上；太舊的電腦可能裝到一半失敗。

安裝 Claude Code（Anthropic）

Claude Code 是 Anthropic 出的 AI 命令列助手。有兩種裝法，新手用第一種就好。

方法 A：官方安裝器（推薦，不用先裝別的東西）

這種方式不需要先裝 Node.js，它會自己處理好一切，還會自動更新。

Mac / Linux — 打開終端機，貼上這行按 Enter：

curl -fsSL https://claude.ai/install.sh | bash

Windows（一步一步，別跳）：

  1. 照前面「怎麼打開 PowerShell」開好那個藍色視窗。
  2. 複製下面這一整行，滑鼠移到 PowerShell 視窗裡按右鍵貼上（或 Ctrl + V），按 Enter：
irm https://claude.ai/install.ps1 | iex
  1. 它會開始自己下載、安裝，畫面會跑一堆字，你什麼都不用做，等它跑完、出現一個新的游標在閃就好（大約 1–2 分鐘，慢一點正常）。

裝完後（Mac、Windows 都一樣）：把這個終端機視窗整個關掉，重新打開一個新的（很重要，不然它認不得剛裝好的指令），在新視窗輸入：

claude

第一次執行，它會自動跳出瀏覽器要你登入你已訂閱的 Claude 帳號，照著點一點就完成。

方法 B：用 npm 安裝（進階／已經有 Node.js 的人）

如果你之後想寫程式，或已經裝過 Node.js，可以用這種。需要 Node.js 22 以上版本。

先確認有沒有 Node（在終端機輸入）：

node --version

沒有的話，去 nodejs.org 下載「LTS」版裝好。有了之後：

npm install -g @anthropic-ai/claude-code

不要在前面加 sudo。如果出現權限錯誤，正確做法是改用 nvm（把 Node 裝在你自己的資料夾），不要用系統管理員硬裝。

裝好之後怎麼用（第一次上手）

  1. 先建一個乾淨的練習資料夾再進去（不要直接在桌面、文件、或放機密的資料夾裡跑）：
    • Mac：mkdir -p ~/Desktop/ai-practice && cd ~/Desktop/ai-practice
    • Windows：mkdir $HOME\Desktop\ai-practice ; cd $HOME\Desktop\ai-practice
  2. 輸入 claude 進入。
  3. 直接用中文打你要它做的事，例如：
    • 「幫我在這個資料夾建一個簡單的網頁，標題寫『我的第一頁』」
    • 「這個資料夾在幹嘛？用白話解釋給我聽」
  4. 它會提出計畫、動手改檔案，做重要動作前會問你同不同意——看清楚再答應，別無腦一直按「全部允許」。
  5. 常用：打 /help 看指令、/clear 清空重來、/exit 離開。

裝好了，這樣你就會用了。 如果你只訂 Claude，到這裡就結束，不用往下看其他工具。

安裝 Codex CLI（OpenAI）

Codex 是 OpenAI 的 AI 命令列助手，工程能力很強。

Mac / Linux（推薦，最簡單） — 貼上這行按 Enter：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Mac（已經裝過 Homebrew 的人才用這個）：

brew install --cask codex

沒裝過 Homebrew 的話，這行會顯示 brew: command not found——新手直接用上面那行官方腳本就好，不用碰 Homebrew。

Windows — 照前面「怎麼打開 PowerShell」開好視窗，貼上這一整行按 Enter：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

用 npm（跨平台，需先裝 Node.js，建議裝最新 LTS 版）：

npm install -g @openai/codex

裝完關掉終端機重開，輸入：

codex

第一次會要你用你已訂閱的 ChatGPT 帳號登入（瀏覽器點一下）。

  • 小技巧：在一個 git 資料夾裡跑 Codex，改動比較好追蹤、還原——但注意 git 只能還原「已經提交」的檔案，不是萬能復原，重要資料自己先另外備份。
  • 怎麼用：進到你的資料夾輸入 codex，直接打中文叫它做事（例：「幫我在這個資料夾建一個簡單網頁」）；打 / 看指令、/exit 離開。

安裝 Grok CLI（xAI，叫 Grok Build）

Grok Build 是 xAI（馬斯克的 AI 公司）出的，底層是 Grok 4.5。

Mac / Linux — 打開終端機，貼上這行按 Enter：

curl -fsSL https://x.ai/cli/install.sh | bash

Windows — 照前面「怎麼打開 PowerShell」開好視窗，貼上這行按 Enter：

irm https://x.ai/cli/install.ps1 | iex

裝完關掉終端機重開，到你的資料夾輸入：

grok

第一次會打開瀏覽器要你登入（用你付費的 xAI 帳號）。

  • 怎麼用：進到你的資料夾輸入 grok，直接打中文叫它做事；打 / 看指令、/exit 離開。

安裝 agy（Google Antigravity CLI）

agy 是 Google 出的 AI 命令列助手，是舊「Gemini CLI」的接班人（Gemini CLI 已於 2026 年退役）。它是單一執行檔，不需要 Node 或 Python。

Mac / Linux：

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows — 照前面「怎麼打開 PowerShell」開好視窗，貼上這行按 Enter：

irm https://antigravity.google/cli/install.ps1 | iex

裝完關掉終端機重開，輸入：

agy

第一次執行會自動用你的 Google 帳號登入，跟著畫面點一點就好。如果你以前用過 Gemini CLI，它會自動幫你把舊設定搬過來。

  • 開新對話：agy；接續上一次對話：agy -c。
  • 怎麼用：進到你的資料夾輸入 agy，直接打中文叫它做事。

常見卡關（新手必看）

  • 找不到指令 / command not found：先把終端機整個關掉、重開一個新的（新指令要重開才生效）。還是找不到，多半是「PATH 沒設好」：Mac 打 command -v claude、Windows 打 Get-Command claude（其他工具換名字）看找不找得到；照安裝完顯示的路徑把它加進 PATH 再重開。
  • 裝完怎麼確認成功？：打 claude --version（或換成你裝的 codex / grok / agy），有跳出版本號才算裝好；只跳紅色錯誤字＝沒成功，別當作好了。
  • Windows 出現藍色「Windows 已保護你的電腦」（SmartScreen）：點「其他資訊」→「仍要執行」。（只在你是從本文的官方網址安裝時才這樣做。）
  • Windows 說「無法載入腳本／執行原則限制」：先在 PowerShell 貼 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 按 Enter、輸入 Y，再重跑安裝指令。
  • Mac 跳「要安裝命令列工具」或「無法驗證開發者」：前者按「安裝」同意；後者到「系統設定 →『隱私權與安全性』」按「仍要打開」。
  • 公司電腦／防毒把下載擋掉：不要關掉防毒；交給公司 IT，或換自己的電腦裝。
  • 叫我加 sudo？：只有 Mac/Linux 用 npm 全域安裝才會遇到權限問題，不要用 sudo 硬裝（照官方建議用 nvm）；Windows 沒有 sudo。
  • 登入視窗沒跳出來：把終端機顯示的那串網址複製、貼到瀏覽器打開；並確認瀏覽器已經登入你「付費的那個帳號」。

這篇之後可能會更新（這些工具版本更新很快）。安裝前若指令跑不動，以各家官方頁為準：Claude Code、Codex、Grok Build、Antigravity。

Markdown 原文