Blog

Hướng Dẫn Toàn Diện về Claude Code SDK

Emmanuel Mumba

Emmanuel Mumba

13 tháng 6 2025

Hướng Dẫn Toàn Diện về Claude Code SDK

Thế giới phát triển phần mềm đang trải qua một sự chuyển đổi mạnh mẽ, được thúc đẩy bởi sức mạnh của trí tuệ nhân tạo. Các công cụ hỗ trợ bởi AI không còn là một khái niệm viễn tưởng mà là một thực tế hiện tại, tăng cường khả năng của các nhà phát triển và tinh giản quy trình làm việc. Đi đầu trong cuộc cách mạng này là Claude Code của Anthropic, một mô hình AI mạnh mẽ được thiết kế đặc biệt cho các tác vụ lập trình. Để giúp các nhà phát triển tích hợp liền mạch công nghệ tiên tiến này vào các ứng dụng và quy trình làm việc của riêng họ, Anthropic đã phát hành Claude Code SDK. Hướng dẫn toàn diện này sẽ đi sâu vào Claude Code SDK, khám phá các tính năng, chức năng của nó và cung cấp hướng dẫn từng bước về cách sử dụng nó trong các môi trường lập trình khác nhau.

💡
Bạn muốn kiểm thử API AI chỉ trong vài giây?Apidog cho phép bạn thiết kế, mô phỏng và kiểm thử Claude, GPT hoặc bất kỳ điểm cuối AI nào trong một giao diện người dùng sạch sẽ—không cần Postman hay code. Xây dựng toàn bộ ngăn xếp AI của bạn từ prompt đến sản xuất, một cách dễ dàng.
button

Claude Code và Claude Code SDK là gì?

Trước khi đi sâu vào chi tiết của SDK, điều cần thiết là phải hiểu công nghệ cốt lõi cung cấp sức mạnh cho nó. Claude Code là một mô hình ngôn ngữ lớn (LLM) từ Anthropic, được đào tạo tỉ mỉ trên một tập dữ liệu code khổng lồ. Việc đào tạo chuyên biệt này cho phép nó hiểu, tạo và suy luận về code với mức độ thành thạo cao trên nhiều ngôn ngữ lập trình. Từ việc tạo code boilerplate và viết các thuật toán phức tạp đến gỡ lỗi và giải thích các đoạn code, Claude Code là một công cụ đa năng cho bất kỳ nhà phát triển nào.

Claude Code SDK (Bộ công cụ phát triển phần mềm) đóng vai trò là cầu nối, cho phép các nhà phát triển tương tác theo chương trình với mô hình Claude Code. Thay vì bị giới hạn trong giao diện web, các nhà phát triển có thể tận dụng SDK để xây dựng các ứng dụng, script và tích hợp tùy chỉnh khai thác toàn bộ tiềm năng của Claude Code. Cho dù bạn muốn tạo một trợ lý lập trình được cá nhân hóa, tự động hóa việc xem xét code trong quy trình CI/CD của mình hay xây dựng một công cụ có thể dịch code từ ngôn ngữ này sang ngôn ngữ khác, Claude Code SDK cung cấp các công cụ và giao diện cần thiết để biến ý tưởng của bạn thành hiện thực.

Lợi ích chính của việc sử dụng SDK là khả năng vượt ra ngoài các truy vấn tương tác, một lần và bước vào thế giới kiểm soát tự động, theo chương trình. Điều này mở ra một không gian rộng lớn các khả năng để tích hợp AI vào chính cấu trúc của vòng đời phát triển phần mềm.

Bắt đầu: Những bước đầu tiên của bạn với Claude Code SDK

Bắt đầu hành trình của bạn với Claude Code SDK là một quy trình đơn giản. Đây là những gì bạn cần để bắt đầu:

Điều kiện tiên quyết

Trước khi bạn có thể bắt đầu thực hiện các lệnh gọi đến Claude Code API, bạn sẽ cần một khóa API. Khóa này xác thực các yêu cầu của bạn và liên kết chúng với tài khoản Anthropic của bạn. Bạn có thể tạo một khóa API chuyên dụng trong Anthropic Console. Rất khuyến khích tạo một khóa mới dành riêng cho việc sử dụng SDK của bạn để đảm bảo bảo mật và quản lý tốt hơn.

Sau khi có khóa API, bạn cần làm cho nó có thể truy cập được trong môi trường phát triển của mình. Cách tiếp cận được khuyến nghị là đặt nó làm biến môi trường có tên ANTHROPIC_API_KEY. Đây là một phương pháp bảo mật hơn so với việc mã hóa cứng khóa trực tiếp vào mã nguồn của bạn.

Cài đặt: Chọn phiên bản của bạn

Claude Code SDK được thiết kế linh hoạt và dễ tiếp cận với các nhà phát triển làm việc trong các môi trường khác nhau. Nó có sẵn cho dòng lệnh, TypeScript và Python.

Quy trình cài đặt cho mỗi phiên bản này sẽ được trình bày trong các phần tương ứng dưới đây.

Đi sâu vào Claude Code SDK: Từ dòng lệnh đến các ứng dụng tùy chỉnh

Bây giờ, hãy khám phá các khía cạnh thực tế của việc sử dụng Claude Code SDK trong các môi trường khác nhau.

Giao diện dòng lệnh (CLI): Cổng vào Claude Code của bạn

CLI cung cấp một cách mạnh mẽ và linh hoạt để tương tác với Claude Code trực tiếp từ terminal của bạn.

Cách sử dụng cơ bản:

Một prompt duy nhất: Cách sử dụng cơ bản nhất liên quan đến việc chạy một prompt duy nhất và để Claude Code tạo phản hồi.Bash

claude-code "write a python function to calculate the factorial of a number"

Đẩy stdin: Bạn có thể đẩy đầu ra của các lệnh khác hoặc nội dung của một tệp vào Claude Code làm đầu vào.Bash

cat my_script.py | claude-code "add type hints to this python code"

Đầu ra JSON: Để sử dụng theo chương trình, bạn có thể nhận đầu ra ở định dạng JSON có cấu trúc.Bash

claude-code --json "explain this javascript code" < my_script.js

Streaming JSON: Đối với các yêu cầu chạy dài, bạn có thể truyền đầu ra JSON khi nó có sẵn.Bash

claude-code --stream-json "write a comprehensive unit test for this function" < my_function.go

Các tùy chọn CLI chính:

CLI đi kèm với một bộ tùy chọn phong phú cho phép bạn tinh chỉnh hành vi của nó:

TypeScript SDK: Xây dựng các ứng dụng hiện đại hỗ trợ AI

TypeScript SDK hoàn hảo để tích hợp Claude Code vào các ứng dụng web, dịch vụ backend hoặc bất kỳ dự án dựa trên Node.js nào của bạn.

Cài đặt:

Bash

npm install @anthropic-ai/claude-code

Cách sử dụng cơ bản:

`import { claudeCode } from '@anthropic-ai/claude-code';
async function main() { const result = await claudeCode({ prompt: 'Write a TypeScript interface for a User', }); console.log(result.stdout); }
main();`

Các đối số bổ sung:

TypeScript SDK chấp nhận tất cả các đối số được hỗ trợ bởi CLI, cùng với một số đối số bổ sung:

Python SDK: Giải phóng AI trong hệ sinh thái Python

Các nhà phát triển Python có thể tận dụng claude-code-sdk để tích hợp khả năng của Claude Code vào các script và ứng dụng của họ.

Cài đặt:

Bash

pip install claude-code-sdk

Điều kiện tiên quyết:

Python SDK yêu cầu Python 3.10 trở lên, Node.js và Claude Code CLI phải được cài đặt.

Cách sử dụng cơ bản:

import anyio
from claude_code_sdk import query, ClaudeCodeOptions, Message

async def main():
    messages: list[Message] = []
    
    async for message in query(
        prompt="Write a haiku about foo.py",
        options=ClaudeCodeOptions(max_turns=3)
    ):
        messages.append(message)
    
    print(messages)

anyio.run(main)

Lớp ClaudeCodeOptions cho phép bạn chỉ định tất cả các đối số dòng lệnh được hỗ trợ một cách có cấu trúc.

Các tính năng nâng cao: Đẩy lùi ranh giới của phát triển hỗ trợ AI

Ngoài những điều cơ bản, Claude Code SDK cung cấp một loạt các tính năng nâng cao mở khóa những khả năng mạnh mẽ hơn nữa.

Cuộc hội thoại đa lượt: Duy trì ngữ cảnh

Nhiều tác vụ phát triển yêu cầu đối thoại qua lại. Hỗ trợ của SDK cho các cuộc hội thoại đa lượt cho phép bạn xây dựng các ứng dụng có thể duy trì ngữ cảnh và có cảm giác tự nhiên, tương tác hơn. Bạn có thể tiếp tục một cuộc hội thoại bằng cách cung cấp lịch sử cuộc hội thoại, cho phép Claude Code ghi nhớ các tương tác trước đó và cung cấp phản hồi phù hợp hơn.

Prompt hệ thống tùy chỉnh: Hướng dẫn hành vi của Claude

Prompt hệ thống là một tập hợp các hướng dẫn được đưa ra cho mô hình AI để hướng dẫn hành vi của nó. Claude Code SDK cho phép bạn cung cấp các prompt hệ thống tùy chỉnh, giúp bạn điều chỉnh phản hồi của Claude Code theo nhu cầu cụ thể của mình. Ví dụ, bạn có thể cung cấp một prompt hệ thống hướng dẫn Claude Code luôn tạo code theo một phong cách cụ thể, đóng vai trò là một nhà phát triển cấp cao đưa ra đánh giá code, hoặc giải thích các khái niệm theo cách dễ hiểu cho người mới bắt đầu.

Giao thức ngữ cảnh mô hình (MCP): Mở rộng khả năng của Claude

Giao thức ngữ cảnh mô hình (MCP) là một tính năng mạnh mẽ cho phép bạn mở rộng khả năng của Claude Code bằng cách kết nối nó với các công cụ và tài nguyên bên ngoài. Điều này đạt được bằng cách chạy một máy chủ MCP có thể cung cấp ngữ cảnh bổ sung cho mô hình. Vì lý do bảo mật, bạn phải cho phép rõ ràng việc sử dụng các công cụ MCP bằng cách sử dụng cờ --allowedTools. Điều này mở ra những khả năng thú vị để tạo ra các công cụ phát triển hỗ trợ AI chuyên biệt và mạnh mẽ.

Các ứng dụng thực tế và các phương pháp hay nhất: Từ lý thuyết đến thực tế

Sức mạnh thực sự của Claude Code SDK được hiện thực hóa khi bạn bắt đầu áp dụng nó vào các thách thức phát triển trong thế giới thực.

Các trường hợp sử dụng trong thế giới thực:

Các phương pháp hay nhất:

Claude Code GitHub Actions: Minh chứng cho tiềm năng của SDK

Một ví dụ điển hình về Claude Code SDK đang hoạt động là Claude Code GitHub Actions. Bộ actions này cho phép bạn tự động hóa các tác vụ phát triển khác nhau trực tiếp trong quy trình làm việc GitHub của bạn. Bạn có thể sử dụng nó để tự động hóa việc xem xét code, tạo pull request và phân loại issue, tất cả đều được hỗ trợ bởi Claude Code. Đây là một minh chứng mạnh mẽ về cách SDK có thể được sử dụng để tạo ra các công cụ thực tế và có giá trị có thể cải thiện đáng kể năng suất của nhóm phát triển.

💡
Tìm kiếm sức mạnh tương tự trên backend API của bạn?Apidog cho phép bạn mô phỏng các lệnh gọi Claude, mô phỏng các trường hợp biên và tạo tài liệu Swagger trực tiếp—hoàn hảo để xây dựng các điểm cuối AI sẽ không bị lỗi trong môi trường production.

Kết luận

Claude Code SDK không chỉ là một công cụ; nó là cánh cổng dẫn đến một kỷ nguyên mới của phát triển phần mềm. Bằng cách cung cấp quyền truy cập theo chương trình vào sức mạnh của Claude Code, Anthropic đã trao quyền cho các nhà phát triển để xây dựng thế hệ công cụ phát triển hỗ trợ AI tiếp theo. Từ một tiện ích dòng lệnh đơn giản đến một trợ lý AI phức tạp, tích hợp, khả năng chỉ bị giới hạn bởi trí tưởng tượng của bạn. Khi các mô hình AI tiếp tục phát triển và cải thiện, vai trò của các công cụ như Claude Code SDK sẽ ngày càng trở nên quan trọng hơn, định hình tương lai của cách chúng ta viết, xem xét và bảo trì phần mềm. Hành trình chỉ mới bắt đầu, và Claude Code SDK là tấm vé của bạn để trở thành một phần của cuộc cách mạng thú vị này.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống