Bỏ qua tới nội dung
Ông T.vn

claude-quickstarts: bộ mẫu dự án Claude API chạy được ngay — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về anthropics/claude-quickstarts — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: anthropics/claude-quickstarts: xây ứng dụng Claude — hướng dẫn cài đặt và dùng →

claude-quickstarts: bộ mẫu dự án Claude API chạy được ngay — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

claude-quickstarts là kho dự án mẫu của Anthropic giúp lập trình viên dựng nhanh ứng dụng với Claude API, gồm trợ lý chăm sóc khách hàng, phân tích tài chính, computer use, browser use và nhiều agent khác. Mỗi dự án nằm trong một thư mục riêng, có README và hướng dẫn cài riêng. Việc cài không khó nếu bạn đã quen dòng lệnh, nhưng cần có API key của Claude.

Claude Quickstarts là kho tập hợp các dự án mẫu do Anthropic phát hành, giúp lập trình viên bắt đầu xây ứng dụng bằng Claude API thật nhanh. Mỗi dự án là một nền móng hoàn chỉnh nằm trong thư mục riêng, bạn chạy thử được rồi sửa dần theo nhu cầu của mình.

Repo này hợp với ba nhóm người. Thứ nhất là lập trình viên mới muốn xem một ứng dụng dùng Claude được viết ra sao. Thứ hai là người làm sản phẩm, làm kinh doanh muốn thấy tận mắt Claude làm được gì trước khi quyết định đầu tư. Thứ ba là dev có kinh nghiệm cần một mẫu tham khảo cho các tính năng mới như computer use, browser use hay Managed Agents.

Điểm đáng giá nhất: đây là mẫu chính thức, nên cách dùng các tính năng mới của Claude trong đó đáng tin hơn bài hướng dẫn tự phát. Repo hiện có khoảng 20.800 sao và khoảng 3.500 fork, giấy phép MIT, ngôn ngữ chính là Python, và vẫn được cập nhật trong 3 tháng gần đây.

Danh sách tuyển chọn

anthropics/claude-quickstarts

Bộ dự án mẫu chính thức của Anthropic để bắt đầu xây ứng dụng bằng Claude API: trợ lý CSKH, phân tích tài chính, điều khiển máy tính, agent lập trình.

★ 21kPythonMIT
Xem repo trên GitHub

I.Claude Quickstarts làm được gì

Repo không phải một phần mềm duy nhất. Nó là một bộ sưu tập, và bạn chọn đúng thư mục mình cần. Các nhóm dự án chính:

A.Trợ lý chăm sóc khách hàng và phân tích dữ liệu

  • Customer Support Agent (thư mục customer-support-agent/): trợ lý hỗ trợ khách hàng chạy bằng Claude, có truy cập một kho kiến thức. Hợp để bạn hình dung một bot trả lời khách dựa trên tài liệu của doanh nghiệp.
  • Financial Data Analyst (thư mục financial-data-analyst/): bạn trò chuyện để phân tích dữ liệu tài chính, kết quả có biểu đồ tương tác. Hợp với người làm kế toán, báo cáo.

B.Điều khiển máy tính và trình duyệt

  • Computer Use Demo (computer-use-demo/): môi trường và công cụ để Claude điều khiển một màn hình máy tính. README nhắc đến hỗ trợ bộ công cụ computer_toolset_20260801.
  • Computer Use Best Practices (computer-use-best-practices/): bản tham chiếu chạy trực tiếp trên macOS (README khuyên chạy trong máy ảo). Nó minh hoạ cách làm agent đáng tin và tiết kiệm hơn: định nghĩa công cụ rõ ràng, cắt tỉa ảnh, prompt caching, ghi lại quá trình chạy.
  • Browser Use Demo (browser-use-demo/): cho Claude duyệt web, xem phần tử trên trang, lấy nội dung và điền form bằng công cụ trình duyệt dựa trên Playwright.
  • Browser Toolset (browser-toolset/) và Computer Toolset (computer-toolset/): hai ví dụ tối giản, có bản Python và TypeScript. README nói rõ đây chỉ để xem giao diện, không phải mã dùng cho sản phẩm thật.

C.Agent lập trình tự động

  • Autonomous Coding Agent (autonomous-coding/): agent viết code dùng Claude Agent SDK, theo mô hình hai agent (một agent khởi tạo, một agent viết code). Nó có thể dựng cả ứng dụng qua nhiều phiên làm việc, tiến độ được lưu bằng git và một danh sách tính năng làm dần.

D.Nhóm Managed Agents

Thư mục managed-agents/ chứa nhiều mẫu xây trên Claude Managed Agents:

  • Chat SDKứng dụng chat trên trình duyệt, có agent nghiên cứu bằng tìm kiếm web. README nói cùng một bộ xử lý có thể chạy trên Slack, Teams, Discord, Telegram hay WhatsApp bằng cách đổi adapter.
  • CopilotKit và AG-UItrợ lý tài chính cá nhân hiển thị kết quả công cụ thành các thành phần giao diện trong khung chat.
  • Daily Briefagent chạy theo lịch mỗi ngày làm việc, đọc kênh Slack và pull request GitHub rồi đăng một bản tóm tắt ngắn lên Slack.
  • Knowledge Wikibiến bộ tài liệu thành một wiki kiến thức có phiên bản, rồi trả lời câu hỏi kèm nguồn gốc cho từng dữ kiện. Ví dụ minh hoạ là hồ sơ M&A lấy từ hồ sơ công khai SEC EDGAR.
  • Linear, Slackagent bạn có thể @mention hoặc giao việc ngay trong Linear hoặc Slack.
  • MCP Server (TypeScript)máy chủ MCP có chín công cụ, cho Claude Desktop, Claude Code hoặc claude.ai điều khiển các agent trong workspace của bạn.
  • Road Trip Plannerứng dụng Next.js lập kế hoạch đi các công viên quốc gia, minh hoạ streaming, thông tin đăng nhập lưu trong vault và agent điều phối có agent kiểm duyệt.
  • Sentry và Sentry Autofixagent xử lý lỗi từ Sentry. Bản Autofix tái hiện lỗi bằng một bài test, đẩy nhánh lên, rồi để một người duyệt pull request.

Lợi ích thực tế: bạn không phải đoán cách ghép các mảnh với nhau. Mỗi dự án là một ví dụ chạy được từ đầu đến cuối.

II.Cần chuẩn bị gì

Tư liệu của repo nói không nhiều, nên mình chỉ liệt kê những gì có trong đó:

  • API key của Claude. README ghi bạn cần key này. Bạn có thể đăng ký tại console.anthropic.com. README nói đăng ký là miễn phí, nhưng chi phí gọi API khi chạy dự án thì README không nêu.
  • Git để tải repo về (lệnh git clone ở phần dưới).
  • Một terminal (PowerShell, Terminal hoặc tương đương) để chạy lệnh.
  • Python là ngôn ngữ chính của repo, và repo có file pyproject.toml ở thư mục gốc. Một số dự án có bản TypeScript hoặc Next.js nên có thể cần Node. Phiên bản cụ thể mỗi dự án ghi trong README riêng của nó, README gốc không nêu.
  • Riêng Computer Use Best Practices chạy trên macOS. Một số dự án Managed Agents cần thêm tài khoản dịch vụ (Slack, Linear, Sentry, GitHub…) tuỳ dự án.

API key giống mật khẩu. Đừng dán key vào code rồi đưa lên GitHub, đừng gửi cho người khác. Các dự án computer use và agent lập trình có thể gọi API nhiều lần liên tục, nên hãy theo dõi chi phí trong trang quản trị tài khoản của bạn.

III.Cài đặt từng bước

README gốc chỉ mô tả quy trình chung. Lệnh cài cụ thể nằm trong README của từng thư mục dự án.

  1. Tải repoDùng git clone để lấy toàn bộ mã nguồn về máy
  2. Chọn dự ánVào đúng thư mục quickstart bạn muốn thử
  3. Cài thư việnLàm theo README riêng của dự án đó
  4. Đặt API keyKhai báo key Claude dưới dạng biến môi trường
  5. Chạy thửKhởi động ứng dụng theo hướng dẫn của dự án

A.Tải repo về máy

Mở terminal ở thư mục bạn muốn lưu code (ví dụ thư mục Documents), rồi chạy:

Terminal
git clone https://github.com/anthropics/claude-quickstarts.git
cd claude-quickstarts

Lệnh đầu tải repo về. Lệnh thứ hai đi vào thư mục vừa tạo. Người mới hay vấp ở chỗ chạy lệnh sai thư mục, nên nếu thấy báo không tìm thấy gì, hãy kiểm tra bạn đang đứng ở đâu.

B.Vào thư mục dự án bạn chọn

Nhìn vào gốc repo bạn sẽ thấy các thư mục như customer-support-agent, financial-data-analyst, computer-use-demo, browser-use-demo, autonomous-coding, managed-agents. Chọn một thư mục rồi đi vào. Ví dụ với trợ lý phân tích tài chính:

Terminal
cd financial-data-analyst

Đổi tên thư mục theo dự án bạn muốn thử. Riêng nhóm Managed Agents nằm trong managed-agents/, và mỗi mẫu trong đó có thư mục con riêng.

C.Cài thư viện cần thiết

README gốc chỉ ghi chung là cài các thư viện phụ thuộc, không ghi lệnh cụ thể, vì mỗi dự án dùng công cụ khác nhau. Vì vậy mình không chép lệnh ở đây. Bạn mở file README.md nằm trong thư mục dự án vừa chọn và làm đúng theo đó. Ở thư mục gốc có pyproject.toml, bạn có thể xem thêm để biết cấu hình Python của repo.

D.Đặt API key

README gốc yêu cầu đặt key Claude làm biến môi trường. Tên biến cụ thể và nơi điền (biến hệ thống hay file cấu hình trong dự án) được ghi trong README của từng dự án, nên bạn hãy xem ở đó. Lỗi hay gặp là mở terminal mới sau khi đặt biến mà biến chưa có hiệu lực, hoặc dán key có dấu cách thừa ở đầu cuối.

E.Chạy ứng dụng

Lệnh khởi động cũng nằm trong README của dự án. Có dự án chạy trong terminal, có dự án mở giao diện web, có dự án cần dựng môi trường thêm. README chưa ghi lệnh chạy chung cho cả repo, nên đừng thử đoán lệnh.

IV.Kiểm tra đã chạy được chưa

Vì mỗi dự án có cách chạy khác nhau, dấu hiệu thành công cũng khác nhau. Bạn có thể dựa vào mô tả trong README gốc:

  • Với Customer Support Agent hoặc Financial Data Analyst: bạn gõ được câu hỏi và nhận được câu trả lời từ Claude. Bản tài chính còn cho ra biểu đồ tương tác.
  • Với Browser Use Demo: Claude mở được một trang web, đọc nội dung hoặc điền form theo yêu cầu.
  • Với Computer Use Demo: Claude thao tác được trên màn hình của môi trường demo.
  • Với các mẫu Slack hoặc Linear: bạn @mention agent và nhận lại câu trả lời trong chính luồng thảo luận.

Nếu ứng dụng khởi động nhưng báo lỗi xác thực khi gọi Claude, gần như chắc chắn là vấn đề API key. Hãy quay lại bước đặt key.

V.Dùng vào việc thật

README không đưa prompt mẫu, nên dưới đây là các tình huống bám đúng khả năng từng dự án đã mô tả. Phần câu lệnh bạn tự diễn đạt theo nhu cầu.

A.Chủ cửa hàng muốn thử trợ lý trả lời khách

Bạn bán hàng online và hay phải trả lời cùng một loại câu hỏi về đổi trả, vận chuyển. Chạy Customer Support Agent để xem một trợ lý có kho kiến thức hoạt động ra sao. Bạn đưa vào nội dung chính sách của mình (theo cách README của dự án hướng dẫn), rồi đóng vai khách hỏi thử. Kết quả là bạn có một bản chạy thử để đánh giá chất lượng câu trả lời trước khi nghĩ đến việc đưa vào hệ thống thật.

B.Nhân viên kế toán phân tích số liệu bằng chat

Bạn có dữ liệu tài chính và muốn hỏi bằng ngôn ngữ thường thay vì dựng biểu đồ thủ công. Với Financial Data Analyst, bạn nhập yêu cầu kiểu như so sánh doanh thu các quý hoặc cho xem xu hướng chi phí. Ứng dụng trả lời kèm biểu đồ tương tác ngay trong khung chat.

Cách nhanh nhất để hiểu Claude làm được gì là chạy một dự án mẫu thật, rồi sửa nó theo việc của chính bạn.

Ông T

C.Dev dựng bot Slack cho nhóm

Nhóm bạn dùng Slack và muốn một trợ lý trả lời khi được nhắc tên. Mẫu Managed Agents: Slack cho thấy cách làm: mỗi lần @mention tạo một phiên agent, câu trả lời được đăng lại đúng luồng thảo luận, không cần cơ sở dữ liệu. Bạn chạy mẫu, xem cách nó nối webhook, rồi thay agent bằng agent của mình. Kết quả là một bot dùng được trong nhóm, và bạn hiểu rõ kiến trúc phía sau.

D.Dev tìm hiểu agent tự viết code

Bạn muốn xem một agent có thể xây cả ứng dụng qua nhiều phiên như thế nào. Autonomous Coding Agent cho bạn xem mô hình hai agent: một agent khởi tạo danh sách tính năng, agent viết code làm dần từng mục, tiến độ lưu bằng git. Bạn dùng nó để học cách chia việc dài thành nhiều phiên, chứ không nhất thiết đem chạy ngay trên dự án quan trọng.

VI.Lỗi hay gặp và cách xử lý

Lưu ý: các lỗi dưới đây là lỗi rất dễ xảy ra với loại công cụ này, không phải danh sách chính thức từ README.

A.Chạy lệnh sai thư mục

README gốc không có mã chạy được, mã nằm trong từng thư mục dự án. Nếu terminal báo không tìm thấy file, dùng cd vào đúng thư mục dự án rồi thử lại.

B.Báo lỗi xác thực hoặc thiếu API key

Kiểm tra bạn đã đặt biến môi trường đúng tên như README của dự án ghi, đã mở terminal mới sau khi đặt, và key không thừa ký tự. Đừng dán key trực tiếp vào code rồi commit.

C.Thiếu phiên bản Python hoặc Node phù hợp

Mỗi dự án có yêu cầu riêng. Đọc kỹ phần yêu cầu trong README của thư mục dự án, đừng cài theo suy đoán. Nếu cài thư viện bị lỗi, hãy dùng môi trường ảo riêng cho từng dự án để tránh xung đột.

D.Dự án computer use điều khiển nhầm thứ

Các dự án cho Claude điều khiển máy tính hoặc trình duyệt có thể làm những việc bạn không mong muốn. README Computer Use Best Practices khuyên chạy trong máy ảo. Hãy làm vậy, và đừng cho agent truy cập tài khoản hay dữ liệu quan trọng khi mới thử.

E.Mẫu Managed Agents cần dịch vụ bên ngoài

Các mẫu Slack, Linear, Sentry cần tài khoản và quyền ở các dịch vụ đó. Nếu thiếu quyền thì bot không phản hồi. Đọc phần cấu hình trong README của mẫu và làm lần lượt từng bước.

VII.Có nên dùng không

Điểm mạnh. Đây là mẫu chính thức từ Anthropic, giấy phép MIT nên bạn dùng và sửa thoải mái. Bộ sưu tập rộng, từ chat hỗ trợ khách hàng, phân tích dữ liệu đến agent tự động, nên khó có nhu cầu nào bạn không tìm được mẫu gần giống. Repo vẫn được cập nhật và có cộng đồng lớn.

Giới hạn. Đây là mẫu để học và làm nền, không phải sản phẩm đóng gói cài xong dùng ngay. README còn ghi rõ một số ví dụ chỉ để minh hoạ giao diện, không phải mã cho môi trường thật. Bạn cần biết dùng dòng lệnh và đọc README từng dự án. Người không rành kỹ thuật sẽ thấy khó hơn so với một ứng dụng có giao diện cài sẵn. Ngoài ra, mọi dự án đều cần API key, nên bạn có thể phát sinh chi phí khi chạy.

Khi nào chọn cách khác. Nếu bạn chỉ muốn chat với Claude hoặc làm việc thường ngày, dùng ứng dụng Claude có sẵn sẽ nhanh hơn. Nếu bạn cần giải pháp sản xuất ngay mà không có người lập trình, hãy tìm sản phẩm đóng gói. Còn nếu bạn muốn học cách xây ứng dụng với Claude API, repo này là điểm bắt đầu rất hợp lý.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

claude-quickstarts có miễn phí không?

Mã nguồn dùng giấy phép MIT nên bạn dùng và sửa tự do. README nói đăng ký tài khoản để lấy API key là miễn phí. Chi phí gọi API khi chạy dự án thì README không nêu, bạn nên xem trang giá và quản trị trên console.anthropic.com.

Tôi có cần API key không?

Có. README ghi rõ bạn cần API key của Claude để dùng các quickstart, và key đó được đặt làm biến môi trường. Bạn có thể đăng ký tại console.anthropic.com.

Cần GPU không?

README không nhắc yêu cầu GPU. Các dự án gọi Claude qua API nên phần xử lý mô hình không chạy trên máy bạn. Yêu cầu phần cứng cụ thể của từng dự án nằm trong README riêng của nó.

Chạy được trên Windows không?

README gốc không nêu rõ hệ điều hành chung. Riêng Computer Use Best Practices được mô tả là chạy trực tiếp trên macOS. Với các dự án khác, bạn cần xem README trong thư mục dự án.

Cài xong chạy lệnh nào?

README gốc chỉ nêu quy trình chung: clone repo, vào thư mục dự án, cài thư viện, đặt API key, rồi chạy. Lệnh cài và lệnh chạy cụ thể nằm trong README của từng thư mục dự án.

Khác gì Claude Cookbooks?

README gốc giới thiệu Claude Cookbooks là bộ đoạn mã và hướng dẫn cho các việc thường gặp. Còn Quickstarts là các dự án hoàn chỉnh làm nền cho ứng dụng. Ngoài mô tả đó, tư liệu không so sánh chi tiết hơn.

Dữ liệu của tôi có an toàn không?

Tư liệu chưa có thông tin chung về việc này. Các dự án gọi Claude API nên dữ liệu bạn nhập sẽ được gửi đến dịch vụ đó. Riêng Sentry Autofix, README nói thông tin đăng nhập được lưu trong vault bên ngoài sandbox, và sandbox không có đường ra internet mở.

Chuyển nhanh tới mục

  1. I.Claude Quickstarts làm được gì
    1. A.Trợ lý chăm sóc khách hàng và phân tích dữ liệu
    2. B.Điều khiển máy tính và trình duyệt
    3. C.Agent lập trình tự động
    4. D.Nhóm Managed Agents
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Tải repo về máy
    2. B.Vào thư mục dự án bạn chọn
    3. C.Cài thư viện cần thiết
    4. D.Đặt API key
    5. E.Chạy ứng dụng
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ cửa hàng muốn thử trợ lý trả lời khách
    2. B.Nhân viên kế toán phân tích số liệu bằng chat
    3. C.Dev dựng bot Slack cho nhóm
    4. D.Dev tìm hiểu agent tự viết code
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy lệnh sai thư mục
    2. B.Báo lỗi xác thực hoặc thiếu API key
    3. C.Thiếu phiên bản Python hoặc Node phù hợp
    4. D.Dự án computer use điều khiển nhầm thứ
    5. E.Mẫu Managed Agents cần dịch vụ bên ngoài
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.