วิธีสร้าง AI Agent ตัวแรกของคุณด้วย Claude Code (หลักสูตรสำหรับมือใหม่ฉบับสมบูรณ์)

เรียนรู้วิธีติดตั้ง Claude Code, เขียน Agent ตัวแรกของคุณตั้งแต่เริ่มต้น, และลงเอยด้วยสิ่งที่ใช้งานได้จริง: Agent ที่อ่านโฟลเดอร์, จุดปัญหา, และเขียนรายงาน โดยไม่ต้องมีประสบการณ์เขียนโค้ดมาก่อน

Chatbot รอให้คุณถามคำถามแล้วตอบกลับ แต่ AI Agent นั้นแตกต่าง: คุณให้เป้าหมายกับมัน แล้วมันจะคิดหาขั้นตอนเอง อ่านไฟล์ รันคำสั่ง และดำเนินการต่างๆ ด้วยตัวเองจนกว่างานจะเสร็จ คุณไม่ได้คอยควบคุมทุกการเคลื่อนไหว คุณแค่กำหนดปลายทาง

ความแตกต่างนี้สำคัญเพราะมันเปลี่ยนสิ่งที่คุณสามารถทำให้เป็นอัตโนมัติได้ คุณไม่ได้พิมพ์พรอมต์ทีละอัน คุณกำลังสร้างบางสิ่งที่ทำงานแทนคุณในขณะที่คุณโฟกัสที่อื่น

สิ่งที่คุณต้องมีก่อนเริ่ม

นี่คือทุกสิ่งที่จำเป็นก่อนที่คุณจะแตะคำสั่งใดๆ:

• บัญชี Claude ที่มีแผนแบบชำระเงิน (Pro ที่ $20/เดือนคือขั้นต่ำ; Claude Code รวมอยู่ในแผน)
• Mac ที่ใช้ macOS 13 หรือใหม่กว่า, หรือ Windows PC, หรือ Linux machine
• การเชื่อมต่ออินเทอร์เน็ต
• ประมาณ 30 ถึง 45 นาทีสำหรับการตั้งค่าและการสร้างครั้งแรก

ไม่ต้องมีประสบการณ์เขียนโค้ดมาก่อน ทุกคำสั่งในคู่มือนี้เขียนไว้แบบเต็ม คุณแค่คัดลอก วาง และกด Enter

ค่าใช้จ่ายในการทำตามคู่มือนี้: $0 นอกเหนือจากค่าสมัครของคุณ Claude Code รวมอยู่ในแผน Claude แบบชำระเงินทั้งหมด

ติดตั้ง Claude Code (วิธีเดสก์ท็อปแอป, ไม่ต้องใช้ Terminal)

วิธีที่ง่ายที่สุดสำหรับมือใหม่คือเดสก์ท็อปแอป มันให้พลังทั้งหมดของ Claude Code แก่คุณโดยไม่ต้องเรียนรู้คำสั่ง Terminal ก่อน

ไปที่ claude.ai และดาวน์โหลดเดสก์ท็อปแอปสำหรับแพลตฟอร์มของคุณ บน macOS เปิดไฟล์ .dmg แล้วลาก Claude ไปยังโฟลเดอร์ Applications ของคุณ บน Windows รัน installer เปิดแอป ลงชื่อเข้าใช้ด้วยบัญชี Claude ของคุณ แล้วคลิกแท็บ Code ที่กึ่งกลางด้านบนของหน้าจอ

ถ้าแท็บ Code ขอให้คุณอัปเกรดแผน แสดงว่าแผนปัจจุบันของคุณไม่มี Claude Code ถ้ามันขอให้คุณลงชื่อเข้าใช้ทางออนไลน์ ให้ลงชื่อเข้าใช้ให้เสร็จแล้วรีสตาร์ทแอป ไม่ว่าจะกรณีไหน คุณจะพบกับพื้นที่ทำงานที่สะอาดตาเมื่อคุณเข้ามาแล้ว

สิ่งที่แสดงว่าสำเร็จ: คุณเห็นกล่องพรอมต์ว่างๆ โดยมีแท็บ Code ทำงานอยู่ และไม่มีข้อความแสดงข้อผิดพลาด นั่นคือพื้นที่ทำงานของ Agent ทุกสิ่งที่คุณสร้างจะอยู่ที่นี่

สิ่งที่คุณกำลังจะสร้าง

คุณกำลังจะสร้าง 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 เปิดมันในโปรแกรมแก้ไขข้อความใดๆ รวมถึง Notepad บน Windows หรือ TextEdit บน Mac แล้ววางข้อความนี้ให้ตรงตามเดิม:

1# My File Checker Agent
2
3## Your job
4
5Check every .txt file inside the /articles folder.
6
7## What to look for
8
9A valid file starts with a line that reads exactly: Title:
10
11If the first line does not start with "Title:", the file is missing its title.
12
13## What to do
14
151. Read every .txt file in /articles one by one.
16
171. Note which files are missing the Title line.
18
191. Write a file called missing-titles.txt in the main folder.
20
211. In that file, list every filename that failed the check, one per line.
22
231. If all files pass, write "All files have titles." in missing-titles.txt instead.
24
25## What not to do
26
27Do not edit any of the article files. Read only. Write only to missing-titles.txt.

บันทึกไฟล์ นี่คือสมองทั้งหมดของ Agent ของคุณ Claude Code จะอ่านสิ่งนี้ก่อนที่จะทำอะไรอื่น

สิ่งที่แสดงว่าสำเร็จ: คุณมีไฟล์ที่ my-agent/CLAUDE.md และมีคำสั่งด้านบน

ขั้นตอนที่ 3: ชี้ Claude Code ไปยังโฟลเดอร์ของคุณ

เปิด Claude Code เดสก์ท็อปแอป แล้วคลิกไอคอนโฟลเดอร์หรือตัวเลือก "Open folder" เพื่อนำทางไปยังโฟลเดอร์ my-agent ของคุณ เลือกมันแล้วยืนยัน

Claude Code จะอ่านไฟล์ CLAUDE.md ของคุณโดยอัตโนมัติ คุณจะไม่เห็นข้อความยืนยันสำหรับสิ่งนี้ มันเกิดขึ้นในพื้นหลังอย่างเงียบๆ ทุกครั้งที่คุณเปิดโฟลเดอร์

ถ้าคุณใช้ Terminal แทนเดสก์ท็อปแอป ให้เปิด Terminal แล้วรัน:

1cd ~/Desktop/my-agent
2claude

คำสั่ง cd หมายถึง "change directory" มันพาคุณไปยังโฟลเดอร์ 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 อ่านสี่ไฟล์, ระบุสองไฟล์ที่ไม่มีหัวเรื่อง, และสร้าง missing-titles.txt ในโฟลเดอร์ my-agent ของคุณ เปิดไฟล์นั้นแล้วคุณควรจะเห็นชื่อไฟล์สองไฟล์ที่ถูกแสดงรายการ หนึ่งบรรทัดต่อไฟล์

ข้อผิดพลาดมือใหม่ทั่วไป: Agent บอกว่าทำเสร็จแล้ว แต่ไฟล์ว่างเปล่า

สิ่งนี้เกิดขึ้นเมื่อ Agent เขียน missing-titles.txt แต่ไม่ได้ใส่สิ่งใดลงไปจริงๆ สาเหตุมักมาจากคำสั่งใน CLAUDE.md ที่คลุมเครือเกินไป

วิธีแก้: เปิด CLAUDE.md และทำให้คำสั่งผลลัพธ์ชัดเจนขึ้น แทนที่จะ "list the files" ให้เขียน "write each filename on its own line, like this: post-two.txt" ตัวอย่างที่เป็นรูปธรรมในคำสั่งของคุณจะให้ผลลัพธ์ที่เป็นรูปธรรมทุกครั้ง

ถ้า Agent เขียนชื่อไฟล์ผิดหรือพลาดไฟล์ใดไฟล์หนึ่ง ให้ตรวจสอบว่าไฟล์บทความของคุณมีนามสกุล .txt จริงๆ หรือไม่ และไม่ใช่ .txt.txt ซึ่งอาจเกิดขึ้นได้บน Windows เมื่อซ่อนนามสกุลไฟล์ เปิด "show file extensions" ในการตั้งค่า File Explorer ของคุณเพื่อตรวจสอบ

ขั้นตอนที่ 5: ตรวจสอบและขยาย

เปิด missing-titles.txt และยืนยันว่ามันแสดงรายการเฉพาะสองไฟล์ที่คุณปล่อยว่างไว้ ถ้าใช่ แสดงว่า Agent ของคุณทำงานถูกต้องตั้งแต่ต้นจนจบ

ตอนนี้คุณมี Agent ที่ทำงานได้แล้ว มันอยู่ใน my-agent มันอ่านจาก CLAUDE.md และคุณสามารถรันมันได้ทุกครั้งที่คุณวางไฟล์ใหม่ลงในโฟลเดอร์ articles และรันพรอมต์เดียวกัน

ขั้นตอนถัดไปที่ชัดเจน: อัปเดต CLAUDE.md เพื่อตรวจสอบด้วยว่าแต่ละไฟล์ยาวเกินห้าบรรทัด เพิ่มสิ่งนี้ภายใต้ "What to look for":

1A valid file also has more than 5 lines of content.
2
3If a file has 5 lines or fewer, flag it as "too short" alongside the title check.

รัน Agent อีกครั้งด้วยพรอมต์เดียวกัน ตอนนี้มันจะตรวจสอบสองสิ่งแทนที่จะเป็นหนึ่งเดียว โดยไม่มีการเปลี่ยนแปลงพรอมต์ของคุณ แค่เปลี่ยนไฟล์คำสั่ง

สิ่งที่คุณเพิ่งสร้างและเหตุผลที่มันสำคัญ

คุณสร้าง Agent ที่อ่านไฟล์ ตัดสินใจ และเขียนผลลัพธ์ โดยที่คุณไม่ต้องควบคุมแต่ละขั้นตอน นั่นคือรูปแบบหลักเบื้องหลัง Agent ขั้นสูงทุกตัวที่คุณจะสร้างในอนาคต

ไฟล์ CLAUDE.md คือส่วนที่ปรับขนาดได้ กฎใหม่ การตรวจสอบใหม่ หรือรูปแบบผลลัพธ์ใหม่ทุกอย่างที่คุณเพิ่มเข้าไปจะเปลี่ยนสิ่งที่ Agent ทำ โดยที่คุณไม่ต้องเปลี่ยนวิธีการรันมัน พรอมต์ยังคงเดิม คำสั่งพัฒนาขึ้น

จากจุดนี้ การขยายตามธรรมชาติคือ: ตรวจสอบไฟล์ประเภทมากขึ้น, เขียนรายงานในรูปแบบอื่น เช่น CSV, หรือรันการตรวจสอบตามตารางเวลาโดยใช้ฟีเจอร์ Routines ในตัวของ Claude Code

มีคำถามเกี่ยวกับขั้นตอนไหน? โพสต์ไว้ด้านล่าง