Claude Entry Points: Cách bạn tương tác với Claude
Một entry point là lớp bọc (wrapper) quyết định ai có thể giao tiếp với Claude, Claude có quyền chạm vào những gì, và đối tác phải bỏ ra bao nhiêu công sức kỹ thuật (engineering effort) để triển khai. Hãy coi các entry points như cùng một trí tuệ nhân tạo nhưng được đóng gói cho các công việc khác nhau. Chọn sai entry point không làm hỏng hoàn toàn dự án, nhưng nó tạo ra lực cản và sự bất tiện mà đối tác sẽ phải chịu đựng mỗi ngày.
Ngoài Claude.ai và Claude Code, Anthropic còn cung cấp thêm các entry points chuyên biệt cho từng môi trường ứng dụng cụ thể:
Entry point cho người dùng cuối | Mô tả | Đối tượng & Mục đích sử dụng | Đánh đổi cốt lõi (Core Tradeoff) |
Claude.ai (Web, Mobile, Desktop apps) | Sản phẩm chat dành cho người dùng cuối. Đăng nhập để mở hội thoại, đính kèm file, dùng Projects để chia sẻ ngữ cảnh và kết nối các dịch vụ ngoài (Slack, Outlook, Google Drive) qua built-in connectors. Gồm các gói cá nhân (Free, Pro, Max) và Claude for Work (Team, Enterprise). Gói Team bổ sung quyền quản trị admin, SSO/SAML, domain capture, và cam kết hợp đồng không dùng dữ liệu khách hàng để huấn luyện. Gói Enterprise bổ sung SCIM provisioning, tùy chỉnh thời gian lưu trữ (retention), audit logs, Compliance API, và tùy chọn hỗ trợ HIPAA với thỏa thuận BAA đã ký. | Dành cho các knowledge workers dùng Claude như một đối tác tư duy để nghiên cứu, soạn thảo, phân tích và đánh giá. Không cần viết code. Web app, mobile app và Claude Desktop đều trỏ về cùng một sản phẩm Claude.ai. Dành cho người ứng dụng AI, không dành cho kỹ sư xây dựng hệ thống. | Không tốn chi phí build vs. Không thể tùy biến tích hợp: Bạn nhận được sản phẩm nguyên bản của Anthropic và không thể nhúng vào sản phẩm khác hay tùy biến những gì được phơi bày ra. Gói cá nhân cho công việc ít nhạy cảm; gói Claude for Work cho tổ chức cần quản trị, SSO và cam kết không train dữ liệu. |
Claude Code (Terminal, IDE plugin, Desktop, Web) | Công cụ lập trình dạng agentic có khả năng đọc file, sửa code, chạy lệnh terminal và thực thi các tác vụ kỹ thuật nhiều bước trong ranh giới phân quyền (permission boundaries) có thể cấu hình. | Dành cho các kỹ sư phát triển phần mềm: khám phá codebase, tái cấu trúc mã nguồn (refactoring), sửa lỗi (debugging), phát triển tính năng mới. Chạy trên terminal, IDE plugins (VS Code, JetBrains,...), desktop app và web (claude.ai/code). | Chuyên biệt hóa cho kỹ thuật: Lựa chọn xuất sắc cho việc viết code nhưng hoàn toàn sai hình thái nếu dùng làm sản phẩm chăm sóc khách hàng hoặc các luồng công việc phi kỹ thuật. |
Claude Cowork | Một desktop agent dành cho người dùng phi kỹ thuật, hoạt động trực tiếp với các tệp tin và ứng dụng cục bộ trên máy tính cá nhân để tự động hóa quản lý file và tác vụ dưới quyền hạn được cấu hình. | Dành cho nhân sự vận hành (operations), hành chính (admin) và các vai trò phi kỹ thuật cần Claude thay mặt thực hiện hành động trên máy thay vì chỉ sinh văn bản trong cửa sổ chat. Khả dụng trên tất cả các gói trả phí qua Claude Desktop app trên macOS và Windows (Linux đang thử nghiệm beta). | Hành động thực tế trên hệ thống vs. Chi phí giám sát: Mạnh mẽ cho tự động hóa file và tác vụ vì can thiệp trực tiếp vào máy tính của người dùng, đòi hỏi việc phân quyền và sự giám sát của con người chặt chẽ hơn nhiều so với một chatbot đơn thuần. |
Claude in Chrome | Một browsing agent hoạt động bên trong trình duyệt Google Chrome, điều hướng các trang web và thực hiện hành động thay mặt người dùng. | Dành cho các knowledge workers có quy trình làm việc gắn chặt với các ứng dụng nền web (web applications) thay vì file cục bộ hay codebase. | N/A |
Claude for Excel | Một spreadsheet agent hoạt động bên trong Microsoft Excel, thao tác trực tiếp với các ô tính, công thức và dữ liệu có cấu trúc. | Dành cho chuyên viên phân tích dữ liệu, đội ngũ tài chính và bất kỳ vai trò nào có công cụ làm việc chính là bảng tính. | N/A |
Build-time Interfaces: Cách bạn lập trình để tương tác với Claude
Khi đã chọn xong entry point, quyết định tiếp theo là mã nguồn của đối tác sẽ giao tiếp với tầng lập trình nào. 4 build-time interfaces dưới đây không hoàn toàn triệt tiêu lẫn nhau, mà chúng xếp lớp chồng lên nhau:
Build-time Interface | Định nghĩa | Đối tượng & Mục đích sử dụng | Đánh đổi cốt lõi (Tradeoff) |
Direct API | Giao diện HTTP trực tiếp tới Claude. Developer xác thực, gửi request kèm danh sách messages, tên model, các tham số và nhận về response. | Dành cho các đội ngũ tự xây dựng Claude trực tiếp vào sản phẩm riêng. Team sở hữu toàn bộ logic: cơ chế thử lại (retries), truyền dữ liệu dòng (streaming), gọi tool use, giám sát (observability) và giao diện người dùng (UI). Là tầng nền tảng nhất bên dưới mọi thành phần khác. | Kiểm soát tối đa vs. Trách nhiệm tối đa: Dùng khi SDK chưa kịp hỗ trợ tính năng mới nhất mà bạn cần, hoặc khi team có thói quen làm việc trực tiếp với HTTP thuần. |
SDKs (Python, TypeScript, Java, Go, Ruby, C#, PHP) | Đóng gói toàn bộ khả năng của Direct API vào các kiểu dữ liệu và tiện ích ngôn ngữ bản địa (language-native types), giúp giảm thiểu tối đa code thừa (boilerplate). Tự động xử lý xác thực, định dạng request, retries, streaming và kết nối tool use. | Dành cho các use cases tương tự Direct API nhưng team muốn có sự tiện lợi, an toàn về kiểu dữ liệu và cú pháp tối ưu của ngôn ngữ lập trình. Là lựa chọn mặc định khi nhúng Claude vào sản phẩm. | Sự tiện lợi vs. Mức độ kiểm soát: Các lớp trừu tượng của SDK phụ thuộc vào nhịp phát hành của Anthropic. Nếu bạn cần tính năng API mới nhất mà SDK chưa cập nhật, bạn vẫn phải gọi HTTP thô. |
MCP (Model Context Protocol) | Giao thức mở cho phép một máy chủ (server) phơi bày các công cụ (tools), prompts và tài nguyên để bất kỳ MCP client nào (Claude.ai, Claude Code, API, ứng dụng bên thứ ba) cũng có thể tự động khám phá và sử dụng. Lưu ý: Không phải quy ước gọi hàm nội bộ trong một sản phẩm, mà là quy ước chia sẻ công cụ xuyên suốt nhiều sản phẩm. | Dành cho các team cần cùng một tập hợp công cụ có thể truy cập được từ nhiều Claude clients khác nhau (ví dụ: Claude.ai, Claude Code, ứng dụng nội bộ). Dựng server một lần, kết nối ở mọi nơi. | Khả năng tái sử dụng liên client vs. Độ phức tạp kiến trúc gia tăng: Nếu chỉ có duy nhất một client sử dụng công cụ đó, MCP sẽ tạo thêm gánh nặng vận hành mà không mang lại nhiều giá trị. |
Agent SDK (@anthropic-ai/claude-agent-sdk) | Bộ công cụ chạy vòng lặp agent được quản lý sẵn (managed agent loop) — chính là vòng lặp vận hành Claude Code — trực tiếp từ mã nguồn ứng dụng của đối tác. Tự động xử lý việc lặp lượt, thực thi công cụ và điều kiện dừng. Hỗ trợ TypeScript (npm) và Python (PyPI). | Dành cho các team cần Claude hành động tự chủ qua nhiều lượt bên trong sản phẩm riêng của mình, trong khi ứng dụng vẫn kiểm soát luồng nghiệp vụ xung quanh, và giao diện dòng lệnh Claude Code CLI không phù hợp với ngữ cảnh sử dụng (ví dụ: agent nhúng trong web app nội bộ). | Vòng lặp tự động vs. Khả năng điều phối tùy biến: Agent SDK tự lo việc lặp và điều kiện dừng, nhưng đối tác sẽ mất đi quyền kiểm soát chi tiết ở mức vi mô bên trong từng vòng lặp. |
Phân biệt rõ các khái niệm dễ nhầm lẫn
API và SDK: Cùng một điểm đến, chỉ khác về trải nghiệm lập trình. Từ góc nhìn của Claude, API và SDK là một. SDK là lớp bọc bên ngoài API giúp mã nguồn chuẩn hóa theo từng ngôn ngữ và xử lý sẵn các tác vụ cơ bản. SDK là lựa chọn mặc định; bạn chỉ chuyển về HTTP thuần khi cần gọi gấp tính năng mới ra mắt mà SDK chưa kịp cập nhật.
MCP và API Tool Use: Nằm ở hai tầng khác nhau, không phải phương án thay thế đối đầu. MCP là giao thức chia sẻ công cụ giữa các entry points khác nhau; còn API Tool Use là cách Claude gọi một hàm cụ thể bên trong một request đơn lẻ. Về bản chất, một MCP server cung cấp danh sách công cụ để một client tương thích gọi thông qua API Tool Use. Nếu công cụ chỉ dùng nội bộ trong đúng 1 sản phẩm: dùng API Tool Use thuần. Nếu công cụ cần dùng chung cho cả Claude.ai, Claude Code và app nội bộ: dùng MCP.
Anthropic SDK vs. Agent SDK: Anthropic SDK chỉ là lớp bọc tiện ích cho API (gửi 1 request, nhận 1 response), không tự chạy vòng lặp agent. Agent SDK là một runtime engine đầy đủ: model tự chọn tool, chạy tool, đọc kết quả và tiếp tục lặp cho đến khi hoàn thành mục tiêu hoặc chạm điều kiện dừng.
Claude Code: Các tầng Tùy biến (Shaping) và Quản trị (Governing)
Khi chọn Claude Code, bạn phải quyết định cấu hình nào thuộc về tầng nào. Một tầng ở đây là một điểm cấu hình độc lập, kiểm soát một khía cạnh trong cách agent suy nghĩ hoặc hành động. Chúng được chia làm 2 nhóm rõ rệt:
Plaintext
+-----------------------------------------------------------------------------------+
| CLAUDE CODE ARCHITECTURE |
+-----------------------------------------------------------------------------------+
| SHAPING LAYERS (Định hình Tri thức & Hành vi) |
| • CLAUDE.md : Chỉ dẫn cố định, conventions, ngữ cảnh dự án khi khởi động. |
| • Skills : Quy trình đóng gói lặp lại (Git flow, schema migration,...). |
| • Subagents : Tác vụ độc lập, ngữ cảnh riêng, quyền hạn đọc hạn chế. |
| • MCP Servers : Kết nối công cụ & dữ liệu dùng chung xuyên suốt các clients. |
+-----------------------------------------------------------------------------------+
| GOVERNING LAYERS (Quản trị An toàn & Phân quyền) |
| • Hooks : Script code cứng chạy theo sự kiện, rào chắn không thể bỏ qua|
| • Permissions : 6 chế độ kiểm soát quyền thực thi (default, acceptEdits,...) |
| • Sandboxing : Cô lập môi trường chạy (filesystem, network egress, sandbox) |
+-----------------------------------------------------------------------------------+
1. Nhóm Định hình (Shaping): Agent biết gì và làm gì
CLAUDE.md: File Markdown nạp vào ngữ cảnh ngay khi mở phiên làm việc. Thiết lập các chỉ dẫn thường trực, tiêu chuẩn viết code của dự án, cấu trúc thư mục repo và quy ước chung của team.
Skills: Các quy trình định nghĩa bằng Markdown mà Claude Code chỉ tải vào khi cần dùng (on-demand), giúp giữ cho context window chính luôn gọn gàng. Phù hợp cho các quy trình lặp đi lặp lại như: commit-push-PR, tạo release-notes, chạy migration database.
Subagents: Khởi tạo agent con để xử lý các phần việc tách biệt hoặc các tác vụ bị giới hạn phạm vi (như review code, đọc hiểu codebase) nhằm tránh làm nhiễu thread chính. Rất hữu ích khi cần chạy với bộ công cụ chỉ đọc (read-only tools) hoặc system prompt riêng.
MCP servers: Kết nối công cụ bên ngoài và nguồn dữ liệu vào Claude Code qua chuẩn chung, đặc biệt khi cần chia sẻ cùng server đó với Claude.ai hoặc các ứng dụng khác.
2. Nhóm Quản trị (Governing): Agent được phép can thiệp vào những gì
Hooks: Các đoạn mã kịch bản (scripts) kích hoạt tự động theo các sự kiện vòng đời của Claude Code (trước/sau khi gọi tool, khi mở phiên, khi dừng lại). Đây là các cổng chặn định tính (deterministic gates) mà agent bắt buộc phải đi qua, không thể lách qua bằng câu lệnh prompt.
Permission boundaries & Approval flows: 6 chế độ phân quyền kiểm soát mức độ tự chủ của Claude Code:
default: Luôn hỏi ý kiến người dùng trước mỗi hành động.acceptEdits: Tự động phê duyệt thao tác sửa file và các lệnh file hệ thống thông dụng (mkdir,touch,rm,mv,cp,sed), nhưng các lệnh Bash khác vẫn phải xin phép.Plan mode: Khóa phiên làm việc ở chế độ chỉ đọc (read-only) cho đến khi người dùng phê duyệt một bản kế hoạch tổng thể.Auto mode: Sử dụng một bộ phân loại (classifier) để tự động duyệt các hành vi an toàn và chặn các hành vi rủi ro (bản thử nghiệm trên tất cả các gói trả phí).dontAsk: Tự động từ chối mọi thao tác cần xin phép và chỉ chạy những gì nằm trong danh sách trắng (allow rules) — chế độ chuẩn cho các CI pipelines khóa chặt.bypassPermissions: Bỏ qua toàn bộ kiểm tra bảo mật, chỉ được phép dùng bên trong các containers cô lập hoặc môi trường CI khép kín.
Sandboxing & Restricted execution: Thiết lập ranh giới cô lập không gian làm việc (giới hạn file hệ thống, chặn luồng mạng ra ngoài (network egress rules), khóa tập lệnh cho phép). Được áp dụng ở bất kỳ môi trường nào mà một hành động sai sót có thể dẫn tới hậu quả thật, nơi các thông báo xin phép đơn thuần không đủ tin cậy để làm chốt chặn cuối cùng.
CSP Delivery Routes: Nơi API Traffic kết thúc
Sau khi xác định xong entry point và build-time interface, quyết định ở tầng đáy cùng là: API traffic sẽ kết thúc trên hạ tầng của ai? Cùng một model Claude sẽ có 4 lộ trình truyền tải (delivery routes).
Sự khác biệt không nằm ở năng lực kỹ thuật (model hoạt động y hệt nhau trên mọi route), mà nằm ở: tài khoản đám mây nào chịu chi phí, hệ thống danh tính nào xác thực, dữ liệu lưu trú tại vùng địa lý (region) nào, và hợp đồng mua sắm (procurement contract) nào đối tác đã ký kết trước đó.
Delivery Route | Định nghĩa & Cách truy cập | Khi nào nên chọn |
Anthropic first-party | API trực tiếp tại | Đối tác không có ràng buộc đám mây nào, muốn dùng ngay tính năng mới nhất vào ngày ra mắt, hoặc muốn thanh toán chi phí AI trực tiếp với Anthropic. Là lựa chọn mặc định. |
AWS Bedrock | Model Claude được quản lý trên hạ tầng AWS. Gọi qua Messages API tại | Đối tác đã có hợp đồng doanh nghiệp lớn với AWS, toàn bộ hệ thống đang đặt trên AWS và muốn cấn trừ chi phí AI vào cam kết doanh số đám mây sẵn có. Kế thừa toàn bộ hệ thống IAM, mạng nội bộ và audit log của AWS. |
GCP Vertex AI | Model Claude nằm trong Google Cloud Vertex AI Model Garden. Gọi qua Anthropic Vertex client hoặc Google SDK, tính tiền vào GCP project, xác thực bằng Google Cloud credentials. | Toàn bộ hạ tầng và stack máy học (ML) của đối tác đặt trên Google Cloud, mong muốn gom toàn bộ việc thanh toán và audit các nền tảng foundation models về một nơi duy nhất. |
Microsoft Foundry (Azure) | Model Claude trên catalog của Microsoft Foundry trên Azure. Tính tiền vào Azure subscription, xác thực bằng Entra ID, triển khai trong Azure region của đối tác. Lưu ý: Foundry cung cấp 2 hình thức: Hosted on Azure (inference chạy hoàn toàn trong môi trường Azure của đối tác) và Hosted on Anthropic infrastructure (traffic định tuyến sang hạ tầng của Anthropic). Đối tác có yêu cầu khắt khe về lưu trú dữ liệu hoặc GDPR cần kiểm tra kỹ hình thức lưu trữ này trước khi chốt phương án. | Đối tác đã ký thỏa thuận doanh nghiệp với Microsoft, dùng Entra ID để quản lý định danh và toàn bộ hạ tầng đã nằm trên Azure, muốn gom mua sắm AI về cùng một đầu mối hợp đồng. |
Quy tắc bất biến giữa các Routes: Bản thân model Claude là như nhau trên mọi route. Cách prompt, chiến lược đánh giá (evals), gọi tool use và hành vi context window đều chuyển giao tương thích 100%. Thứ thay đổi là: chuỗi định danh phiên bản model (model identifiers), tính khả dụng theo khu vực địa lý, và độ trễ ra mắt tính năng (các nền tảng CSP thường cập nhật tính năng mới sau API trực tiếp của Anthropic vài tuần).
Skills như một Cơ chế Tích hợp (Integration Mechanism)
Skills không chỉ là một cách đóng gói prompt, mà còn là một cơ chế tích hợp hệ thống. Một Skill có thể được gắn kèm vào một request thông qua tham số container.skills, được phát hành và quản lý phiên bản qua endpoint /v1/skills, và đặt dưới hệ thống quản lý mã nguồn (Git) như mọi tài sản phần mềm khác.
Skills đòi hỏi Code Execution Tool để hoạt động, nghĩa là mô hình này phụ thuộc vào một môi trường thực thi hộp cát (sandboxed execution environment). Khi xem xét cách đưa một quy trình tái sử dụng đến Claude xuyên suốt các entry points, một versioned Skill là một giải pháp ngang hàng cần cân nhắc bên cạnh MCP và direct tool use.
Chi phí · Độ phức tạp · Rủi ro
Chi phí (Cost): Mỗi entry point đều đi kèm chi phí tích hợp kỹ thuật đáng kể. Đừng chọn nhiều hơn một entry point trừ khi use case thực tế của đối tác thực sự trải dài trên nhiều đối tượng người dùng khác nhau.
Độ phức tạp (Complexity): Hai sai lầm thường gặp nhất là: cố đưa Claude Code vào các tác vụ phi kỹ thuật, và mặc định dùng MCP ở khắp mọi nơi dù không có nhu cầu chia sẻ công cụ giữa nhiều clients. Entry point phải phục vụ bài toán, không được đi trước bài toán.
Rủi ro (Risk): Khi hệ thống phát triển vượt ngưỡng đáp ứng của một entry point bị chọn sai, chi phí khắc phục rất lớn — không chỉ ở việc viết lại code, mà còn phải thay đổi toàn bộ thói quen và quy trình của người dùng. Bắt đầu đúng entry point ngay từ đầu luôn là con đường ít tốn kém nhất.
Rào cản An toàn, Quản trị và Tuân thủ Pháp lý (Regulated-Industry Constraints)
Một số quyết định về entry point không phụ thuộc vào sở thích của bạn. Khi đối tác chịu sự chi phối của các quy định pháp lý, những rào cản này sẽ loại bỏ thẳng tay các lựa chọn không đáp ứng trước khi bạn kịp cân nhắc đến chi phí, trải nghiệm lập trình hay công sức triển khai:
Rào cản Tuân thủ | Những gì thường bị LOẠI BỎ | Những gì THƯỜNG ĐƯỢC CHẤP THUẬN |
Đặc quyền Luật sư - Thân chủ (Attorney-client privilege) | Các gói Claude.ai cá nhân cho việc đọc tài liệu mật, và bất kỳ giao diện nào xử lý thông tin đặc quyền mà công ty luật không thể kiểm toán (audit) từ đầu đến cuối. | API hoặc SDK đặt sau ứng dụng riêng của công ty, xác thực qua SSO nội bộ, đi qua một LLM gateway được công ty phê duyệt để ghi vết 100% requests nhằm sở hữu toàn vẹn chuỗi audit trail. |
HIPAA (Dữ liệu y tế PHI) | Bất kỳ entry point nào chưa có thỏa thuận bảo mật BAA (Business Associate Agreement) riêng cho đúng cấu hình đang chạy. BAA ở cấu hình này không tự động bảo vệ cho cấu hình khác. | API hoặc SDK chạy trên cấu hình đã ký BAA thông qua delivery route đối tác đang sử dụng. Lưu ý: Các tính năng Beta thường bị loại trừ khỏi phạm vi BAA trừ khi được xác nhận cụ thể. |
GDPR & Lưu trú dữ liệu (Data residency) | Các delivery routes không thể cố định vùng địa lý thực thi model (unpinned region), và các tuyến đường mà dữ liệu bị trung chuyển ra khỏi biên giới được phê duyệt ở bất kỳ bước nào. | Delivery route qua CSP (Bedrock hoặc Vertex) với vùng xử lý được ghim cố định (region pinned) trong phạm vi lãnh thổ tài phán và kế thừa các điều khoản DPA từ hợp đồng đám mây hiện hữu. |
FedRAMP / Chính phủ | Bất kỳ tuyến đường nào không nằm trên môi trường đám mây được cấp thẩm quyền ở cấp độ tương ứng. | Claude for Government (C4G) cho FedRAMP High dân sự. Bedrock GovCloud cho FedRAMP High và Bộ Quốc phòng Mỹ (DoD IL4/5). Vertex Assured Workloads cho FedRAMP High và IL2. (Lưu ý: Các môi trường chính phủ thường cập nhật model mới chậm hơn bản thương mại). |
Chính sách lưu trú dữ liệu nội bộ | Bất kỳ nhà cung cấp nào nằm ngoài danh sách đối tác đám mây đã được duyệt của doanh nghiệp, bất kể năng lực kỹ thuật tốt đến đâu. | Delivery route nằm trên CSP đã được phê duyệt sẵn. Đây là bài toán mua sắm và chính sách, việc cần làm là chọn tuyến đường mà Giám đốc CNTT (CIO) của họ đã cấp phép. |
Nguyên tắc tư duy: Hãy nêu đích danh rào cản pháp lý khi bạn đề xuất một entry point, và để chính rào cản đó loại bỏ các phương án không khả thi trước khi các yếu tố về sở thích cá nhân tham gia vào cuộc thảo luận.
Nội dung bài viết thuộc lộ trình chuẩn bị chứng chỉ Claude Certified Architect, được tổng hợp và biên dịch từ tài liệu đào tạo chính thức của Anthropic PBC. Bản quyền nội dung gốc thuộc về Anthropic PBC. Bản dịch tiếng Việt và chú giải thực hành bởi HungPH Blog.
Thành viên gia nhập từ 19/09/2026