2.5K 33 59

Đã đăng vào khoảng 5 giờ trước 10 phút đọc

Claude Code Toàn Tập: 34 Kỹ Thuật Thực Chiến Phát Triển API Thời Đại AI

Thực Tế Phũ Phàng: "AI Code Nhanh, Nhưng Quy Trình API Vẫn Chậm"

Đây là chuyện đã xảy ra với team mình vào tuần trước.

Bọn mình đang dùng Claude Code để viết API với tốc độ tên lửa, nhưng rồi mình chợt nhận ra: "Ủa, viết code mất có 5 phút mà test mất cả ngày... có gì đó sai sai?"

Dùng ChatGPT hay Claude Code, mình có thể tạo 10 endpoint REST API trong 30 phút. Nhưng để test thủ công đống đó thì mất hơn nửa ngày.

"Tại sao code nhanh hơn mà hiệu suất tổng thể vẫn dậm chân tại chỗ?"

Khi tìm ra câu trả lời, mình hiểu rằng vấn đề không nằm ở công cụ, mà ở thiết kế của toàn bộ quy trình (workflow).

Trong bài viết này, mình sẽ chia sẻ 34 kỹ thuật thực chiến mà team mình đang áp dụng trong "Quy trình phát triển API thời đại AI", với Claude Code là trung tâm.

Nếu bạn cũng cảm thấy "AI viết code thì ngon nhưng đoạn sau thì cực quá", thì bài viết này dành cho bạn.

"Cái Bẫy" Khi Phát Triển Với AI Mà Mình Đã Trải Qua

I. Kỹ Thuật Dòng Lệnh (7 Chiêu Cơ Bản)

1. Hiểu Claude Code Là Một Công Cụ CLI

Đây là điều quan trọng nhất.

Claude Code không chỉ là một cái editor, nó là một công cụ phát triển điều khiển bằng dòng lệnh.

# Khởi tạo dự án và tạo luôn đặc tả API
claude -P "Tạo dự án REST API và xuất luôn file đặc tả OpenAPI"

Mẹo ở đây là yêu cầu nó tạo đặc tả API ở định dạng có thể import vào công cụ quản lý API ngay từ đầu.

2. Tối Ưu Hóa Bằng Cách Truyền Tham Số

# Tạo hàng loạt endpoint cụ thể
claude -P "User Management API (CRUD) + Auth API + OpenAPI 3.0 Specs"

Bằng cách import file OpenAPI được tạo ra vào công cụ quản lý API, việc sinh code và thiết kế API sẽ được đồng bộ.

3. Kiểm Tra Nhanh Không Cần Mode

# Kiểm tra đặc tả API với giao diện UI
claude -P --ui "Tạo frontend dùng thử để test API vừa tạo"

4. Pipeline Kết Nối Các Công Cụ

Đây là thứ thay đổi tất cả.

# Claude Code → Tạo OpenAPI → Tự động import vào API Tool
claude generate-api | api-tool import --auto-test

5. Phát Triển Dựa Trên Dữ Liệu (Data-Driven)

# Thêm tính năng mới từ đặc tả API có sẵn
cat existing-api.yaml | claude "Thêm chức năng thanh toán vào đặc tả này"

6. Chạy Song Song Nhiều Instance

# Code frontend và backend song song
claude instance-1 "Tạo React API Client" &
claude instance-2 "Triển khai Express.js API" &

7. Tự Kích Hoạt (Self-Triggering) Để Code Liên Tục

# Để Claude Code tự chạy task tiếp theo
claude "Thêm test case vào API này và chạy test trên một instance Claude Code mới"

II. Kỹ Thuật Phát Triển Trực Quan (6 Cách Dùng Hình Ảnh)

8. Thiết Kế API Bằng Kéo & Thả

Cái này siêu tiện luôn.

Kéo file thiết kế Figma trực tiếp vào Claude Code, nó sẽ tự đoán các API endpoint cần thiết.

Import đặc tả API vừa tạo vào công cụ quản lý API, thiết kế và API sẽ đồng bộ hoàn toàn.

9. Kết Hợp Chụp Màn Hình macOS

# Shift+Command+Control+4 để chụp màn hình đặc tả API
# Control+V để dán → Claude Code sẽ hiểu đặc tả

10. Tạo API Bằng Cách Dán (Paste)

Người dùng Windows/Linux dùng Control+V để dán ảnh chụp màn hình.

Từ ảnh chụp tài liệu thiết kế API, nó có thể tạo ra code chạy được và đặc tả OpenAPI cùng lúc.

11. Full-Stack Từ File Thiết Kế

File Thiết Kế → Claude Code → Frontend + API + OpenAPI Spec → Công Cụ Quản Lý API

Với quy trình này, từ thiết kế đến lúc có API test được chỉ mất 30 phút.

12. Vòng Lặp Phản Hồi Hình Ảnh

Mô hình lặp thủ công:

Chạy test trên công cụ quản lý API
Chụp màn hình kết quả (Shift+Command+Control+4)
Dán vào Claude Code để nhờ sửa
Sửa code → Test lại

# Ví dụ thực tế
claude "Nhìn kết quả này đi, format response không đúng kỳ vọng. Sửa giúp mình nhé"
# → Dán hình chụp
# → Claude Code tìm lỗi và đưa ra cách sửa

Điểm mấu chốt:

Bản đầu tiên chỉ cần xong 60% là được.
Sau 2-3 vòng lặp, chất lượng sẽ tăng vọt.
Có hình ảnh phản hồi, Claude Code hiểu vấn đề chính xác hơn hẳn.

13. Kết Hợp Puppeteer MCP Để Lặp Tự Động

Đây là mô hình phát triển API hiệu quả nhất.

Dùng Puppeteer MCP Server để gắn "mắt" cho Claude Code:

// 1. Claude Code implement API
// 2. Puppeteer MCP tự chụp màn hình kết quả test trên API tool
// 3. Gửi kết quả lại cho Claude Code
// 4. Tìm điểm cần sửa và implement lại
// 5. Lặp lại cho đến khi ngon

const visualFeedbackLoop = async () => {
  // Chạy test trên API tool
  const testResult = await puppeteer.screenshot();
  // Gửi cho Claude Code để lấy đề xuất sửa đổi
  // Test lại với code mới
};

Quy trình thực tế:

Cung cấp Mockup: Đưa thiết kế Figma hoặc màn hình kết quả mong muốn cho Claude Code.
Implement: Claude Code tạo API và Frontend.
Tự động chụp màn hình: Puppeteer MCP chụp kết quả chạy thực tế.
So sánh & Cải thiện: Claude Code so sánh mock vs thực tế để tìm lỗi.
Lặp: Lặp 2-3 lần đến khi ưng ý.

Giống như con người, Claude Code cũng cần làm đi làm lại để chất lượng đầu ra xịn hơn.

III. Kỹ Thuật Tích Hợp Hệ Thống Bên Ngoài (5 Mô Hình)

14. Tận Dụng MCP Server/Client

Việc Claude Code có thể đóng vai trò MCP Client để kết nối dịch vụ bên ngoài là một tính năng cực mạnh.

Ví dụ, dùng Apidog MCP Server để Claude Code truy cập trực tiếp vào đặc tả API trong dự án Apidog:

// Cấu hình kết nối Apidog MCP Server
{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project=<project-id>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

15. Kết Nối Database Trực Tiếp

# Thông qua Postgres MCP để thiết kế API + DB cùng lúc
claude "Từ cái hình ERD này, tạo REST API, DB migration và test case cho API tool giúp mình"

16. Lấy Tài Liệu API Real-time

# Lấy spec mới nhất qua Cloudflare MCP
claude "Dựa trên spec mới nhất của Cloudflare Workers API, implement một API tương tự"

17. Phân Tích Trực Tiếp Từ URL

Cái này quá tiện.

# Dán URL tài liệu API có sẵn
claude "Tham khảo https://api.example.com/docs và implement một API tương thích, có thể test được"

18. Tích Hợp Kiến Thức Bên Ngoài

# Ví dụ API luật chơi game
claude "Tham khảo https://pokemon.fandom.com/wiki/Type để làm API tính khắc hệ Pokemon"

Quy Trình Thay Đổi Thế Nào Khi Có Công Cụ Quản Lý API?

Tại Sao Cần Công Cụ Quản Lý API?

Claude Code viết code nhanh, nhưng làm API còn cả núi việc "ngoài code":

Quản lý đặc tả (Spec)
Viết và chạy Test case
Tạo và cập nhật tài liệu
Chia sẻ spec với anh em trong team
Kiểm tra hoạt động trên môi trường thật

Làm thủ công mấy cái này thì thời gian tiết kiệm được nhờ Claude Code bay sạch.

Đó là lý do mình dùng một công cụ để trung tâm hóa việc thiết kế, test và tài liệu API (như Apidog).

Apidog Là Gì?

Apidog là nền tảng bao thầu trọn vòng đời phát triển API:

Thiết kế API: Tạo/sửa OpenAPI spec
Mock: Giả lập API trước khi code xong
Test: Chạy test API tự động
Tài liệu: Tự sinh tài liệu đẹp đẽ
Hợp tác: Chia sẻ spec cho cả team

Điểm hay nhất là bạn có thể import trực tiếp OpenAPI spec do Claude Code tạo ra, giúp code và quản lý API đồng bộ hoàn toàn.

IV. Kỹ Thuật Tận Dụng File Cấu Hình `claude.md` (7 Mẫu)

19. `claude.md` Như Một System Prompt

Đây là 'bí kíp' để làm chủ Claude Code.

# claude.md
Dự án này yêu cầu bắt buộc:
- Tất cả API phải có đặc tả OpenAPI 3.0
- Output format phải import được vào công cụ quản lý API
- Tạo luôn test case
- Luôn phải có xử lý lỗi (error handling)

20. Tự Động Tạo Với `/init`

cd my-api-project
claude /init
# → Phân tích cấu trúc dự án và tự tạo claude.md

21. Cập Nhật Động Với `#`

Thêm cấu hình real-time trong lúc đang code.

claude "# API này cần xác thực. Dùng JWT token và làm sao để test được trên API tool nha"
# → Tự động ghi thêm vào claude.md

22. Cấu Hình Global

# ~/.claude/claude.md
echo "Luôn tạo OpenAPI spec import được vào API tools" > ~/.claude/claude.md

23. Cấu Hình Theo Thư Mục

project/
├── claude.md (Cấu hình chung)
├── api/
│   └── claude.md (Cấu hình riêng cho API)
└── frontend/
    └── claude.md (Cấu hình riêng cho Frontend)

24. Tối Ưu Hóa Cấu Hình Định Kỳ

Mỗi tháng mình xem lại claude.md một lần.

Đặc biệt là khi tìm ra chiêu mới để kết hợp với các công cụ API, mình thêm vào ngay.

25. Tối Ưu Prompt Bằng Công Cụ Của Anthropic

Dùng Prompt Improver chính chủ để 'makeup' cho claude.md.

Dán nội dung claude.md vào Prompt Improver trên Claude Console để nó sửa lại cho xịn hơn.

# Trước khi tối ưu
Làm API cho dự án này

# Sau khi tối ưu
Dự án này cần tạo REST API với các yêu cầu sau:
- Tuân thủ chuẩn OpenAPI 3.0
- Implement xử lý lỗi phù hợp
- Tạo song song các test case

V. Custom Slash Command (6 Mẫu Tự Động Hóa)

26. Lệnh Giải Quyết GitHub Issue

# .claude/slash_commands/solve_github_issue
echo "Phân tích GitHub Issue và thực hiện: sửa API + cập nhật test case trên API tool" > solve_github_issue

27. Lệnh Refactor Code

# lệnh /refactor
claude /refactor "Chuyển API này sang Clean Architecture và update test tool"

28. Lệnh Check Quality

# lệnh /lint
claude /lint "Chạy ESLint + Check API Spec + Chạy test trên API tool"

29. Tự Động Review PR

# lệnh /review_pr
claude /review_pr "Kiểm tra thay đổi API và phân tích ảnh hưởng đến test case"

30. Lệnh Có Tham Số

# Slash command nhận tham số
claude /deploy staging --with-api-tests

31. Lệnh Dạng Template

# Template tạo API mới
claude /new-api user-management --include-auth --api-tool-ready

VI. Tối Ưu Giao Diện & Quy Trình (3 Mẹo)

32. Tab Completion (Tự động điền) Để Chính Xác Hơn

Chỉ định đúng tên file giúp Claude Code hiểu ý bạn nhanh hơn nhiều.

# Tận dụng phím Tab
claude "Sửa file src/api/[Tab]users[Tab]/controller.ts và update test luôn"

33. Dùng Esc Để "Quay Xe"

Thấy Claude Code đi sai hướng là bấm Esc ngay.

"Thôi chết, quên bảo nó tạo test case rồi" → Esc → Ra lệnh lại.

34. `undo` Để Quay Về

claude "undo" # Hủy thao tác vừa rồi
claude "Trả lại như cũ, nhưng lần này nhớ kèm OpenAPI spec để import nhé"

Những Thay Đổi Thực Tế Trong Quy Trình

Phát Triển API: Từ "Tuần Tự" Sang "Song Song"

Cách cũ:

Nghĩ Spec (30p)
Hì hục code (2 tiếng)
Test bằng Postman (1 tiếng)
Viết tài liệu (30p)

Cách mới (Claude Code + API Tool):

Claude Code tạo Spec + Code + Test case cùng lúc (30p)
Import vào API Tool và chạy test (10p)
Có lỗi thì báo Claude Code sửa → Test lại (10p)

Kết quả: 4 tiếng → 50 phút

Giảm Hẳn Hiểu Lầm Trong Team

Vấn đề cũ:

Frontend: "Không hiểu cái API này trả về gì"
Backend: "Test case cũ rồi, chưa update"
QA: "Không biết test đến đâu là đủ"

Hiện tại:

Claude Code sinh ra OpenAPI spec chuẩn.
Cả team dùng chung môi trường test trên API tool.
Sửa spec là test case tự động update theo.

Chất Lượng Code AI Ổn Định

Bằng cách yêu cầu Claude Code "xuất format để test được trên API tool":

Không bao giờ quên error handling.
Format trả về luôn đồng nhất.
Test case có sẵn luôn.

Tổng Kết: Phát Triển API Thời Đại AI Là Cuộc Chơi Của "Sự Kết Hợp"

Claude Code một mình đã mạnh, nhưng kết hợp với công cụ quản lý API thì mới là 'bá đạo'.

Mấu chốt không phải là:

AI viết code
Người viết test

Mà là:

AI tạo Code + Test + Spec cùng lúc
Người thiết kế và giám sát luồng đi

Nếu bạn thấy "AI code nhanh nhưng đoạn sau mệt quá", hãy thử quy trình này xem.

Vấn đề đôi khi không phải ở trình độ, mà là ở cách bạn phối hợp các công cụ.

Nếu thấy bài viết có ích, hãy share nhé! Nếu bạn có quy trình hay ho khác, comment chia sẻ với mình nha.