Claude Code SDK là công cụ mạnh mẽ giúp các nhà phát triển tích hợp trợ lý lập trình thông minh Claude vào các ứng dụng của mình. Bài viết này sẽ hướng dẫn chi tiết cách sử dụng bộ công cụ này để tạo ra những giải pháp AI hỗ trợ lập trình hiệu quả.
Mục lục
Tổng Quan Về Claude Code SDK
Bộ SDK này cho phép bạn chạy Claude Code như một tiến trình con, tạo điều kiện xây dựng các công cụ hỗ trợ lập trình thông minh. Hiện tại, SDK hỗ trợ sử dụng qua dòng lệnh, với phiên bản TypeScript và Python sẽ sớm được ra mắt.
Cách Sử Dụng Cơ Bản
Claude Code SDK cho phép sử dụng Claude trong chế độ không tương tác. Dưới đây là một số ví dụ điển hình:
# Chạy một câu lệnh đơn giản (chế độ in)<br>
$ claude -p "Viết hàm tính dãy Fibonacci"<br>
# Sử dụng đường ống để cung cấp dữ liệu đầu vào<br>
$ echo "Giải thích đoạn code này" | claude -p<br>
# Xuất kết quả dạng JSON kèm metadata<br>
$ claude -p "Tạo hàm hello world" --output-format json
Cách Sử Dụng Nâng Cao
Đàm Thoại Nhiều Lượt
Bạn có thể tiếp tục các cuộc hội thoại trước đó:
# Tiếp tục cuộc hội thoại gần nhất<br>
$ claude --continue<br>
# Tiếp tục và thêm prompt mới<br>
$ claude --continue "Hãy tối ưu hiệu năng đoạn code này"<br>
# Tiếp tục cuộc hội thoại cụ thể bằng session ID<br>
$ claude --resume 550e8400-e29b-41d4-a716-446655440000
Prompt Hệ Thống Tùy Chỉnh
Bạn có thể cung cấp prompt hệ thống để hướng dẫn hành vi của Claude:
# Ghi đè prompt hệ thống<br>
$ claude -p "Xây dựng REST API" --system-prompt "Bạn là kỹ sư backend...<br>
# Thêm hướng dẫn vào prompt mặc định<br>
$ claude -p "Xây dựng REST API" --append-system-prompt "Sau khi viết code..."
Cấu Hình MCP
Model Context Protocol (MCP) cho phép mở rộng Claude Code với các công cụ và tài nguyên bổ sung từ máy chủ bên ngoài.
{<br>
"mcpServers": {<br>
"filesystem": {<br>
"command": "npx",<br>
"args": [<br>
"-y",<br>
"@modelcontextprotocol/server-filesystem",<br>
"/path/to/allowed/files"<br>
]<br>
}<br>
}<br>
}
Định Dạng Đầu Ra
SDK hỗ trợ nhiều định dạng đầu ra:
Đầu Ra Văn Bản (Mặc Định)
Đầu Ra JSON
Đầu Ra JSON Dạng Luồng
Ví Dụ Thực Tế
Tích Hợp Vào Script
#!/bin/bash<br>
run_claude() {<br>
local prompt="$1"<br>
if claude -p "$prompt"; then<br>
echo "Thành công!"<br>
else<br>
echo "Lỗi" >&2<br>
return 1<br>
fi<br>
}
Xử Lý File Với Claude
# Xử lý nhiều file<br>
$ for file in *.js; do<br>
claude -p "Thêm JSDoc cho file này:" < "$file" > "${file}.documented"<br>
done
Thực Hành Tốt Nhất
- Sử dụng định dạng JSON để phân tích cú pháp chương trình
- Xử lý lỗi một cách gọn gàng
- Quản lý phiên làm việc cho các cuộc hội thoại nhiều lượt
- Xem xét thời gian chờ cho các thao tác dài
- Tôn trọng giới hạn tốc độ khi gửi nhiều yêu cầu
Ứng Dụng Thực Tế
Claude Code SDK cho phép tích hợp mạnh mẽ vào quy trình phát triển, đặc biệt với Claude Code GitHub Actions, cung cấp khả năng review code tự động và xử lý issue trực tiếp trên GitHub.