如果你想當自己的老闆，你應該為自己留出 30 分鐘的時間。
因為今天，我將解釋如何在一個下午內，用零程式碼知識，建立一個真正能運作的 AI Agent。
別把我接下來要說的內容跟聊天機器人搞混。聊天機器人會等待問題並給出答案。Agent 的運作方式不同：你給它一個目標，它會自己設定步驟、讀取檔案、執行指令，並持續自主運作直到任務完成。你不需要管理每一步，你只需要規劃路線。
這個差異很重要，因為你不再需要逐條撰寫提示詞。當你在處理其他工作時，任務會自行推進。
需要什麼？
安裝前你需要的一切都在這裡：
- 付費的 Claude 方案（Pro，每月 20 美元，包含 Claude Code）
- Mac（macOS）、Windows 或 Linux 電腦
- 網路連線
- 30-45 分鐘的空閒時間
不需要任何程式碼知識。每個指令都已完整寫好，你只需要複製貼上並按下 Enter。
沒有額外費用。除了訂閱費用之外，你不需要花任何一毛錢。
安裝：桌面應用程式，無需終端機
對初學者來說，最簡單的方式是使用桌面應用程式。它將 Claude Code 的所有功能都放在你手中，無需學習終端機操作。
透過 claude.ai 下載適合你作業系統的桌面應用程式。在 Mac 上，開啟 .dmg 檔案並將 Claude 拖曳到「應用程式」資料夾；在 Windows 上，執行安裝程式。開啟應用程式，用你的帳號登入，然後點擊頂部中央的「Code」分頁。
如果「Code」分頁要求升級方案，表示你目前的方案不包含 Claude Code。如果它要求線上登入，請完成登入並重新啟動應用程式。無論哪種情況，你最終都會進入一個空白的工作區。
成功進入的標誌是：一個空的提示輸入框、一個啟用的「Code」分頁，以及沒有錯誤訊息。你從現在開始建立的所有東西都會存在這個區域中。
我們要建立什麼？
我們將建立一個單一且明確的 Agent；我們會一直使用同一個 Agent 直到文章結束。
它的任務是：讀取一個資料夾中的文字檔，找出那些缺少標題的檔案，然後為你撰寫一份名為 missing-titles.txt 的報告，列出需要修正的檔案。
一個小而實際的任務。它包含了 Agent 應該做的三件基本事情：讀取檔案、做出決策、以及寫出輸出結果。而且它足夠簡單，你可以親眼驗證它是否正常運作。
步驟 1：設定工作資料夾
在你的桌面上建立一個名為 my-agent 的資料夾。Agent 將在此處工作；它只能看到並觸及這個資料夾內的東西，所以一切都很安全。
在 my-agent 資料夾內，再建立一個名為 articles 的子資料夾。Agent 將會在這裡尋找它要檢查的檔案。
在 articles 資料夾內建立四個純文字檔：post-one.txt、post-two.txt、post-three.txt、post-four.txt。開啟其中兩個檔案，並在最頂端寫下：
Title: My Article
讓另外兩個檔案保持完全空白。Agent 的任務正是找出這些空白的檔案。
你的資料夾結構應該是 my-agent/articles/，裡面包含四個 .txt 檔案，兩個有標題，兩個沒有。
步驟 2：撰寫 CLAUDE.md 指令檔案
CLAUDE.md 是一個純文字檔，Claude Code 在每次工作階段開始時都會讀取它。把它想像成你的 Agent 的固定指令，一份它永遠不會忘記的工作說明。
在 my-agent 資料夾內（不是在 articles 裡面），建立一個名為 CLAUDE.md 的新檔案。用任何文字編輯器開啟它——Windows 上用記事本，Mac 上用文字編輯——然後精確貼上以下內容：
# 我的檔案檢查 Agent ## 你的任務 檢查 /articles 資料夾中的每個 .txt 檔案。
## 要檢查什麼 一個有效的檔案會以這行開頭：Title: 如果第一行不是以 "Title:" 開頭，則表示該檔案的標題遺失。
## 要做什麼 1. 逐一讀取 /articles 資料夾中的每個 .txt 檔案。 2. 記錄哪些檔案缺少標題。 3. 在主資料夾中建立一個名為 missing-titles.txt 的檔案。 4. 將每個未通過檢查的檔案名稱寫入此檔案，每行一個。 5. 如果所有檔案都有效，則在 missing-titles.txt 中寫入 "所有檔案都有標題。"。
## 不要做什麼 不要編輯任何文章檔案。僅讀取。僅寫入 missing-titles.txt 檔案。
儲存它。這就是你的 Agent 的整個大腦。Claude Code 會在執行任何其他事情之前先讀取這個檔案。
my-agent/CLAUDE.md 檔案已建立，並包含上述指令，這樣就完成了。
步驟 3：將 Claude Code 指向該資料夾
開啟 Claude Code 桌面應用程式，點擊資料夾圖示或「開啟資料夾」選項，然後瀏覽到 my-agent 資料夾。選取並確認。
Claude Code 會自動讀取你的 CLAUDE.md 檔案。你不會看到任何確認訊息；每次你開啟一個資料夾時，這都會在背景靜默發生。
如果你使用終端機，請開啟終端機並執行以下指令：
cd ~/Desktop/my-agent claude
cd 指令的意思是「切換目錄」；它會將你移動到 my-agent 資料夾內。輸入 claude 會從該資料夾開始一個工作階段。
步驟 4：執行 Agent
在 Claude Code 介面底部的提示輸入框中，精確輸入以下內容：
讀取 articles 資料夾中的每個 .txt 檔案。找出任何頂端缺少 Title 行的檔案。按照 CLAUDE.md 中的指示，將結果寫入 missing-titles.txt。
按下 Enter。然後觀察。
Claude Code 會顯示它工作時所做的一切：它讀取了哪個檔案、在每個檔案中發現了什麼、以及它寫入了什麼。這種透明度是刻意設計的。你可以在每個動作發生前看到它，如果看起來有問題，可以隨時停止。
Claude 會讀取這四個檔案，偵測到兩個沒有標題的檔案，並在你的 my-agent 資料夾中建立 missing-titles.txt 檔案。當你開啟它時，你應該會看到兩個檔案名稱，一個接一個地寫在裡面。
最常見的錯誤：Agent 說「完成」但檔案是空的
這通常發生在 Agent 建立了 missing-titles.txt 檔案，但裡面什麼都沒寫。原因幾乎總是 CLAUDE.md 中的指示過於模糊。
解決方案：開啟 CLAUDE.md，讓輸出指示更具體。不要只寫「列出檔案」，而要寫「將每個檔案名稱寫在獨立的一行，例如：post-two.txt」。在指示中加入具體的範例，每次都能讓輸出結果變得具體。
如果 Agent 寫錯了檔案名稱或跳過了一個，請確認你的文章檔案確實有 .txt 副檔名，而不是 .txt.txt。這在 Windows 上隱藏了檔案副檔名時經常發生。從檔案總管設定中開啟「顯示檔案副檔名」並檢查。
步驟 5：驗證與擴展
開啟 missing-titles.txt 檔案，確認你留空的那兩個檔案是否被列出。如果正確，表示你的 Agent 從頭到尾都正確運作。
現在你有一個可以運作的 Agent 了。它存在於 my-agent 中，從 CLAUDE.md 獲取指令，當你將新檔案放入 articles 資料夾時，你可以用同樣的提示詞再次執行它。
下一步很明確：更新 CLAUDE.md，讓它也檢查每個檔案是否超過五行。在「要檢查什麼」標題下加入以下內容：
**一個有效的檔案也應包含超過 5 行的內容。 如果一個檔案只有 5 行或更少，請在標題檢查旁邊也將其標記為「太短」。**
用同樣的提示詞再次執行 Agent。現在它會檢查兩件事而不是一件；你沒有對提示詞做任何修改，只有指令檔案改變了。
你做了什麼，為什麼這很重要？
你建立了一個能讀取檔案、做出決策、寫出輸出結果，並且不需要你監督每一步的 Agent。這是你從現在開始將要建立的每個更高階 Agent 的基本模式。
能夠擴展的部分是 CLAUDE.md。你在其中加入的每一條新規則、新檢查項目和新輸出格式，都會改變 Agent 的行為，而你無需改變執行它的方式。提示詞保持不變，指令則不斷演進。
從這裡開始的自然步驟：檢查更多檔案類型、以不同的格式（如 CSV）撰寫報告、或讓檢查在特定時間間隔自動重複執行。
恭喜，你已經踏出了第一步；剩下的就掌握在你手中，與你的想像力成正比。
在差距擴大之前採取行動。
別忘了儲存和分享，並透過留言來支持。
