環境建立
Agent 尚無法協助的一段:帳號、Git、VS Code,以及選一個 agent
這是唯一一份需要親自照做的文件。完成最後的最小測試之後,其餘安裝與設定都可以交給 agent 處理。
為什麼這份文件要自己做
Agent 能協助工作的前提,是它已經能在你的電腦上執行。在那之前的幾個步驟, 申請帳號、安裝 Git 與 VS Code、裝好 agent,它無法代勞,這是整門課唯一需要照著操作的部分。
完成本頁最後的「最小測試」之後,往後遇到任何安裝或設定問題,都可以直接詢問 agent。
各家工具變動很快;若本頁步驟與你看到的畫面不同,請回報講師更新。
第一步:帳號
GitHub 帳號一定要有;agent 的帳號依你選擇的那一家申請一個即可。
| 帳號 | 用途 | 費用 |
|---|---|---|
| GitHub | 存放你的知識工作 repo、閱讀課程教材 | 免費 |
| Anthropic/Claude | 使用 Claude | 需 Pro 訂閱(每月 20 美元) |
| OpenAI/ChatGPT | 使用 Codex | Plus 訂閱(每月 20 美元);免費額度較少 |
| 使用 Antigravity | 免費 |
第二步:Git
Git 負責版本紀錄,agent 每完成一個階段就會替你 commit 一次。
- 到 git-scm.com 下載安裝程式。Windows 依預設選項安裝即可;macOS 也可以直接開啟「終端機」輸入
git --version,依提示安裝命令列工具。 - 姓名與 email 的設定不必自己做,最小測試時請 agent 代為設定。
第三步:VS Code
VS Code 是編輯器,也是 agent 的工作畫面:檔案、對話、版本紀錄都在同一個視窗。
- 下載並安裝 VS Code。
- 開啟後點左下角的帳號圖示,以 GitHub 帳號登入;之後把 repo 發布到 GitHub 只需按一個按鈕。
- 需要中文介面的話,在擴充套件搜尋「Chinese (Traditional)」安裝語言套件。
第四步:選一個 agent
擇一安裝即可。同事使用哪一家就跟著用,方便互相支援。
Claude(Anthropic)
- 在 VS Code 的擴充套件搜尋「Claude Code」安裝。
- 以 Claude 帳號登入(需 Pro 訂閱)。安裝細節見官方說明。
Codex(OpenAI)
- 在 VS Code 的擴充套件搜尋「Codex」安裝,或依官方頁面指示。
- 以 ChatGPT 帳號登入。
Antigravity(Google)
Antigravity 是以 VS Code 為基礎的獨立程式,安裝後不必另外開啟 VS Code,操作方式相同。
- 下載並安裝 Antigravity。
- 以 Google 帳號登入。
第五步:最小測試
這是「agent 開始能協助你」的分界線。
- 在容易找到的位置建立一個資料夾,命名為
my-knowledge-work。 - 用 VS Code(或 Antigravity)開啟該資料夾,打開 agent 的對話側欄。
- 把這段話交給 agent:
請在這個資料夾初始化 git;若尚未設定 git 的姓名與 email,請用我 GitHub 帳號的資料設定。接著建立一個 README.md,寫一句說明這個專案是我的知識工作專案,然後 commit。
- 打開左側「原始檔控制」面板,看到一筆 commit 即告完成。
- 按「發布到 GitHub」把 repo 推上去,之後每次上課都從這裡接續。
從這一刻起,之後所有的安裝與設定都可以請 agent 協助。