Bỏ qua đến nội dung chính

Claude Code SDK

📖 Nội dung bài học

Tóm tắt

Claude Code SDK cho phép bạn chạy Claude Code theo chương trình từ bên trong các ứng dụng và script của riêng bạn. Nó có sẵn cho TypeScript, Python và qua CLI, cung cấp cho bạn chức năng Claude Code giống như bạn sử dụng trên terminal nhưng được tích hợp vào các quy trình làm việc lớn hơn.

SDK chạy chính xác Claude Code mà bạn đã quen thuộc. Nó có quyền truy cập vào tất cả các tool giống nhau và sẽ sử dụng chúng để hoàn thành bất kỳ tác vụ nào bạn giao cho nó. Điều này làm cho nó đặc biệt mạnh mẽ cho các tình huống tự động hóa và tích hợp.

Các tính năng chính

  • Chạy Claude Code theo chương trình
  • Chức năng Claude Code giống như phiên bản terminal
  • Kế thừa tất cả các cài đặt từ các phiên Claude Code trong cùng thư mục
  • Quyền chỉ đọc theo mặc định
  • Hữu ích nhất như một phần của các pipeline hoặc tool lớn hơn

Sử dụng cơ bản

Đây là một ví dụ TypeScript đơn giản yêu cầu Claude phân tích code để tìm các truy vấn trùng lặp:

import { query } from "@anthropic-ai/claude-code";

const prompt = "Look for duplicate queries in the ./src/queries dir";

for await (const message of query({
  prompt,
})) {
  console.log(JSON.stringify(message, null, 2));
}

Khi bạn chạy code này, bạn sẽ thấy cuộc trò chuyện thô giữa Claude Code cục bộ của bạn và mô hình ngôn ngữ Claude, từng tin nhắn một. Tin nhắn cuối cùng chứa phản hồi hoàn chỉnh của Claude.

Quyền và Tool

Theo mặc định, SDK chỉ có quyền chỉ đọc. Nó có thể đọc tệp, tìm kiếm thư mục và thực hiện các thao tác grep, nhưng nó không thể ghi, chỉnh sửa hoặc tạo tệp.

Để bật quyền ghi, bạn có thể thêm tùy chọn allowedTools vào truy vấn của mình:

for await (const message of query({
  prompt,
  options: {
    allowedTools: ["Edit"]
  }
})) {
  console.log(JSON.stringify(message, null, 2));
}

Hoặc, bạn có thể cấu hình quyền trong tệp cài đặt của mình trong thư mục .claude để được cấp quyền truy cập trên toàn dự án.

Ứng dụng thực tế

Claude Code SDK tỏa sáng khi được tích hợp vào các quy trình phát triển lớn hơn. Hãy cân nhắc sử dụng nó cho:

  • Git hooks tự động xem xét các thay đổi code
  • Build scripts phân tích và tối ưu hóa code
  • Các lệnh trợ giúp cho các tác vụ bảo trì code
  • Tạo tài liệu tự động
  • Kiểm tra chất lượng code trong các pipeline CI/CD

SDK về cơ bản cho phép bạn thêm khả năng thông minh dựa trên AI vào bất kỳ phần nào trong quy trình phát triển của bạn nơi quyền truy cập theo chương trình sẽ có giá trị.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?