AO 代理 AI 工作流 · Agent OS ← 總覽

模組 3 ｜ 必備工作環境

工作環境｜懶人包一鍵設定

很多人卡在「AI 工具裝不起來」這一關就放棄了。其實整套環境的核心心法只有一句話：不要自己一行一行裝，讓 AI 讀懶人包自己裝。本模組帶你把帳號、軟體、API 一次備齊，並用一個 .md 檔讓 Claude / Codex 自動完成環境檢查、安裝工具、引導註冊、測試連線——你只負責「該登入就登入、該收驗證碼就收驗證碼」。

讀完這一頁你會：擁有一套完整可運作的 AI 工作環境（Claude/Codex 能操控檔案、連 GitHub、接 Obsidian、串資料庫、會生圖），而且日後換電腦只要把懶人包拖進去就能複製。

核心心法

什麼是「懶人包（.md）一鍵設定」？

所謂懶人包，就是一份寫好的 Markdown（.md）文件，裡面用 AI 看得懂的格式，把「環境檢查 → 安裝工具 → 引導你註冊 → 測試連線」整套流程寫成步驟。你不需要懂 Node、Git、uv 是什麼，把檔案丟給 AI，它會照著做。

為什麼用 Markdown？對 AI 而言，Markdown 是最容易閱讀、最容易理解的格式。和 AI 溝通、給它一份 SOP，Markdown 永遠是最佳格式——這也是後面 Skills、筆記、文件全部用 .md 的原因。

五步驟，套用任何一份懶人包

  1. Step 01

    下載 .md 檔。從教學提供的網頁／GitHub 找到對應懶人包（例如「02 連接 GitHub.md」），按右上角「Download raw file」把原始檔存下來。

  2. Step 02

    開一個工作資料夾。打開 Claude Code（或 Codex）桌面版，新建一個專案、選一個資料夾當工作目錄；同意「信任這個 Workspace」。

  3. Step 03

    把 .md 拖進對話。直接把懶人包檔案拖曳到對話視窗裡並送出。建議先到設定把權限調成「Bypass Permissions（略過逐次確認）」，省去一直按同意。

  4. Step 04

    說「執行這個懶人包」。AI 開始跑環境檢查、自動安裝缺的工具（Node、Git、uv、各種 CLI / MCP），需要你登入或填驗證碼時會停下來提示。

  5. Step 05

    配合「人類動作」＋測試連線。你只要在它喊停時去登入帳號、貼上驗證碼。裝完它會自動測連線（例如部署一個測試網站、列出資料庫專案）回報成功。

「真的需要你動手的，通常只有去登入、或是收驗證碼。」
幫我執行這個懶人包：先做環境檢查，
缺什麼工具就自動安裝，
需要我登入或填驗證碼時請停下來告訴我，
全部裝完後測試連線並回報結果。

第一步準備

必備帳號清單

懶人包執行到一半，會引導你去註冊各種服務。先把下面這幾個帳號的「註冊方式」與「注意事項」搞清楚，跑起來就不會卡住。多數平台都能用 Google 帳號一鍵註冊，省去記密碼。

帳號 用途 註冊重點
Claude 主力 AI（Chat／Cowork／Code） 需電話驗證，並訂閱付費方案才能啟用 Cowork / Code 等進階功能
GitHub 程式 / 文件倉庫、網頁部署 可用 Google 帳號註冊；設好 username、密碼、過拼圖驗證；之後把 username 與 email 告訴 AI
Google Drive 同步、NotebookLM、第三方登入 幾乎所有服務的「萬用鑰匙」，大多平台都能用它一鍵註冊
Supabase / Firebase 免費雲端資料庫 擇一即可。Supabase 用 GitHub 帳號註冊、有官方 MCP 好操控；Firebase 設定較繁瑣但容量大、無時間限制
OpenAI GPT-Image 生圖 API（也是 Codex 帳號） 需儲值＋身份驗證才能用 API；Key 安全步驟見下一節（非常重要）
新手選哪個資料庫？先用 Supabase（GitHub 帳號就能註冊、有官方 MCP，用自然語言就能操控）。等熟了、需要更大容量再考慮 Firebase。兩者都完全免費就能起步。

先裝好這些

必備軟體

這幾個是「手動先裝好」的圖形介面軟體；至於底層的 Node.js、Git、uv 這類開發工具，不用你自己裝——懶人包執行時 AI 會偵測缺哪個就自動補上。

01

Claude Code / Codex 桌面版

整套環境的大腦。能讀寫本地檔案、安裝套件、跑程式、接 MCP。Codex 能力與 Claude Code 相近但更省錢，兩者懶人包幾乎共通。

02

Obsidian

AI 的「第二大腦」。筆記全是 Markdown，最適合給 AI 直接讀寫，日後打造會自動成長的知識庫就靠它。先裝好但先別急著開啟，等懶人包指示。

03

Google Drive 桌面版

負責把 Obsidian Vault、專案資料夾同步到雲端，讓你換機也能接續。安裝後要等檔案總管／Finder 出現 Google Drive 並同步完成。

04

Chrome ＋ Obsidian Web Clipper

瀏覽器本體，外加「Obsidian Web Clipper」擴充。看到好文章、YouTube 字幕，右鍵一鍵剪藏進知識庫的 Clipping 資料夾。

這些不用手動裝，懶人包會自動處理：
· Node.js（跑各種 MCP / 工具的執行環境）
· Git（版本控制、推上 GitHub）
· uv（Python 套件 / 工具管理器）
· 各服務的 CLI 與 MCP Server

最容易被盜刷的一步

OpenAI API Key：申請與安全四步驟

用 API 生圖比直接訂閱便宜很多（一張 1024×1024 約台幣 0.3 元）。但 API Key 等於一把會花錢的鑰匙——一旦外洩、又開著自動加值，別人可以幫你「無限刷爆」。請務必照下面順序，先關自動加值、再建立 Key。

  1. Step 01

    儲值（建議至少 5 美金）。到 OpenAI 平台的 Billing 儲入小額，先有餘額才能呼叫 API。

  2. Step 02

    立刻關閉自動加值（Auto Recharge）。這是最關鍵的防盜刷動作。關掉後即使 Key 外洩，餘額用完就停，不會被無上限扣款。

  3. Step 03

    Create Secret Key 並「立刻複製」。建立後幫它命名（方便日後辨識），關掉視窗就再也看不到完整 Key——當下沒複製到就只能刪掉重建。

  4. Step 04

    完成身份驗證。到帳號 General → Personal 做驗證（掃 QR Code、上傳證件正反面、自拍）。沒驗證 API 不會啟用。

忘了複製 Key 怎麼辦？別慌——直接把舊 Key 刪除，再 Create 一個新的即可，舊的刪掉就完全失效。所以 Key 外洩的標準處置也是「立刻刪除、重建」。
「如果錢不夠又開著自動儲值，API Key 一旦洩漏就會被別人用爆——保險起見，一定要把自動儲值關掉。」

過來人血淚

新手最常卡關的五件事

下面這五個坑，幾乎每個人第一次設定都會踩到。先看過一遍，遇到「明明照做卻沒反應」時回來對照，省下大把卡關時間。

關卡 1 裝完 MCP／新 Skill，一定要「完全關閉再重啟」桌面版。新增的 MCP 或技能需要重啟才會掛載生效。要徹底關——必要時用工作管理員（Windows）／強制結束（Mac）把程式結束乾淨，再重開，然後告訴 AI「我已重啟」讓它接著測連線。
關卡 2 NotebookLM 沒有公開 API，是用「瀏覽器模擬」操作。AI 不是呼叫 API，而是模擬人在瀏覽器上點按 NotebookLM。所以你需要在瀏覽器先登入 Google 帳號；好消息是設定一次就永久有效，之後不必再設。
關卡 3 要用 Dispatch（手機遠端操控電腦）前，先把帳號全部登入好。AI 無法替你登入帳號。凡是它要操作的網站（NotebookLM、各平台後台），都得先在電腦瀏覽器登入完成，遠端任務才跑得動。
關卡 4 免費版 Supabase 會「閒置 7 天自動休眠」——設一個每週查詢排程防呆。在 Claude Code 的 Scheduled 排程裡，建一個「每週查詢一次 Supabase 專案」的任務，讓專案保持活著，不會因為太久沒用被暫停。
關卡 5 去識別化：個資不要進 AI／資料庫；收工別用 git add .，要先看 diff。在學校或公司用時，只保留座號等非敏感欄位，姓名、電話、地址等隱私不要餵進去。推上 GitHub 前先檢查改了哪些檔案（看 diff），避免一句 git add . 把不該上傳的個資或機密一起推上公開倉庫。
「要在學校使用的話，必須去識別化，盡量只保留學生的座號就好，不要姓名以及其他隱私資料。」

本模組重點

三句話帶走

1 ｜ 不要手動裝，讓 AI 讀懶人包自己裝——你只負責登入與收驗證碼。 2 ｜ 帳號先備齊（Claude 要電話驗證＋訂閱、其餘多能用 Google 一鍵註冊）；OpenAI API 一定先關自動加值再建 Key。 3 ｜ 裝完 MCP/Skill 記得重啟；免費 Supabase 設每週查詢防休眠；個資不進 AI、收工先看 diff 再推。

← 上一模組：認識 AI 工具生態　｜　下一模組：用懶人包打造你的工作流（Skills 與自動化）→