如何使用 Claude Code 打造你的第一個 AI Agent（零基礎完整教學）

學習如何安裝 Claude Code，從零開始撰寫你的第一個 Agent，最終打造出一個真正能運作的 Agent：它可以讀取資料夾、找出問題、並撰寫報告，完全不需要任何程式設計經驗。

聊天機器人會等你提問並回答問題。AI Agent 則不同：你給它一個目標，它會自己規劃步驟、讀取檔案、執行指令、並自主採取行動，直到任務完成。你不需要主導每一步，你只需要設定目的地。

這個區別很重要，因為它改變了你所能自動化的範疇。你不是一次只輸入一個提示詞，而是在打造一個能替你完成工作的系統，讓你專注在其他事情上。

開始前需要準備什麼

以下是你在輸入任何指令前所需的一切：

• 一個 Claude 帳戶，且需為付費方案（最低為 Pro 方案，每月 $20 美元；Claude Code 已包含在內）

• 一台運行 macOS 13 或更新版本的 Mac、Windows PC 或 Linux 電腦

• 網路連線

• 約 30 到 45 分鐘完成完整設定與首次建置

無需任何程式設計經驗。本指南中的所有指令都會完整列出。你只需複製、貼上、然後按下 Enter。

跟隨本指南的費用：除了你的訂閱費用外，完全免費。Claude Code 已包含在所有 Claude 付費方案中。

安裝 Claude Code（桌面應用程式方式，無需使用終端機）

對初學者來說，最簡單的方式就是使用桌面應用程式。它讓你能完整使用 Claude Code 的所有功能，而無需先學習終端機指令。

前往 claude.ai 下載適合你平台的桌面應用程式。在 macOS 上，打開 .dmg 檔案並將 Claude 拖曳到 Applications 資料夾。在 Windows 上，則執行安裝程式。啟動應用程式，用你的 Claude 帳戶登入，然後點選螢幕頂端中間的 Code 分頁。

如果 Code 分頁要求你升級方案，代表你目前的方案未包含 Claude Code。如果它要求你線上登入，請完成登入並重新啟動應用程式。無論如何，成功進入後你都會看到一個空白的 workspace。

成功的樣貌：你會看到一個空白的提示輸入框，Code 分頁處於啟用狀態，且沒有任何錯誤訊息。這就是你的 Agent workspace。你建立的所有東西都會存在這裡。

你即將建置的內容

你將會建置一個特定的 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。打開其中兩個檔案，並在檔案最頂端加入這一行：

1Title: My Article

將另外兩個檔案保持完全空白。Agent 的任務就是要找出那些空白的檔案。

成功的樣貌：你的資料夾結構為 my-agent/articles/，裡面有四個 .txt 檔案，其中兩個有標題列，兩個沒有。

步驟 2：撰寫 CLAUDE.md 指令檔案

CLAUDE.md 是一個純文字檔案，Claude Code 會在每次會話開始時讀取它。它是你 Agent 的常駐指令，相當於一份它永遠不會忘記的工作說明書。

在 my-agent 資料夾內（不是 articles 資料夾），建立一個名為 CLAUDE.md 的新檔案。用任何文字編輯器打開它（Windows 上可以用記事本，Mac 上可以用 TextEdit），然後完整貼上以下內容：

1# 我的檔案檢查 Agent
2
3## 你的工作
4
5檢查 /articles 資料夾內的每一個 .txt 檔案。
6
7## 要檢查什麼
8
9一個有效的檔案，其第一行必須完全符合：Title:
10
11如果第一行不是以 "Title:" 開頭，則表示該檔案缺少標題。
12
13## 要做什麼
14
151. 逐一讀取 /articles 中的每一個 .txt 檔案。
162. 記錄哪些檔案缺少 Title 這一行。
173. 在主要資料夾中寫入一個名為 missing-titles.txt 的檔案。
184. 在該檔案中，每行列出一个檢查失敗的檔案名稱。
195. 如果所有檔案都通過檢查，則在 missing-titles.txt 中寫入 "All files have titles."
20
21## 不要做什麼
22
23不要編輯任何文章檔案。只讀取。只寫入 missing-titles.txt。

儲存這個檔案。這就是你 Agent 的完整大腦。Claude Code 會在執行任何動作之前先讀取這個檔案。

成功的樣貌：你有一個位於 my-agent/CLAUDE.md 的檔案，其中包含上述指令。

步驟 3：將 Claude Code 指向你的資料夾

打開 Claude Code 桌面應用程式，點選資料夾圖示或「開啟資料夾」選項，瀏覽到你的 my-agent 資料夾。選取它並確認。

Claude Code 會自動讀取你的 CLAUDE.md 檔案。你不會看到確認訊息，這個動作會在每次你開啟資料夾時在背景默默完成。

如果你使用的是終端機而非桌面應用程式，請打開終端機並執行：

1cd ~/Desktop/my-agent
2claude

cd 指令的意思是「變更目錄」。它會讓你移動到 my-agent 資料夾內。輸入 claude 則會從該資料夾內啟動 Agent 會話。

步驟 4：執行 Agent

在 Claude Code 介面底部的提示輸入框中，完整輸入以下內容：

1Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.

按下 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，讓它也檢查每個檔案的長度是否超過五行。在「要檢查什麼」下方加入以下內容：

1一個有效的檔案也必須有超過 5 行的內容。
2如果一個檔案有 5 行或更少，請在標題檢查之外，同時將其標記為「太短」。

再次用相同的提示詞執行 Agent。它現在會檢查兩件事，而不是一件，而且你完全不需要更改提示詞，只需修改指令檔案即可。

你剛剛建置了什麼，以及它為什麼重要

你建置了一個能讀取檔案、做出判斷、並寫出輸出的 Agent，而且你無需監督每一步驟。這就是你未來所有更高階 Agent 背後的核心模式。

CLAUDE.md 檔案是那個能夠擴展的部分。你在其中加入的每一條新規則、新檢查項目或新輸出格式，都會改變 Agent 的行為，而你執行它的方式卻不需要改變。提示詞維持不變，指令則持續進化。

從這裡開始，自然的延伸方向包括：檢查更多檔案類型、將報告寫成不同的格式（例如 CSV），或是使用 Claude Code 內建的 Routines 功能排程執行檢查。

對任何步驟有疑問嗎？歡迎在下方留言。