คู่มือเคล็ดลับ Claude Code ฉบับสมบูรณ์สำหรับนักพัฒนา

หากคุณกำลังเจาะลึก Claude Code ซึ่งเป็นผู้ช่วยเขียนโค้ดที่ขับเคลื่อนด้วย AI อันทรงพลังของ Anthropic การมีข้อมูลอ้างอิงที่ชัดเจนเป็นสิ่งสำคัญ เอกสารสรุป Claude Code นี้มีไว้สำหรับนักพัฒนาที่ต้องการคำแนะนำเชิงปฏิบัติที่เข้าใจง่ายสำหรับผู้เริ่มต้น ซึ่งครอบคลุมการตั้งค่า เวิร์กโฟลว์ การกำหนดค่า และเคล็ดลับขั้นสูง เมื่ออ่านจบ คุณจะรู้สึกมั่นใจมากขึ้นในการใช้ Claude Code ในสภาพแวดล้อมภายในเครื่องของคุณ หรือเป็นส่วนหนึ่งของกระบวนการ CI/CD ของคุณ

Claude Code คืออะไร?

Claude Code คือเครื่องมือเขียนโค้ด AI แบบ CLI โดย Anthropic ช่วยให้นักพัฒนาสามารถสร้าง ปรับปรุง ทดสอบ และจัดทำเอกสารโค้ดโดยใช้โมเดลขั้นสูงของ Claude แทนที่จะเป็นเพียงอินเทอร์เฟซแชทแบบเรียบง่าย Claude Code ทำงานเหมือน AI IDE: มันเข้าใจโครงสร้างพื้นที่เก็บข้อมูลของคุณ ใช้แนวทางการป้องกันที่กำหนดไว้ในไฟล์กำหนดค่า สามารถรันคำสั่ง bash และทำงานร่วมกับเวิร์กโฟลว์ Git

ติดตั้ง Claude Code:

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

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

# NPM:
npm install -g @anthropic-ai/claude-code

# Homebrew:
brew install --cask claude-code

เริ่มใช้ Claude Code:

cd your-project
claude

ส่วนประกอบสำคัญของ Claude Code — เอกสารสรุปของคุณ

นี่คือส่วนประกอบสำคัญและคุณสมบัติที่คุณควรรู้เมื่อเริ่มต้นใช้งาน Claude Code:

1. CLAUDE.md — ไฟล์ประกาศตัวตนของเอเจนต์

• ไฟล์ CLAUDE.md คือ "ธรรมนูญ" สำหรับเอเจนต์ของคุณ: มันกำหนดว่า Claude จะทำงานอย่างไรในพื้นที่เก็บข้อมูลของคุณ
• ใช้เพื่อจัดทำเอกสารเครื่องมือที่ได้รับอนุมัติ เวิร์กโฟลว์ทั่วไป และข้อจำกัด
• แนวทางปฏิบัติที่ดีที่สุด: ทำให้กระชับ มุ่งเน้นไปที่แนวทางป้องกันที่สำคัญ และหลีกเลี่ยงการฝังเอกสารขนาดใหญ่มาก

# MyProject CLAUDE.md

## Project Overview  
This is a Node.js + Express REST API for a task management application.  

## Technology Stack  
- Backend: Node.js (ES6), Express  
- Database: PostgreSQL  
- Testing: Jest  
- Linting & Style: ESLint, Prettier

## Development Commands  
- `npm install` — Install dependencies  
- `npm run dev` — Start development server  
- `npm run test` — Run all tests  
- `npm run lint` — Run linter  

## Coding Standards  
- Use 2-space indentation.  
- Always use `async / await` instead of `.then()` chains.  
- Functions must have JSDoc comments.  
- Prefer composition over inheritance.

## Git Workflow  
- Feature branches must follow this pattern: `feature/FOO`  
- Use `git rebase` instead of `merge` for updating branches.  
- When committing: write descriptive commit messages that follow the Conventional Commits format.

## File Structure Guidance  
- `src/` — Your main application code  
- `tests/` — Test files  
- `scripts/` — Utility or setup scripts  
- `migrations/` — Database migrations  

## Known Issues / Workarounds  
- `db.connect()` sometimes times out; in that case, retry twice.  
- For large JSON payloads, use streaming to avoid memory issues.

## Memory / Style Preferences  
- Always ask for clarification if the request is ambiguous.  
- Do not generate new `.md` files unless explicitly instructed.  
- Include a `co-authored-by Claude` line in generated commits.

2. การจัดการบริบท

ก. ใช้ /context เพื่อตรวจสอบการใช้โทเค็นของเซสชัน Claude ปัจจุบันของคุณ

ข. คำสั่งสำหรับการรีสตาร์ทหรือลดบริบท:

• /clear + /catchup: ล้างการสนทนาทั้งหมด แล้วโหลดไฟล์จาก commit หรือ branch ใหม่
• เวิร์กโฟลว์ “จัดทำเอกสารและล้าง”: ให้ Claude ถ่ายทอดแผนการของมันลงในไฟล์ Markdown ล้างหน่วยความจำ จากนั้นโหลดใหม่จากไฟล์นั้น

3. คำสั่ง Slash

• คำสั่ง Slash เป็นทางลัดไปยังข้อความพร้อมท์ที่กำหนดไว้ล่วงหน้า
• ตัวอย่าง:

• ใช้คำสั่ง slash ให้กระชับและตรงประเด็น; อย่าพึ่งพามันสำหรับทุกงาน

4. โหมดวางแผน

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

5. ซับเอเจนต์และการมอบหมายงาน

• Claude Code รองรับ ซับเอเจนต์ ซึ่งช่วยให้คุณสามารถมอบหมายส่วนของงานให้กับ "โคลน" ของเอเจนต์หลัก
• Shrivu ชอบสถาปัตยกรรมแบบ “Master-Clone”: เอเจนต์หลักสร้างโคลนผ่าน Task(...) แทนที่จะใช้ซับเอเจนต์เฉพาะทางแบบตายตัว
• สิ่งนี้ช่วยรักษาความยืดหยุ่นในขณะที่หลีกเลี่ยงการแตกส่วนของบริบท
• เข้าถึงซับเอเจนต์ของ Claude Code โดยใช้คำสั่ง slash: /agents

6. Claude Skills เทียบกับ MCP — แตกต่างกันอย่างไร?

ก. Claude Skills คือ "โมดูล" ที่สร้างไว้ล่วงหน้าซึ่งสอน Claude วิธีการทำงานเฉพาะเจาะจง พวกมันถูกเขียนด้วย Markdown หรือโค้ด และจะโหลดเมื่อจำเป็นเท่านั้น คุณสามารถใช้ Skills เพื่อกำหนดเวิร์กโฟลว์ เช่น การจัดรูปแบบรายงาน การสรุปข้อมูล หรือการบังคับใช้รูปแบบของทีมคุณ

ข. ในทางกลับกัน Model Context Protocol (MCP) คือ โปรโตคอลสำหรับเชื่อมต่อ Claude เข้ากับข้อมูลและเครื่องมือภายนอก เช่น ฐานข้อมูล โค้ดเบสของคุณ หรือระบบธุรกิจ มันเหมือนกับ "อะแดปเตอร์สากล" ที่ช่วยให้ Claude เข้าถึงและดำเนินการกับทรัพยากรภายนอกได้โดยไม่ต้องมีการรวมเครื่องมือแต่ละตัวแบบกำหนดเอง

ค. ความแตกต่างที่สำคัญ:

1. วัตถุประสงค์:

• Skills เข้ารหัส *ความรู้เชิงขั้นตอน*
• MCP จัดการ *การเชื่อมต่อเครื่องมือและข้อมูล*

2. ประสิทธิภาพโทเค็น:

• Skills จะโหลดเมื่อจำเป็นเท่านั้น โดยใช้โทเค็นค่อนข้างน้อย
• คำจำกัดความเครื่องมือ MCP สามารถใช้พื้นที่โทเค็นจำนวนมากได้ หากเปิดใช้งานหลายรายการ

ง. กรณีการใช้งาน:

• ใช้ Skills เพื่อสอน Claude ถึงเวิร์กโฟลว์เฉพาะโดเมน (เช่น “เมื่อเขียนรายงานสถานะ ให้รวม X, Y, Z เสมอ”)
• ใช้ MCP เมื่อ Claude ต้องการ *อ่าน/เขียนข้อมูล* เรียกใช้ API หรือเข้าถึงระบบภายนอก เช่น Git หรือฐานข้อมูล

ในทางปฏิบัติ ทั้งสองทำงานร่วมกันได้ดีที่สุด: MCP ช่วยให้ Claude เข้าถึงข้อมูลของคุณ และ Skills สอน Claude ถึงวิธีใช้ข้อมูลนั้นในลักษณะที่มีโครงสร้างและสามารถทำซ้ำได้

6. Hooks

ก. Hooks คือวิธีการบังคับใช้กฎโดยอัตโนมัติ

ข. สองประเภททั่วไป:

• การบล็อกเมื่อส่ง (Block-at-submit): ตัวอย่างเช่น hook PreToolUse สามารถบล็อก git commit ได้เว้นแต่การทดสอบจะผ่าน
• Hint hooks: ไม่บล็อก; พวกมันให้คำแนะนำหรือข้อเสนอแนะโดยไม่หยุดการทำงาน

ค. หลีกเลี่ยง “block-at-write” hooks — การปล่อยให้ Claude ทำแผนให้เสร็จสิ้นแล้วจึงทำการตรวจสอบนั้นเสถียรกว่า

# ตัวอย่าง Hook ใน .claude/settings.toml

[[hooks]]
# เหตุการณ์ที่กระตุ้น hook
event = "PostToolUse" 

# (ไม่บังคับ) เงื่อนไขสำหรับการทำงานของ hook
[hooks.matcher]
tool_name = "edit_file"
file_paths = ["*.py", "api/**/*.py"]

# คำสั่งเชลล์ที่จะดำเนินการ
command = "ruff check --fix $CLAUDE_FILE_PATHS && black $CLAUDE_FILE_PATHS"

# (ไม่บังคับ) ไม่ว่าจะรันคำสั่งในเบื้องหลังหรือไม่
run_in_background = false 

7. CLI SDK

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

การติดตั้ง:

# Typescript:
npm install @anthropic-ai/claude-agent-sdk

# Python:
pip install claude-agent-sdk

8. Claude Code GitHub Actions (GHA)

• คุณสามารถรวม Claude Code เข้ากับ GitHub Actions ได้โดยตรง
• ใช้เพื่อสร้าง pull requests โดยอัตโนมัติ บังคับใช้มาตรฐานโค้ด หรือรันการตรวจสอบที่ขับเคลื่อนโดย CLAUDE.md ซึ่งเป็นส่วนหนึ่งของไปป์ไลน์ CI ของคุณ
• เนื่องจากมีการจัดเก็บบันทึก คุณจึงสามารถตรวจสอบพฤติกรรมของเอเจนต์และปรับปรุงไฟล์ CLAUDE.md ของคุณได้เมื่อเวลาผ่านไป

9. การตั้งค่าและการกำหนดค่า

ก. ใน settings.json คุณสามารถกำหนดค่าได้ดังนี้:

• พร็อกซี (HTTPS_PROXY) — มีประโยชน์สำหรับการดีบักการรับส่งข้อมูล CLI
• การหมดเวลา (MCP_TOOL_TIMEOUT, BASH_MAX_TIMEOUT_MS) — เพิ่มค่าเหล่านี้หากคุณรันงานที่ใช้เวลานาน
• คีย์ API (ANTHROPIC_API_KEY) — ใช้คีย์ของคุณจาก Anthropic หรือสคริปต์ตัวช่วย
• สิทธิ์ — ควบคุมว่า Claude Code ได้รับอนุญาตให้ดำเนินการเครื่องมือระบบใดบ้าง

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "ยินดีต้อนรับสู่ Acme Corp! ตรวจสอบแนวทางการเขียนโค้ดของเราได้ที่ docs.acme.com",
    "ข้อควรจำ: ต้องมีการตรวจสอบโค้ดสำหรับ PR ทั้งหมด",
    "นโยบายความปลอดภัยใหม่มีผลบังคับใช้"
  ]
}

คุณสมบัติขั้นสูงและเคล็ดลับเพื่อประสิทธิภาพ

1. การสลับโมเดล: เลือก Claude 4 Sonnet หรือ Opus ขึ้นอยู่กับงานของคุณ Sonnet รวดเร็วและคุ้มค่า; Opus มีความสามารถสูงกว่าสำหรับการเปลี่ยนแปลงที่ซับซ้อนและหลายไฟล์
2. โหมดการคิด (เคล็ดลับ): ผู้ใช้บางคนตั้งค่าโหมดการให้เหตุผลของ Claude เป็น think, think hard, think harder หรือ ultrathink เพื่อปรับระดับความลึกในการให้เหตุผล
3. คำสั่งแบบกำหนดเอง: กำหนดคำสั่ง slash ที่นำกลับมาใช้ใหม่ได้ใน .claude/commands พร้อมด้วยตัวยึดตำแหน่งแบบไดนามิก ($argument) ยอดเยี่ยมสำหรับการทดสอบ การสร้าง หรือการตรวจสอบ
4. ประวัติเซสชัน: ใช้ claude --resume หรือ claude --continue เพื่อดำเนินการต่อจากเซสชันเก่า Claude จัดเก็บประวัติเซสชันทั้งหมดไว้ในเครื่อง
5. วงจรการตอบรับ: ตรวจสอบพฤติกรรมของเอเจนต์ผ่านบันทึก GitHub Action หรือข้อมูลเซสชันย้อนหลัง และอัปเดต CLAUDE.md ของคุณเพื่อแก้ไขความเข้าใจผิดหรือบังคับใช้แนวทางป้องกันที่ดีขึ้น

คำถามที่พบบ่อย (FAQ)

Q1. จุดประสงค์ของ CLAUDE.md คืออะไร?
คำตอบ: CLAUDE.md ทำหน้าที่เป็นปฏิญญาของเอเจนต์ มันกำหนดกฎ เครื่องมือ และข้อตกลงสำหรับ Claude Code ที่จะปฏิบัติตาม ช่วยให้พฤติกรรมเป็นมาตรฐานเดียวกันทั่วทั้งพื้นที่เก็บข้อมูลของคุณ

Q2. ควรใช้ซับเอเจนต์หรืองานง่ายๆ?
คำตอบ: ใช้ซับเอเจนต์หากคุณต้องการเวิร์กโฟลว์แบบโมดูลาร์ที่เข้มงวด แต่หลายคนพบว่ารูปแบบ Master-Clone (การใช้ Task(...)) มีความยืดหยุ่นมากกว่า — คุณยังคงรักษาบริบทไว้ในขณะที่มอบหมายงานย่อย

Q3. ฉันจะรีสตาร์ทเซสชัน Claude โดยไม่สูญเสียข้อมูลทั้งหมดได้อย่างไร?<
คำตอบ: ใช้ /clear เพื่อรีเซ็ตการสนทนา จากนั้นใช้ /catchup เพื่อโหลดไฟล์จาก Git branch ของคุณ เพื่อให้ Claude มีบริบทเต็มรูปแบบอีกครั้ง

Q4. Hooks คืออะไร และทำไมฉันถึงต้องการมัน?
คำตอบ: Hooks บังคับใช้กฎหรือการตรวจสอบเมื่อ Claude ทำการคอมมิตงาน ตัวอย่างเช่น hook แบบ block-at-submit สามารถตรวจสอบให้แน่ใจว่าการทดสอบผ่านก่อนที่จะอนุญาตให้ Git commit ได้

Q5. ฉันจะรวม Claude Code เข้ากับ CI/CD ได้อย่างไร?
คำตอบ: ใช้ Claude Code GitHub Action เพื่อรันงาน ตรวจสอบโค้ด สร้าง pull requests หรือบังคับใช้แนวทางป้องกัน CLAUDE.md ของคุณในไปป์ไลน์อัตโนมัติ

บทสรุป

เอกสารสรุป Claude Code นี้ให้ภาพรวมที่เป็นประโยชน์และมีโครงสร้างเกี่ยวกับวิธีใช้ Claude Code อย่างมีประสิทธิภาพ ตั้งแต่การเขียนไฟล์ CLAUDE.md ที่จัดทำขึ้นอย่างดี ไปจนถึงการใช้ประโยชน์จากคำสั่ง slash, ซับเอเจนต์, hooks และการรวม CI — รูปแบบเหล่านี้เป็นรากฐานที่แข็งแกร่งสำหรับการใช้ Claude Code เป็นพันธมิตรการพัฒนาที่ขับเคลื่อนด้วย AI ที่เชื่อถือได้

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