ใช้ Claude Code ร่วมกับ GitHub อย่างไร? ตั้งค่าและเริ่มทำงานกับ Repository

การใช้ Claude Code กับ GitHub เริ่มได้โดยนำ Repository มาไว้ในเครื่อง แล้วเปิด Claude Code จากโฟลเดอร์โปรเจกต์ วิธีนี้ทำให้ Claude Code อ่านและแก้ไฟล์ในงานที่อยู่ในเครื่องได้ ส่วนการให้ Claude ทำงานอัตโนมัติบน Pull Request หรือ Issue เป็นอีกขั้นตอนหนึ่งที่ใช้ Claude Code GitHub Actions ผู้ใช้ ComSiam จึงควรเลือกวิธีให้ตรงกับงานก่อนเริ่มตั้งค่า

Claude Code ทำงานกับ GitHub ได้แบบไหนบ้าง

ทำงานกับ Repository ในเครื่อง: Clone โค้ดจาก GitHub ลงเครื่อง เปิด Terminal ในโฟลเดอร์นั้น แล้วใช้ Claude Code ช่วยสำรวจ แก้ไข และทดสอบไฟล์ การส่งการเปลี่ยนแปลงกลับ GitHub ยังคงทำผ่าน Git เช่น สร้าง Branch, Commit และ Push

ทำงานอัตโนมัติบน GitHub: ตั้งค่า Claude Code GitHub Actions เพื่อให้ Claude ทำงานใน Workflow เช่น ช่วยตอบคำสั่งใน Issue หรือ Pull Request วิธีนี้ต้องตั้งค่า Action และข้อมูลรับรองตามรูปแบบที่เลือก

เริ่มใช้ Claude Code กับ Repository บนเครื่อง

① เตรียมสิทธิ์เข้าถึง Repository
ตรวจว่าบัญชี GitHub ของคุณมีสิทธิ์อ่าน Repository หากเป็น Repository ส่วนตัว ให้ตั้งค่าการยืนยันตัวตนของ Git ตามวิธีที่คุณใช้อยู่ และอย่าวาง Token หรือข้อมูลลับลงใน Prompt หรือไฟล์ของโปรเจกต์

② Clone Repository ลงเครื่อง
ใช้คำสั่ง Git สำหรับ Clone โดยแทนที่ข้อความตัวอย่างด้วยที่อยู่ Repository ของคุณ

git clone [ที่อยู่ Repository]
cd [ชื่อโฟลเดอร์โปรเจกต์]

③ ตรวจสถานะและเปิด Claude Code
ก่อนเริ่มแก้ไข ตรวจสถานะไฟล์ด้วย git status --short เพื่อดูว่ามีการเปลี่ยนแปลงอยู่ก่อนแล้วหรือไม่ จากนั้นเริ่ม Claude Code ในโฟลเดอร์โปรเจกต์

claude

Claude Code จะทำงานจากโฟลเดอร์ที่เปิดอยู่ จึงควรตรวจให้แน่ใจว่าอยู่ใน Repository ที่ถูกต้อง

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

⑤ ตรวจการเปลี่ยนแปลงก่อนส่งกลับ GitHub
หลังทำงานเสร็จ อ่าน Diff และตรวจสถานะ Git ด้วย git status และ git diff รันทดสอบที่เกี่ยวข้อง แล้วจึงเลือกว่าจะ Stage, Commit และ Push หรือไม่ การส่งขึ้น Repository ควรทำเมื่อเข้าใจและยอมรับการเปลี่ยนแปลงแล้ว

Prompt เริ่มต้นสำหรับ Repository ใหม่

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

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

ตั้งค่า Claude Code GitHub Actions

ถ้าต้องการให้ Claude ทำงานจาก Issue หรือ Pull Request โดยอัตโนมัติ สามารถตั้งค่า Claude Code GitHub Actions ตามคู่มือของ Anthropic ได้ วิธีตั้งค่าแบบเริ่มต้นมีคำสั่ง /install-github-app ใน Claude Code ซึ่งช่วยนำทางการติดตั้ง GitHub App และการตั้งค่าที่จำเป็น โดยผู้ติดตั้งต้องมีสิทธิ์ผู้ดูแล Repository ตามเงื่อนไขของการตั้งค่านั้น

ก่อนเปิด Workflow ให้ตรวจสิทธิ์ที่ Action ต้องใช้ ขอบเขต Repository และ Secrets ที่จำเป็น หากใช้ API Key ให้เก็บเป็น GitHub Secret ห้ามเขียนคีย์ลงในไฟล์ Workflow หรือ Commit ลง Repository และควรตรวจคำแนะนำของ Claude ก่อน Merge ทุกครั้ง

ผู้ใช้ ComSiam ที่เพิ่งเริ่มต้นมักทำงานกับ Repository ในเครื่องก่อน เพราะไม่ต้องตั้งระบบอัตโนมัติบน GitHub เพิ่ม ส่วน Actions เหมาะเมื่อมีงานซ้ำที่ต้องการให้ทำงานตามเหตุการณ์ใน Repository

แนวทางลดความเสี่ยงระหว่างทำงาน

• ใช้ Branch แยกสำหรับงานใหม่ เพื่อให้ตรวจและย้อนการเปลี่ยนแปลงได้สะดวก
• ตรวจ git status ก่อนและหลังทำงาน เพื่อแยกงานเดิมออกจากงานใหม่
• อย่าอนุมัติคำสั่งหรือการแก้ไฟล์โดยไม่อ่านคำอธิบายและขอบเขต
• ตรวจ Diff และผลทดสอบก่อน Commit หรือ Push
• จำกัดสิทธิ์ของ GitHub Actions เท่าที่จำเป็น และเก็บข้อมูลลับไว้ใน Secrets

สรุป

การเริ่มใช้ Claude Code กับ GitHub ทำได้โดย Clone Repository ลงเครื่อง เปิด Claude Code ในโฟลเดอร์โปรเจกต์ แล้วให้สำรวจโครงสร้างก่อนมอบหมายงาน เมื่อต้องการให้ Claude ทำงานอัตโนมัติบน Issue หรือ Pull Request ค่อยตั้งค่า GitHub Actions เพิ่ม ไม่ว่าจะใช้แบบใด ควรตรวจสิทธิ์ Diff ผลทดสอบ และคำแนะนำก่อนส่งการเปลี่ยนแปลงกลับไปยัง Repository