บทเรียน Claude Code: การตั้งค่า รีแฟกเตอร์ และดีบักแบบลงมือทำ

Claude Code คืออะไร?

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

ความสามารถเด่นบางประการของ Claude Code มีดังนี้:

• การแก้ไขและรีแฟกเตอร์: ปรับแก้ ปรับให้เหมาะสม และยกระดับโค้ดเบสด้วยคำแนะนำจากระบบ AI
• การแก้บั๊ก: ระบุและแก้ไขข้อผิดพลาด การพึ่งพาที่ขาดหาย และคอขวดด้านประสิทธิภาพ
• ความเข้าใจโค้ด: ถามคำถามเกี่ยวกับสถาปัตยกรรม ตรรกะ และการอ้างอิงระหว่างส่วนต่างๆ ของโค้ด
• การทดสอบและลินต์แบบอัตโนมัติ: รันและแก้เทสต์ที่ล้มเหลว รันคำสั่งลินต์ และปรับปรุงคุณภาพโค้ด
• การผสาน Git: ค้นหาประวัติ git แก้คอนฟลิกต์ ผสานคอมมิต และสร้างพุลรีเควสได้อย่างง่ายดาย

ไม่ว่าจะทำโปรเจกต์โอเพ่นซอร์สหรือดูแลโค้ดเบสระดับองค์กร Claude Code ช่วยทำงานแบบอัตโนมัติอย่างชาญฉลาดที่ปรับตามสไตล์การเขียนและความต้องการของโปรเจกต์ได้ อัปเดตล่าสุดได้เพิ่ม auto mode (ขอสิทธิ์รบกวนน้อยลง), plan mode (เวิร์กโฟลว์ออกแบบก่อนลงมือทำ) และ Routines (เอเจนต์คลาวด์ตามทริกเกอร์ที่ทำงานได้โดยไม่ต้องเปิดเครื่องของคุณ)

กลุ่มผู้ใช้ที่เหมาะสมกับบริการนี้ ได้แก่:

• นักพัฒนาซอฟต์แวร์: ปรับปรุงคุณภาพและความสามารถในการดูแลโค้ด
• ผู้มีส่วนร่วมโอเพ่นซอร์ส: ทำความเข้าใจและยกระดับโค้ดเบสที่ยังไม่คุ้นเคย
• วิศวกร DevOps: ทำงานรีวิวโค้ดและลินต์ให้เป็นอัตโนมัติ

ปัจจุบัน Claude Code ตั้งค่าเริ่มต้นเป็น Claude Opus 4.7 บนแผน Max และ Team Premium ผู้ใช้ Pro เริ่มต้นที่ Sonnet 4.6 แต่สามารถสลับเป็น Opus สำหรับงานที่ต้องใช้พลังมากขึ้น สามารถสลับโมเดลระหว่างเซสชันด้วยคำสั่ง /model หรือปรับระดับการให้เหตุผลด้วยตัวเลื่อน /effort และยังสามารถสร้างเอเจนต์ AI แบบสแตนด์อโลนด้วย Claude Agents SDK ได้อีกด้วย

Anthropic ยังเปิดตัว Cowork เพื่อความช่วยเหลือแบบเอเจนต์ในงานไฟล์และเอกสารประจำวันนอกเหนือจากการโค้ด มีให้ใช้งานสำหรับผู้สมัครสมาชิกแบบชำระเงินทุกแผน (Pro, Max, Team, Enterprise) ในแอป Claude Desktop

มาเริ่มต้นโปรเจกต์แบบลงมือทำกัน

ขั้นตอนที่ 1: ตั้งค่า Claude Code

ในการเริ่มต้นใช้งาน Claude Code ต้องมีเทอร์มินัล โปรเจกต์โค้ดสำหรับทำงาน และสมาชิก Claude แบบชำระเงิน (Pro/Max/Teams/Enterprise) หรือบัญชี Claude Console ที่มีการคิดค่าบริการแบบใช้งาน API

ติดตั้ง Claude Code ได้ง่ายๆ โดยรันหนึ่งในคำสั่งต่อไปนี้ในเทอร์มินัล ขึ้นอยู่กับระบบปฏิบัติการและเทอร์มินัลที่ใช้

macOS / Linux / WSL: 

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell: 

irm https://claude.ai/install.ps1 | iex

Windows CMD:  

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

หมายเหตุ: การติดตั้งผ่าน npm install -g @anthropic-ai/claude-code ยังมีอยู่แต่ยุติการสนับสนุนแล้ว ควรใช้กระบวนการติดตั้งแบบเนทีฟตามที่กล่าวข้างต้น หากเคยติดตั้งผ่าน npm มาก่อน สามารถย้ายได้ด้วยคำสั่ง claude install.

เมื่อติดตั้งเสร็จ ให้ไปที่ไดเรกทอรีโปรเจกต์ของคุณและเริ่ม Claude ด้วยการรัน:

cd your-project-directory
claude

สำหรับการยืนยันตัวตน ระบบจะถามว่าต้องการใช้ Claude Code ผ่านการสมัครสมาชิกแบบชำระเงิน หรือผ่านการคิดค่าบริการตามการใช้ API

ถัดไป จะได้รับลิงก์เข้าสู่ระบบเพื่อนำรหัสยืนยันมากรอกในเทอร์มินัลที่รัน Claude Code จากนั้นก็เสร็จสิ้น และ จะมีการสร้างพื้นที่ทำงาน “Claude Code” โดยอัตโนมัติเพื่อติดตามการใช้งานและจัดการค่าใช้จ่าย

ตอนนี้ Claude Code พร้อมใช้งานแล้ว

ขั้นตอนที่ 2: ตั้งค่าสภาพแวดล้อมการพัฒนา

สำหรับเดโมนี้ จะใช้ไลบรารี Supabase สำหรับ Python คือ supabase-py ซึ่งเป็นไคลเอนต์ Python แบบโอเพ่นซอร์สสำหรับโต้ตอบกับ Supabase ซึ่งเป็นบริการ backend-as-a-service ที่สร้างบน PostgreSQL Supabase มีเครื่องมือชุดใหญ่ เช่น การยืนยันตัวตน การสมัครรับข้อมูลแบบเรียลไทม์ ระบบจัดเก็บ และ API ที่สร้างให้อัตโนมัติ

เริ่มจากโคลนรีโพซิทอรีและตั้งค่าสภาพแวดล้อมการพัฒนากัน

1. เปิดเทอร์มินัล ไปยังไดเรกทอรีที่ต้องการโคลนรีโพซิทอรี Supabase-py (เช่น cd Desktop) แล้วรันคำสั่งต่อไปนี้:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. สร้างสภาพแวดล้อมเสมือนและติดตั้งแพ็กเกจที่ต้องใช้ด้วยการรันคำสั่งต่อไปนี้ทีละคำสั่งในเทอร์มินัล

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

ตอนนี้สภาพแวดล้อม Python ถูกตั้งค่าพร้อมการพึ่งพาทั้งหมดที่จำเป็นสำหรับรันไลบรารี Supabase และรีโพซิทอรีพร้อมสำหรับการสำรวจแล้ว 

ขั้นตอนที่ 3: ระบุพื้นที่ที่น่าจะเข้าไปมีส่วนร่วม

วิธีที่ดีในการมีส่วนร่วมคือสำรวจแท็บ Issues บน GitHub ในรีโพซิทอรีของ Supabase ผู้เขียนพบปัญหาใน client.py เกี่ยวกับความสามารถในการอ่าน โครงสร้าง และการขาดคอมเมนต์ที่มีความหมาย

นี่คือสิ่งที่เราจะทำด้วย Claude Code:

• รีแฟกเตอร์โค้ดเพื่อยกระดับความอ่านง่าย การดูแลรักษา และโครงสร้าง
• เพิ่มโดกสตริงและคอมเมนต์อินไลน์ที่มีความหมายเพื่อชี้แจงวัตถุประสงค์ของส่วนต่างๆ
• ระบุและแก้บั๊กโดยวิเคราะห์อีชชูและข้อผิดพลาดที่อาจเกิดขึ้นอื่นๆ

ขั้นตอนที่ 4: ทดลองใช้ Claude Code

เมื่ออยู่ในโฟลเดอร์ supabase-py แล้ว ให้ไปยังไดเรกทอรี supabase ที่มีไฟล์ client.py และรัน Claude Code:

cd supabase
claude

ตอนนี้ Claude Code สามารถเข้าถึงทุกไฟล์และโฟลเดอร์ภายในโฟลเดอร์ Supabase-py ได้แล้ว มาเริ่มทดลองกัน

การรีแฟกเตอร์โค้ด

เพื่อปรับปรุง SDK ของ Supabase สำหรับ Python มาลองรีแฟกเตอร์ไฟล์ client.py เพื่อยกระดับความอ่านง่าย ความสามารถในการดูแล และการจัดระเบียบ เพียงพิมพ์พรอมป์ตต่อไปนี้ในบรรทัดคำสั่ง:

พรอมป์ต: รีแฟกเตอร์โค้ดในไฟล์ client.py ที่อยู่ในโฟลเดอร์ Supabase

Claude จะถามเพื่อยืนยันก่อนดำเนินการ กด Enter เพื่ออนุมัติการเปลี่ยนแปลง เมื่อเสร็จสิ้น Claude Code จะอัปเดตไฟล์ แสดงการแก้ไขในเทอร์มินัล และสรุปการเปลี่ยนแปลงที่ทำ

โดยใช้ Claude Code เราได้ปรับปรุงไฟล์ client.py ดังนี้:

• จัดระเบียบการนำเข้า (imports):  Claude Code จัดกลุ่มการนำเข้าที่เกี่ยวข้องเป็นส่วนที่มีเหตุผล (ข้อผิดพลาดการยืนยันตัวตน ชนิดข้อมูล API ข้อผิดพลาดของฟังก์ชัน) เปลี่ยนชื่อการนำเข้าให้ชัดเจนขึ้น และลบชื่อแฝงที่ซ้ำซ้อนเพื่อความสม่ำเสมอ
• ยกระดับความอ่านง่าย: เพิ่มคอมเมนต์เป็นส่วนๆ เพื่อจัดหมวดการนำเข้า และลบรายการที่ซ้ำในลิสต์ __all__ เพื่อให้เป็นระเบียบขึ้น
• ทำให้ตัวเลือกของไคลเอนต์ง่ายขึ้น: ลดหลายบรรทัดด้วยการรวมการนำเข้าที่คล้ายกันเข้าด้วยกันในคำสั่งเดียว

นี่คือการเปรียบเทียบแบบเคียงข้างกันระหว่างโค้ดต้นฉบับกับโค้ดที่รีแฟกเตอร์แล้ว

การจัดทำเอกสารโค้ด

นอกจากรีแฟกเตอร์แล้ว Claude Code ยังสามารถสร้าง อัปเดต และมาตรฐานเอกสารโค้ดทั่วทั้งโปรเจกต์ ระบุส่วนที่ไม่มีเอกสาร สร้างโดกสตริงหรือคอมเมนต์แบบมีโครงสร้าง และตรวจสอบความสอดคล้องตามมาตรฐานเอกสารของโปรเจกต์ได้

เราใช้ Claude Code เพื่อปรับปรุงเอกสารใน client.py ส่งผลให้:

• มีโดกสตริงระดับโมดูลที่ชัดเจน อธิบายวัตถุประสงค์ของไฟล์
• คอมเมนต์ระดับส่วนที่ละเอียด แยกประเภทการนำเข้า (ชนิดข้อผิดพลาด การทำงานของไคลเอนต์ บริการจัดเก็บ)
• คอมเมนต์อินไลน์เพื่ออธิบายชนิดข้อผิดพลาด ฟังก์ชันของไคลเอนต์ และคอมโพเนนต์สำคัญ

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

พรอมป์ต: จัดทำเอกสารโค้ด client.py โดยเพิ่มคอมเมนต์เพื่อช่วยให้เข้าใจได้ดีขึ้น

เมื่อเพิ่มเอกสารแล้ว สามารถตรวจสอบความสอดคล้องตามมาตรฐานของโปรเจกต์ได้ด้วยการสั่งให้ Claude ตรวจสอบ:

พรอมป์ต: ตรวจสอบว่าเอกสารเป็นไปตามมาตรฐานของโปรเจกต์หรือไม่

การแก้บั๊ก

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

วิธีใช้ Claude Code เพื่อดีบักมีดังนี้:

1. ระบุปัญหา:  ส่งต่อข้อความผิดพลาดให้ Claude
2. ขอคำแนะนำการแก้ไข: ขอแนวทางแก้ปัญหาที่เป็นไปได้จาก Claude
3. นำไปใช้และตรวจสอบผล:  นำข้อเสนอของ Claude ไปใช้และตรวจสอบว่าปัญหาได้รับการแก้ไขหรือไม่

Claude Code ดำเนินการดังต่อไปนี้เพื่อแก้ปัญหาที่เกี่ยวกับการนำเข้าในไฟล์ client.py: 

• คอมเมนต์ type ignore: เพิ่มคอมเมนต์ # type: ignore เพื่อปิดคำเตือนของ IDE และตัวตรวจสอบชนิดข้อมูลสำหรับการนำเข้าที่แก้ไม่เจอ
• จัดหมวดข้อผิดพลาดให้สม่ำเสมอ: ทำให้การนำเข้าข้อผิดพลาดจากส่วนยืนยันตัวตน ฐานข้อมูล จัดเก็บ และฟังก์ชันถูกจัดกลุ่มไว้อย่างชัดเจน
• คงความอ่านง่ายของโค้ด: เพิ่มคอมเมนต์เพื่ออธิบายเหตุผลที่มองข้ามการนำเข้าบางรายการ แทนที่จะลบออก

นี่คือการเปรียบเทียบแบบเคียงข้างกันระหว่างโค้ดต้นฉบับกับโค้ดที่แก้ไขแล้ว

พรอมป์ต: พบบั๊กบางอย่าง เช่น 'Import gotrue.errors' ไม่สามารถแก้ไขได้ ช่วยแก้ข้อผิดพลาดทั้งหมดใน client.py

คำสั่งของ Claude Code

นี่คือคำสั่งบางส่วนที่แนะนำให้ลองใช้กับ Claude

แนะนำให้ดู บทเรียนทางการของ Anthropic และ แนวปฏิบัติที่ดีที่สุดสำหรับ Claude Code ของเราเพิ่มเติมด้วย

ฟีเจอร์ขั้นสูงของ Claude Code

เมื่อคุ้นเคยกับพื้นฐานของการรีแฟกเตอร์และการดีบักแล้ว สามารถต่อยอดความสามารถของ Claude Code ได้ด้วยการปรับแต่งพฤติกรรมการทำงาน Hooks และ Plugins ช่วยทำงานซ้ำๆ ให้เป็นอัตโนมัติและผสานกับระบบภายนอก

Claude Code hooks

Claude Code hooks คือทริกเกอร์อัตโนมัติที่รันคำสั่งเชลล์เมื่อเกิดเหตุการณ์เฉพาะระหว่างเซสชัน Claude Code ของคุณ ใช้ทำงานซ้ำๆ เช่น จัดรูปแบบโค้ด รันเทสต์ และตรวจสอบความปลอดภัยที่ Claude อาจข้ามไป

Hooks ใช้ระบบ event-action โดยกำหนด 3 อย่างคือ:

• เหตุการณ์: Hook จะถูกทริกเมื่อใด

• ตัวจับคู่: การกระทำใดได้รับผล

• คำสั่ง: รันอะไรเมื่อ Hook ทำงาน

เช่น อาจตั้ง Hook ให้ทริกหลัง Claude เขียนไฟล์ Python แล้วรัน black เพื่อจัดรูปแบบโค้ดโดยอัตโนมัติ Hooks จะได้รับบริบทแบบ JSON เกี่ยวกับสิ่งที่เกิดขึ้น ทำให้ตัดสินใจอย่างชาญฉลาดตามชนิดไฟล์หรือพาธได้ ผลลัพธ์สามารถส่งไปยังทรานสคริปต์ของ Claude หรือส่งข้อความผิดพลาดให้ Claude เพื่อบล็อกการดำเนินการได้

กรณีใช้งานทั่วไปของ hooks ได้แก่

• จัดรูปแบบโค้ด: รันลินเตอร์และฟอร์แมตเตอร์โดยอัตโนมัติหลังเขียนโค้ด

• การทดสอบ: รันชุดเทสต์หลังแก้ไขเพื่อจับบั๊กตั้งแต่เนิ่นๆ

• ความปลอดภัย: บล็อกการแก้ไขไฟล์สำคัญ เช่น คอนฟิกโปรดักชันหรือคีย์ API

• เอกสาร: สร้างเอกสาร API อัตโนมัติเมื่อไฟล์ต้นทางมีการเปลี่ยนแปลง

• Git อัตโนมัติ: สร้างคอมมิตอย่างชาญฉลาดและตรวจสอบนโยบายปกป้องสาขา

• การแจ้งเตือน: แจ้งทีมผ่าน Slack เมื่อไฟล์สำคัญมีการเปลี่ยนแปลง

• การปฏิบัติตามข้อกำหนด: บังคับใช้ส่วนหัวลิขสิทธิ์หรือมาตรฐานการเขียนโค้ดก่อนอนุญาตให้แก้ไข

ตั้งค่า hooks ด้วยคำสั่ง /hooks ใน Claude Code หรือแก้ไขโดยตรงที่ ~/.claude/settings.json

Claude Code plugins

ปลั๊กอินเป็นส่วนขยายที่เชื่อม Claude Code กับเครื่องมือ บริการ และ API ภายนอก ขณะที่ hooks ทำงานคำสั่งเชลล์ภายในเครื่อง ปลั๊กอินจะผสานกับระบบพัฒนาที่กว้างขึ้น เช่น สายนำส่ง CI/CD เครื่องมือจัดการโปรเจกต์ และแพลตฟอร์มสื่อสารทีม

ปลั๊กอินสามารถรวมหลายคอมโพเนนต์—ซับเอเจนต์ (ผู้ช่วย Claude เฉพาะงาน), เซิร์ฟเวอร์ MCP (การผสานเครื่องมือแบบมาตรฐาน) และ hooks—ไว้ในแพ็กเกจเดียวเพื่อประสานงานร่วมกัน

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

งานที่ปลั๊กอินของ Claude Code เหมาะเป็นพิเศษ ได้แก่:

• ผสาน CI/CD: ทริกการบิลด์ เทสต์ และดีพลอยเมื่อไฟล์เปลี่ยน

• การจัดการโปรเจกต์: สร้างหรืออัปเดตอีชชูใน Jira, GitHub หรือ Linear อัตโนมัติ

• การสื่อสารทีม: โพสต์อัปเดตไปยัง Slack หรือ Teams เมื่อมีการเปลี่ยนแปลง

• รีวิวโค้ด: สร้างพุลรีเควสและจัดการรีวิวอัตโนมัติบน GitHub/GitLab

• การวิเคราะห์ภายนอก: เรียกใช้ SonarQube, CodeClimate หรือ Snyk เพื่อสแกนโค้ดระดับองค์กร

• เครื่องมือเฉพาะ: ผสานกับระบบและเวิร์กโฟลว์เฉพาะของบริษัท

• ส่วนขยาย IDE: เพิ่มคำสั่งแบบกำหนดเองและตัวช่วยนำทาง

ติดตั้งปลั๊กอินจากรีจิสทรีหรือพัฒนาภายในองค์กร แล้วกำหนดเหตุการณ์ที่จะตอบสนอง Hooks และปลั๊กอินร่วมกันสร้างแพลตฟอร์มแบบขยายได้ที่ปรับ Claude Code ให้เข้ากับโครงสร้างพื้นฐานที่มีอยู่ของคุณ

ฟีเจอร์ขั้นสูงอื่นๆ

ในปี 2026 Claude Code ได้เพิ่มความสามารถสำคัญอีกหลายอย่างที่ขยายวิธีและสถานที่ใช้งาน:

• Plan mode: เวิร์กโฟลว์เน้นการออกแบบ โดย Claude จะสร้างแผนการดำเนินการอย่างละเอียดก่อนเขียนโค้ด ใช้ได้ดีกับงานที่ไม่เล็ก
• Auto mode: ตัวจัดการสิทธิ์ที่ทำให้ Claude ทำงานได้โดยขัดจังหวะน้อยลง เหมาะกับงานยาวๆ ที่ไม่ต้องการอนุมัติทุกครั้งที่เขียนไฟล์
• Routines: เอเจนต์คลาวด์ตามกำหนดเวลาที่ทำงานตาม cron อีเวนต์ของ GitHub (เช่น เปิด PR) หรือการเรียก webhook โดยไม่ต้องเปิดเครื่องของคุณ
• การผสานกับ IDE: มีส่วนขอยสำหรับ VS Code, Cursor และ JetBrains พร้อม diff อินไลน์ เช็คพอยต์ และรองรับหลายเซสชัน
• การควบคุมระยะไกลและ Channels: รันเซสชัน Claude Code และโต้ตอบจากโทรศัพท์หรืออุปกรณ์อื่นได้

ข้อคิดส่งท้าย

ในบทเรียนนี้ เราใช้ Claude Code เพื่อรีแฟกเตอร์ จัดทำเอกสาร และดีบักไฟล์ใน Supabase Python SDK เราปรับปรุงความอ่านง่ายของโค้ด เพิ่มเอกสารที่มีโครงสร้าง และแก้ปัญหาการนำเข้า

Claude Code กำลังพัฒนาอย่างต่อเนื่องด้วยฟีเจอร์อย่าง plan mode, auto mode และ Routines ควรลองใช้งานกับโปรเจกต์ของตนเองเพื่อดูว่าเข้ากับเวิร์กโฟลว์ได้อย่างไร

เพื่อก้าวต่อไป แนะนำให้อ่านบทเรียน แนวปฏิบัติที่ดีที่สุดของ Claude Code ที่สอนการใช้หน้าต่างคอนเท็กซ์ของ Claude ให้เกิดประโยชน์สูงสุด หากต้องการสร้างโปรเจกต์ตั้งแต่ศูนย์ แนะนำบทเรียน การพัฒนาแบบยึดสเปคด้วย Claude Code