anthropics/claude-quickstarts: xây ứng dụng Claude — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
anthropics/claude-quickstarts là tập hợp các dự án mẫu giúp bạn bắt đầu nhanh với Claude API, từ chatbot hỗ trợ khách hàng đến phân tích dữ liệu, tự động hóa trình duyệt và coding agent. Repo có hướng dẫn chung nhưng mỗi quickstart có README riêng, nên độ khó cài đặt phụ thuộc dự án bạn chọn.
anthropics/claude-quickstarts là tập hợp các dự án mẫu giúp bạn nhanh chóng xây ứng dụng có thể triển khai với Claude API. Thay vì bắt đầu từ một file gọi API đơn giản, bạn có thể chọn sẵn một hướng như chatbot chăm sóc khách hàng, phân tích dữ liệu tài chính, điều khiển máy tính, tự động hóa trình duyệt hoặc coding agent.
Repo phù hợp nhất với lập trình viên Python, người đang học cách tích hợp Claude vào sản phẩm và đội ngũ muốn có một nền tảng tham khảo để phát triển tiếp. Điểm đáng giá là mỗi quickstart tập trung vào một bài toán tương đối hoàn chỉnh. Bạn có thể đọc cấu trúc, chạy thử, rồi thay dữ liệu, giao diện hoặc công cụ theo nhu cầu riêng.
Repo hiện có khoảng 20.823 sao và 3.492 fork. Mã nguồn dùng giấy phép MIT. Tuy vậy, đây không phải một ứng dụng duy nhất có một lệnh cài đặt chung. Bạn cần chọn đúng thư mục quickstart, sau đó đọc README riêng của thư mục đó.
anthropics/claude-quickstarts
Tập hợp quickstart giúp lập trình viên xây ứng dụng triển khai được với Claude API.
I.Claude Quickstarts làm được gì
A.Có nhiều mẫu ứng dụng Claude để chọn
Repo gom nhiều hướng triển khai trong cùng một nơi. Bạn có thể bắt đầu với Customer Support Agent nếu muốn làm trợ lý trả lời khách hàng, hoặc Financial Data Analyst nếu cần trò chuyện với dữ liệu và tạo biểu đồ tương tác.
Các mẫu này giúp bạn nhìn thấy cách Claude được đặt vào một luồng nghiệp vụ thực tế, thay vì chỉ gửi một câu hỏi rồi in câu trả lời ra màn hình.
B.Xây trợ lý hỗ trợ khách hàng có dữ liệu riêng
Customer Support Agent là một trợ lý hỗ trợ khách hàng có quyền truy cập vào knowledge base. Mẫu này phù hợp để nghiên cứu cách kết hợp khả năng hiểu và tạo ngôn ngữ của Claude với kho thông tin doanh nghiệp.
Với chủ shop hoặc đội chăm sóc khách hàng, đây là điểm bắt đầu để thử một trợ lý trả lời câu hỏi thường gặp, hướng dẫn sản phẩm hoặc tra cứu chính sách. README được cung cấp không mô tả chi tiết định dạng knowledge base hay giao diện, nên bạn cần xem README trong thư mục tương ứng trước khi triển khai.
C.Phân tích dữ liệu tài chính qua hội thoại
Financial Data Analyst cho phép phân tích dữ liệu tài chính bằng chat và có trực quan hóa dữ liệu tương tác. Lợi ích thực tế là người dùng có thể đặt câu hỏi theo ngôn ngữ tự nhiên thay vì tự viết mọi truy vấn hoặc tự dựng từng biểu đồ.
Mẫu này có thể giúp đội kinh doanh khám phá cách biến dữ liệu thành một trải nghiệm hỏi đáp. Tuy nhiên, tư liệu hiện có không nói rõ nguồn dữ liệu, định dạng tệp hay các loại biểu đồ cụ thể được hỗ trợ.
D.Cho Claude điều khiển máy tính
Computer Use Demo minh họa một môi trường và bộ công cụ để Claude điều khiển máy tính. Mẫu này dùng hình dạng toolset computer_toolset_20260801, trong đó mỗi thao tác máy tính là một member tool do model gọi theo tên.
Đây là hướng phù hợp khi bạn muốn nghiên cứu agent có thể quan sát và thao tác trên desktop. Vì công cụ có thể tác động đến máy tính, bạn nên thử trong môi trường kiểm soát và đọc kỹ hướng dẫn riêng trước khi cho phép thao tác trên dữ liệu thật.
E.Học cách xây computer-use agent đáng tin cậy hơn
Computer Use Best Practices là một bản triển khai tham khảo native macOS cho computer-use agent. Dự án minh họa các mẫu như định nghĩa tool rõ ràng, điều chỉnh và cắt bớt ảnh, prompt caching, server-side compaction, gọi nhiều tool theo lô, shell sandbox và ghi lại trajectory.
Điểm khác với Computer Use Demo là dự án này chạy trực tiếp trên desktop macOS, còn Computer Use Demo là môi trường container hóa. README khuyến nghị chạy bản native macOS trong máy ảo. Đây là quickstart thiên về học kiến trúc và độ tin cậy, không phải lựa chọn cài nhanh trên mọi hệ điều hành.
F.Tự động hóa trình duyệt bằng Playwright
Browser Use Demo là một triển khai tham khảo hoàn chỉnh cho browser automation với Claude. Claude được cấp khả năng điều hướng website, kiểm tra và tương tác với DOM, trích xuất nội dung và điền biểu mẫu thông qua browser tool tùy chỉnh dựa trên Playwright.
Mẫu này gần với các bài toán như thu thập thông tin trên website, điền biểu mẫu theo quy trình hoặc xây trợ lý thao tác trên trình duyệt. Khi áp dụng thật, bạn vẫn cần kiểm soát website đích, quyền truy cập và dữ liệu mà agent được phép gửi đi.
G.Xem ví dụ tối giản của browser toolset
Browser Toolset Quickstart là ví dụ CDP tối giản bằng Python và TypeScript. Nó có driver nhỏ cho một tab Chromium qua Chrome DevTools Protocol, một script chạy driver với tool runner và một script chạy thử driver mà không cần model.
Tài liệu nói rõ đây là ví dụ để minh họa giao diện, không phải mã nguồn production. Vì vậy, nó phù hợp để học cách các thành phần kết nối với nhau trước khi bạn xây một hệ thống trình duyệt lớn hơn.
H.Xem ví dụ tối giản của computer toolset
Computer Toolset Quickstart là ví dụ VNC tối giản bằng Python và TypeScript. Nó có driver nhỏ cho một desktop qua giao thức RFB, không dùng thư viện VNC, cùng các script chạy tool runner và kiểm thử mà không cần model.
Nếu bạn đang tìm hiểu cách một desktop tool được mô tả và gọi ra sao, đây là nơi nên đọc. Nhưng không nên xem nó như một gói hoàn thiện để đưa thẳng vào môi trường vận hành.
I.Xây autonomous coding agent
Autonomous Coding Agent dùng Claude Agent SDK và minh họa mô hình hai agent: initializer và coding agent. Hệ thống có thể xây ứng dụng hoàn chỉnh qua nhiều phiên, lưu tiến độ bằng git và làm lần lượt theo feature list.
Điểm hữu ích là mẫu này cho thấy cách chia một công việc coding dài thành các phiên có trạng thái, thay vì yêu cầu agent làm tất cả trong một lần. Người mới nên đọc kỹ cách dự án lưu tiến độ và cách agent làm việc với repository trước khi thử trên mã nguồn quan trọng.
J.Kết nối Managed Agents với các kênh và giao diện khác nhau
Nhóm Managed Agents có nhiều quickstart cho các nhu cầu khác nhau: chat trên trình duyệt với Vercel Chat SDK, giao diện CopilotKit và AG-UI, bản tin hằng ngày, knowledge wiki, Linear, Slack, Sentry, MCP server và road trip planner.
Một số mẫu minh họa session bền vững, streaming token theo token, memory store, vault, cron deployment, webhook bridge, OAuth hoặc multiagent coordinator. Đây là phần có nhiều tính năng nhất trong repo, nhưng cũng có khả năng yêu cầu nhiều dịch vụ và cấu hình riêng hơn các quickstart cơ bản.
II.Cần chuẩn bị gì
Bạn cần một Claude API key để sử dụng các quickstart. README cho biết bạn có thể đăng ký miễn phí tại console.anthropic.com. README chung không nêu tên biến môi trường cụ thể, nên không nên tự đoán tên biến. Hãy mở README của quickstart bạn chọn để biết key phải đặt ở đâu.
Bạn cần môi trường phát triển có thể clone repository và chạy các dự án theo hướng dẫn riêng. Repo có ngôn ngữ chính là Python và có file pyproject.toml ở thư mục gốc, nhưng README được cung cấp không nêu phiên bản Python bắt buộc, cũng không nêu hệ điều hành chung cho toàn bộ repo.
Một số quickstart có yêu cầu riêng. Computer Use Best Practices là bản native macOS và README khuyến nghị chạy trong máy ảo. Browser Toolset dùng một tab Chromium qua Chrome DevTools Protocol. Computer Toolset dùng desktop qua VNC. Các mẫu Managed Agents có thể liên quan đến Slack, GitHub, Linear, Sentry, Discord, Telegram, WhatsApp, CopilotKit hoặc Vercel Chat SDK tùy dự án.
Tư liệu hiện có không nêu chi tiết tài khoản dịch vụ, phiên bản Node, phiên bản Python, cấu hình Chromium, thông số máy ảo hay yêu cầu GPU cho từng thư mục. Bạn chỉ nên cài thêm những gì README riêng của quickstart yêu cầu.
III.Cài đặt từng bước
- Chọn quickstartXác định thư mục phù hợp với bài toán
- Lấy mã nguồnClone repository về máy
- Mở thư mục dự ánĐi vào thư mục quickstart đã chọn
- Đọc README riêngLàm theo dependency và cấu hình của dự án
- Cấu hình API keyĐặt Claude API key theo hướng dẫn riêng
- Chạy ứng dụngDùng lệnh chạy được ghi trong README của quickstart
A.Chọn đúng quickstart
Trước tiên, hãy xác định bạn muốn học hoặc xây loại ứng dụng nào. Nếu chỉ muốn khảo sát khả năng của Claude trong một bài toán kinh doanh, Customer Support Agent hoặc Financial Data Analyst là hai điểm bắt đầu dễ hiểu.
Nếu muốn nghiên cứu agent thao tác máy tính hoặc trình duyệt, hãy chọn Computer Use Demo, Browser Use Demo, Browser Toolset Quickstart hoặc Computer Toolset Quickstart. Nếu muốn nghiên cứu coding agent, hãy mở Autonomous Coding Agent. Với các hệ thống có Slack, GitHub, Sentry, Linear hoặc giao diện chat, hãy chọn quickstart Managed Agents tương ứng.
Đừng bắt đầu bằng cách chạy cả repository cùng lúc. Mỗi thư mục là một dự án có mục đích và cách chuẩn bị riêng.
B.Clone repository
README chung yêu cầu clone repository, nhưng không đưa sẵn khối lệnh. Bạn có thể dùng lệnh Git phổ thông sau:
git clone https://github.com/anthropics/claude-quickstarts.gitLệnh này tải mã nguồn về thư mục claude-quickstarts. Bạn cần mở terminal tại nơi muốn lưu dự án. Nếu máy báo chưa nhận diện git, hãy cài Git rồi mở lại terminal.
C.Đi vào thư mục quickstart
Sau khi clone xong, chuyển vào thư mục repository:
cd claude-quickstartsTiếp theo, bạn cần chọn một thư mục con như customer-support-agent, financial-data-analyst, browser-use-demo hoặc autonomous-coding. README chung chỉ nói rằng cần navigate đến thư mục quickstart cụ thể, chưa ghi lệnh cd cho từng dự án.
Ví dụ, việc đi vào thư mục chỉ có thể thực hiện sau khi bạn đã xác định đúng tên thư mục trong danh sách cấu trúc repo. Không nên tự đổi tên thư mục hoặc đoán rằng mọi quickstart dùng cùng một lệnh chạy.
D.Đọc README và cài dependency của dự án
README chung yêu cầu cài dependency cần thiết nhưng không ghi lệnh cài đặt cụ thể. File pyproject.toml có trong repo, tuy nhiên tư liệu được cung cấp không cho biết phải dùng công cụ nào, cần cài package nào hay cần chọn extra nào.
Vì vậy, hãy mở README bên trong thư mục quickstart đã chọn và làm đúng phần setup ở đó. Nếu README riêng không ghi cách cài, hãy xem các file cấu hình và mã nguồn trong chính thư mục đó. Không nên tự thêm tên package hoặc cờ lệnh khi chưa có tư liệu xác nhận.
E.Cấu hình Claude API key
Bạn cần tạo Claude API key trước khi chạy ứng dụng. README chung nói rằng key được đặt dưới dạng biến môi trường, nhưng không ghi tên biến cụ thể.
Hãy tìm hướng dẫn cấu hình trong README của quickstart. Điền key vào đúng vị trí được yêu cầu và tránh đưa key vào mã nguồn, commit git hoặc ảnh chụp màn hình. Nếu quickstart dùng thêm dịch vụ như Slack, GitHub, Linear hoặc Sentry, hãy kiểm tra xem README riêng có yêu cầu credential bổ sung hay không.
API key và credential của dịch vụ ngoài cần được giữ kín. Các quickstart có thể gọi API thật hoặc tác động đến trình duyệt, máy tính, repository và hệ thống bên ngoài. Chỉ cấp quyền tối thiểu, thử trong môi trường an toàn và kiểm tra chi phí trước khi chạy lâu.
F.Chạy quickstart
README chung chỉ mô tả bước cuối là chạy ứng dụng. Nó không cung cấp lệnh chạy chung cho toàn bộ repo. Lệnh đúng phải lấy từ README riêng của dự án bạn chọn.
Điều này đặc biệt quan trọng với các mẫu computer use, browser use và Managed Agents. Chúng có thể cần môi trường, credential, session hoặc dịch vụ ngoài khác nhau. Nếu bạn chạy một lệnh của dự án này trong thư mục dự án khác, lỗi có thể xuất hiện dù mã nguồn vẫn được clone đầy đủ.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra phụ thuộc quickstart. Theo quy trình chung trong README, một lần chạy thành công nghĩa là bạn đã clone repository, đi vào đúng thư mục, cài dependency, cấu hình Claude API key và chạy được ứng dụng.
Với Customer Support Agent, dấu hiệu cần tìm là giao diện hoặc luồng cho phép trợ lý Claude trả lời dựa trên knowledge base. Với Financial Data Analyst, bạn cần thấy trải nghiệm chat phân tích dữ liệu và trực quan hóa tương tác.
Với Browser Use Demo, hãy kiểm tra agent có thể điều hướng website, xem DOM, tương tác, trích xuất nội dung hoặc điền biểu mẫu theo phạm vi mà README riêng mô tả. Với các toolset tối giản, hãy chạy script kiểm thử được cung cấp và xem driver có thực hiện thao tác mà không cần model hay không.
Với Autonomous Coding Agent, hãy kiểm tra tiến độ có được lưu qua git và agent có làm việc theo feature list. Với Managed Agents, dấu hiệu thành công có thể là session tạo được, phản hồi được stream, webhook nhận được sự kiện hoặc bản tin được gửi đến kênh đã cấu hình.
Tư liệu hiện có không cung cấp màn hình mẫu, lệnh chạy cụ thể hay thông báo thành công cố định. Vì vậy, hãy coi README riêng của từng thư mục là tiêu chuẩn kiểm tra chính.
V.Dùng vào việc thật
A.Chủ shop muốn giảm câu hỏi lặp lại
Một chủ shop có nhiều câu hỏi lặp lại về sản phẩm, chính sách và cách sử dụng có thể bắt đầu với Customer Support Agent. Cách làm là đưa knowledge base phù hợp vào quickstart theo hướng dẫn của thư mục, cấu hình Claude API key rồi chạy ứng dụng.
Người dùng đặt câu hỏi trong giao diện của dự án. Claude trả lời dựa trên khả năng hiểu ngôn ngữ và dữ liệu trong knowledge base. Kết quả mong đợi là một trợ lý hỗ trợ khách hàng có thể tùy chỉnh tiếp theo sản phẩm của shop. README được cung cấp chưa nói rõ cách nạp dữ liệu hay giao diện, nên phần đó phải làm theo tài liệu riêng.
B.Nhân viên văn phòng muốn hỏi dữ liệu tài chính
Một nhân viên kinh doanh hoặc phân tích có thể dùng Financial Data Analyst để thử hỏi dữ liệu bằng ngôn ngữ tự nhiên. Thay vì tự tạo từng biểu đồ, họ có thể đặt câu hỏi qua chat và xem trực quan hóa tương tác do quickstart minh họa.
Quy trình cụ thể là cài theo README của dự án, chuẩn bị dữ liệu đúng định dạng mà tài liệu yêu cầu, cấu hình API key rồi chạy ứng dụng. Kết quả là một trải nghiệm phân tích qua hội thoại. Tư liệu chung chưa cho biết loại dữ liệu đầu vào cụ thể, nên không nên tự giả định rằng mọi file bảng tính đều được hỗ trợ.
C.Dev muốn tự động hóa thao tác trên trình duyệt
Một dev có quy trình phải mở website, đọc nội dung DOM, điền biểu mẫu hoặc trích xuất thông tin có thể nghiên cứu Browser Use Demo. Quickstart cung cấp một triển khai tham khảo với Playwright-backed browser tool.
Dev cần đọc README riêng, cấu hình môi trường trình duyệt và quyền truy cập cần thiết, sau đó thử trên website không quan trọng trước. Prompt hoặc câu lệnh cụ thể phải bám vào khả năng mà dự án cung cấp, chẳng hạn yêu cầu agent mở trang, kiểm tra nội dung, điền trường biểu mẫu hoặc lấy thông tin. Kết quả là agent thực hiện chuỗi thao tác browser trong phạm vi tool được cấp.
D.Đội phát triển muốn chia một dự án lớn cho coding agent
Một đội dev có thể dùng Autonomous Coding Agent để nghiên cứu cách giao việc dài qua nhiều phiên. Agent initializer chuẩn bị nền tảng, coding agent làm theo feature list, còn tiến độ được lưu bằng git.
Đội nên thử trên repository mẫu hoặc bản sao trước. Mỗi feature cần được kiểm tra trước khi cho agent làm tiếp. Kết quả mong đợi là một ứng dụng được xây dần qua nhiều session, có lịch sử và trạng thái để tiếp tục. Đây là mẫu học kiến trúc agent, không phải cam kết rằng agent sẽ tự động tạo mã nguồn đúng cho mọi dự án.
E.Quản lý công việc qua Slack, GitHub hoặc Sentry
Nếu đội đã dùng các dịch vụ như Slack, GitHub, Linear hoặc Sentry, bạn có thể chọn Managed Agents quickstart tương ứng. Ví dụ, Managed Agents: Daily Brief minh họa agent đọc các kênh Slack và pull request GitHub rồi đăng một bản tóm tắt ngắn theo lịch.
Managed Agents: Slack minh họa webhook bridge stateless cho mention trong Slack. Managed Agents: Sentry minh họa agent triage Sentry theo lịch. Managed Agents: Sentry Autofix minh họa quy trình đọc stack trace, tái hiện lỗi bằng test, tạo branch và mở pull request để con người review.
Những mẫu này phù hợp để học cách nối agent vào quy trình có thật. Bạn cần đọc kỹ quyền credential, vault, sandbox và giới hạn chi phí trước khi thử trên workspace thật.
Quickstart tốt nhất không phải là ứng dụng hoàn thiện, mà là nền móng để bạn hiểu cách biến Claude thành một phần của quy trình.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Không biết chạy lệnh nào
Repo có nhiều quickstart và README chung không đưa lệnh chạy cụ thể. Hãy chắc chắn bạn đang ở đúng thư mục dự án, rồi mở README trong thư mục đó. Không dùng lệnh của một quickstart cho quickstart khác.
B.Đặt API key sai vị trí
README chung chỉ nói cần đặt key dưới dạng biến môi trường, không nêu tên biến. Nếu ứng dụng báo thiếu key, hãy tìm phần setup trong README riêng và kiểm tra terminal hiện tại có nhận biến môi trường hay chưa. Không ghi key trực tiếp vào mã nguồn nếu tài liệu không yêu cầu.
C.Thiếu dependency hoặc dùng sai phiên bản
Mỗi quickstart có thể có dependency riêng. Đọc pyproject.toml và README trong thư mục dự án, rồi cài đúng theo hướng dẫn được ghi. Không tự đoán package, phiên bản hoặc cờ lệnh từ một dự án khác.
D.Chọn sai môi trường cho computer use
Computer Use Best Practices là bản native macOS và README khuyến nghị chạy trong máy ảo. Nếu bạn đang dùng Windows hoặc môi trường không phù hợp, hãy chọn quickstart khác hoặc đọc kỹ yêu cầu riêng trước khi tiếp tục.
E.Agent thao tác nhầm hệ thống bên ngoài
Browser use, computer use, webhook, Slack, GitHub và Sentry đều có thể liên quan đến dữ liệu hoặc hành động thật. Hãy thử với tài khoản, repository và dữ liệu kiểm thử; giới hạn quyền; theo dõi session và chi phí. Với quy trình tạo pull request hoặc cập nhật hệ thống, nên giữ bước review của con người.
VII.Có nên dùng không
Nên dùng nếu bạn muốn học nhanh các cách xây ứng dụng Claude có cấu trúc rõ hơn một ví dụ gọi API đơn giản. Repo có nhiều hướng từ chatbot, phân tích dữ liệu đến browser automation, computer use, coding agent và Managed Agents. Mã nguồn MIT, đang tiếp tục được cập nhật và có nhiều ví dụ để bạn đọc, chạy thử rồi tùy chỉnh.
Giới hạn lớn nhất là repo không có một quy trình cài đặt duy nhất. README chung chỉ mô tả các bước tổng quát; lệnh cài, lệnh chạy và credential cụ thể nằm trong README của từng quickstart. Một số dự án còn phụ thuộc macOS, Chromium, VNC, dịch vụ ngoài hoặc nền tảng Managed Agents.
Nếu bạn cần một sản phẩm hoàn chỉnh cho người dùng cuối, hãy xem đây là mã tham khảo và chuẩn bị thêm phần bảo mật, kiểm thử, giám sát, giới hạn quyền và kiểm soát chi phí. Nếu bạn chỉ cần gọi Claude API trong một script nhỏ, một ví dụ tối giản riêng có thể dễ bắt đầu hơn. Còn nếu mục tiêu là hiểu nhiều mẫu kiến trúc và chọn nền tảng cho ứng dụng Claude, anthropics/claude-quickstarts là lựa chọn đáng xem.
Câu hỏi thường gặp
Repo này có miễn phí không?
Mã nguồn được cấp phép MIT. Tuy nhiên, README yêu cầu Claude API key và tư liệu không xác nhận toàn bộ việc sử dụng API hay các dịch vụ ngoài là miễn phí.
Có cần GPU không?
README được cung cấp không nói repo cần GPU. Yêu cầu phần cứng cụ thể của từng quickstart chưa được nêu, nên cần xem README riêng của dự án.
Có chạy được trên Windows không?
README không công bố yêu cầu hệ điều hành chung. Riêng Computer Use Best Practices là bản native macOS và được khuyến nghị chạy trong máy ảo, nên không nên giả định quickstart này chạy trực tiếp trên Windows.
Tôi cần API key nào?
Bạn cần Claude API key. README cho biết có thể đăng ký tại console.anthropic.com, nhưng không nêu tên biến môi trường; hãy xem README của quickstart đã chọn để biết cách cấu hình.
Repo có một lệnh cài đặt chung không?
Không. README chỉ đưa quy trình tổng quát gồm clone, vào thư mục quickstart, cài dependency, cấu hình key và chạy ứng dụng. Lệnh cụ thể phải xem trong README của từng dự án.
Dữ liệu và API key có an toàn không?
Tư liệu chung không đưa cam kết bảo mật chung cho mọi quickstart. Bạn nên giữ kín API key, cấp quyền tối thiểu và thử browser use, computer use hoặc các tích hợp bên ngoài trong môi trường kiểm soát.
Repo này có phải mã nguồn production không?
Không phải mọi quickstart đều là mã production. README nói rõ Browser Toolset Quickstart là ví dụ minh họa giao diện và không phải production code; các dự án khác cũng nên được xem như nền tảng tham khảo trước khi triển khai.


