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

> claude-quickstarts là kho dự án mẫu của Anthropic, mỗi thư mục là một ứng dụng nhỏ dùng Claude API như chatbot hỗ trợ khách hàng, phân tích tài chính, điều khiển máy tính hay agent lập trình tự động. Bạn cần một API key của Claude, rồi vào đúng thư mục để làm theo README riêng. Cài không khó nhưng mỗi dự án có cách chạy khác nhau.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-25 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/claude-quickstarts-mau-du-an-claude-api-huong-dan-cai-dat-2

Claude Quickstarts là một kho mã nguồn mở của Anthropic, gom nhiều dự án mẫu để bạn bắt đầu xây ứng dụng bằng Claude API. Mỗi dự án nằm trong một thư mục riêng, có sẵn khung chạy được để bạn sửa theo nhu cầu của mình. Bạn không phải viết từ con số không.

Repo hợp với lập trình viên mới, người làm kỹ thuật trong doanh nghiệp, hoặc người kinh doanh có người trong team biết code. Bạn muốn thử làm chatbot chăm sóc khách hàng, trợ lý phân tích số liệu, hay agent biết thao tác trên trình duyệt và màn hình. Với các nhu cầu đó, mở một mẫu có sẵn nhanh hơn nhiều so với tự mày mò từ tài liệu.

Điểm đáng giá nhất là đây là mẫu do chính Anthropic viết, nên bạn thấy được cách họ khuyến nghị dùng công cụ của Claude. Repo hiện có khoảng 20.815 sao và 3.492 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.

```repo
- repo | anthropics/claude-quickstarts
- kind | Danh sách tuyển chọn
- desc | Bộ dự án mẫu chính thức của Anthropic giúp lập trình viên dựng ứng dụng với Claude API: hỗ trợ khách hàng, phân tích tài chính, điều khiển máy tính, agent.
- stars | 21k
- lang | Python
- license | MIT
```

## claude-quickstarts làm được gì

Repo không phải một ứng dụng duy nhất. Nó là bộ sưu tập, nên cách đọc hợp lý là chọn đúng mẫu cho việc của bạn. Dưới đây là các nhóm chính.

### Mẫu ứng dụng kinh doanh

- **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 với shop hoặc doanh nghiệp muốn thử chatbot trả lời dựa trên tài liệu của mình.
- **Financial Data Analyst** (thư mục `financial-data-analyst/`): bạn chat để 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, tài chính muốn hỏi số liệu bằng ngôn ngữ thường.

### Mẫu cho agent đ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áy tính để bàn. README nhắc đến hỗ trợ bộ công cụ `computer_toolset_20260801`.
- **Computer Use Best Practices** (`computer-use-best-practices/`): bản tham khảo chạy trực tiếp trên macOS, dùng để học cách làm agent đáng tin và tiết kiệm hơn. README khuyên chạy nó trong máy ảo. Nó minh hoạ các kỹ thuật như định nghĩa công cụ rõ ràng, chỉnh cỡ ảnh, prompt caching, shell có hộp cát và 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, dùng công cụ trình duyệt dựa trên Playwright.
- **Browser Toolset** và **Computer Toolset**: hai ví dụ tối giản, có bản Python và TypeScript. README nói rõ chúng chỉ để minh hoạ giao diện, không phải mã dùng cho môi trường thật.

### Mẫu agent lập trình tự động

- **Autonomous Coding Agent** (`autonomous-coding/`): dùng Claude Agent SDK với mô hình hai agent (một agent khởi tạo, một agent viết code). Agent làm dần qua nhiều phiên, tiến độ lưu bằng git và một danh sách tính năng.

### Mẫu Managed Agents

Thư mục `managed-agents/` chứa nhiều mẫu xây trên Claude Managed Agents. Theo README có thể kể đến:

- Bot Slack và agent trong Linear: nhắc tên (`@mention`) là agent trả lời.
- Bản tin hằng ngày: agent đọc kênh Slack và pull request GitHub mỗi ngày làm việc rồi đăng một bản tóm tắt ngắn lên Slack.
- Wiki kiến thức cho phòng dữ liệu M&A, ví dụ lấy từ hồ sơ công khai trên SEC EDGAR.
- Trợ lý lên kế hoạch chuyến đi công viên quốc gia, chat tài chính cá nhân với CopilotKit.
- Agent phân loại lỗi Sentry và Sentry Autofix, tự tạo nhánh sửa lỗi để người duyệt pull request.
- MCP server (TypeScript) cho phép Claude Desktop, Claude Code hay claude.ai điều khiển các agent trong workspace của bạn.

Bạn không cần thử hết. Chọn một mẫu gần việc của mình nhất, đọc kỹ, rồi mới mở rộng.

## Cần chuẩn bị gì

Theo README gốc, điều kiện chung duy nhất là một **API key của Claude**. Nếu chưa có, README nói bạn có thể đăng ký tại console.anthropic.com. README ghi là đăng ký miễn phí, nhưng không nói gì về hạn mức dùng thử, nên bạn nên tự kiểm tra bảng giá trong tài khoản.

Ngoài ra, mỗi dự án có yêu cầu riêng, và README gốc không liệt kê phiên bản Python, Node hay hệ điều hành cho từng dự án. Bạn nên đọc README trong thư mục đó. Vài ví dụ đã nêu trong tư liệu:

- Computer Use Best Practices chạy trực tiếp trên macOS, nên cần máy Mac (và nên dùng máy ảo).
- Các mẫu Managed Agents gắn với dịch vụ ngoài sẽ cần tài khoản dịch vụ đó, ví dụ Slack, Linear hay Sentry.
- Repo có file `pyproject.toml` ở thư mục gốc, cho thấy phần Python được khai báo theo chuẩn này. README gốc không hướng dẫn lệnh cài từ file đó.

Tư liệu không nói về yêu cầu GPU. Các dự án gọi Claude qua API nên về nguyên tắc nặng ở phía dịch vụ. Nhưng bạn nên xác nhận trong README của từng mẫu.

```note
API key giống mật khẩu và việc gọi API có thể tính phí theo mức dùng. Đừng dán key vào file rồi đẩy lên GitHub, đừng gửi key cho người khác. Với các mẫu agent tự chạy lâu như Autonomous Coding, hãy theo dõi chi phí trong trang quản lý tài khoản.
```

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

README gốc mô tả quy trình chung gồm năm bước. Nó không đưa lệnh cài cụ thể, vì mỗi quickstart có README và hướng dẫn riêng. Phần này mình bám đúng như vậy.

```steps
- Tải repo | Clone repo về máy bằng git
- Vào thư mục mẫu | Chọn một quickstart và cd vào thư mục của nó
- Cài thư viện | Làm theo README trong thư mục đó
- Đặt API key | Khai báo key của Claude dưới dạng biến môi trường
- Chạy thử | Chạy ứng dụng theo hướng dẫn của mẫu
```

### Tải repo về máy

Bạn cần cài sẵn git. Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên Mac là Terminal), rồi chạy:

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

Lệnh đầu tải toàn bộ repo về một thư mục mới. Lệnh thứ hai đi vào thư mục đó. Chỗ người mới hay vấp là chạy lệnh ở sai thư mục, nên hãy kiểm tra bạn đang đứng trong `claude-quickstarts` trước khi làm tiếp.

### Chọn một mẫu và vào thư mục của nó

Sau khi clone, 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`. Ví dụ muốn thử chatbot hỗ trợ khách hàng:

```bash
cd customer-support-agent
```

Đây chỉ là ví dụ để minh hoạ cách đi vào thư mục. Bạn thay bằng tên thư mục mẫu mình chọn. Với nhóm Managed Agents, các mẫu nằm tiếp bên trong `managed-agents/`.

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

README gốc chỉ ghi "cài các thư viện cần thiết" mà **chưa ghi lệnh cụ thể**. Cách cài khác nhau tuỳ mẫu: có mẫu là Python, có mẫu có bản TypeScript. Hãy mở file README.md nằm trong thư mục mẫu bạn vừa vào và làm đúng theo đó. Đừng đoán lệnh, vì sai công cụ cài sẽ dễ gây lỗi khó hiểu.

### Đặt API key

README gốc nói bạn cần đặt API key Claude làm biến môi trường, nhưng **không nêu tên biến**. Tên biến và cách đặt nằm trong README hoặc file mẫu cấu hình của từng dự án. Biến môi trường chỉ có hiệu lực trong cửa sổ terminal bạn đặt, nên nếu mở terminal mới, bạn có thể phải đặt lại. Một số mẫu có thể dùng file cấu hình riêng, nên hãy xem hướng dẫn của mẫu đó.

### Chạy ứng dụng

Lệnh chạy phụ thuộc từng mẫu, nên README gốc không ghi lệnh chung. Bạn xem mục chạy thử trong README của thư mục mẫu. Riêng các mẫu Managed Agents, README gốc có nhắc một số mẫu dùng công cụ dòng lệnh `ant apply` để triển khai (ví dụ mẫu Daily Brief). Cách dùng chi tiết nằm trong README của mẫu đó.

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

Vì mỗi mẫu có kết quả khác nhau, README gốc không có một lệnh kiểm tra chung. Dưới đây là cách tự kiểm tra hợp lý theo mô tả của từng loại mẫu:

- **Mẫu có giao diện chat** (hỗ trợ khách hàng, phân tích tài chính): bạn mở giao diện theo hướng dẫn rồi gõ một câu hỏi. Nếu Claude trả lời, key và cấu hình đang đúng.
- **Mẫu Slack hoặc Linear**: nhắc tên bot rồi xem có câu trả lời xuất hiện trong luồng chat hoặc bình luận không. Mô tả của mẫu cho biết đây là cách chúng hoạt động.
- **Mẫu Browser và Computer Toolset**: README gốc nói mỗi mẫu có một script chạy không cần mô hình để thử bộ điều khiển. Dùng script này trước là cách kiểm tra gọn nhất, vì nó không tốn tiền gọi API.
- **Mẫu tự chạy theo lịch** (Daily Brief, Sentry): đợi lần chạy theo lịch hoặc theo hướng dẫn trong README của mẫu để xem kết quả.

Nếu có thông báo lỗi liên quan đến key hoặc xác thực, quay lại bước đặt API key. Nếu lỗi là thiếu thư viện, quay lại bước cài.

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

Các tình huống dưới đây bám đúng khả năng mà README mô tả. Mình không hứa kết quả cụ thể, vì kết quả còn phụ thuộc dữ liệu và cách bạn chỉnh mẫu.

### Chủ shop thử chatbot trả lời khách bằng tài liệu của mình

Bạn bán hàng online, câu hỏi khách lặp đi lặp lại: đổi trả, thời gian giao, bảo hành. Bạn nhờ một bạn biết code mở mẫu `customer-support-agent/`. Mẫu này là trợ lý hỗ trợ khách hàng chạy bằng Claude, có truy cập một kho kiến thức. Bạn thay nội dung kho kiến thức bằng chính sách của shop, sau đó thử hỏi những câu khách hay hỏi. Việc cần làm là xem câu trả lời có bám đúng chính sách không, rồi mới nghĩ tới chuyện đưa ra dùng thật.

> Mẫu có sẵn không thay được người làm sản phẩm, nhưng nó rút ngắn quãng đường từ ý tưởng đến bản chạy thử.
>
> — Ông T

### Nhân viên tài chính hỏi số liệu bằng chat

Bạn làm kế toán hoặc phân tích và hay phải dựng biểu đồ từ bảng số. Mẫu `financial-data-analyst/` cho phép phân tích dữ liệu tài chính qua chat, kèm trực quan hoá tương tác. Bạn thử với dữ liệu mẫu trước, ví dụ hỏi bằng câu thường như so sánh doanh thu giữa các quý. Khi quen cách mẫu hoạt động, nhờ lập trình viên nối vào nguồn dữ liệu của công ty. Lưu ý đừng đưa dữ liệu nhạy cảm vào khi chưa hiểu dữ liệu đi đâu.

### Dev mới học cách dựng agent thao tác trình duyệt

Bạn là lập trình viên mới và muốn hiểu agent duyệt web làm việc thế nào. Bắt đầu từ Browser Toolset, ví dụ tối giản qua giao thức CDP, có cả bản Python lẫn TypeScript. Chạy script không cần mô hình để xem bộ điều khiển hoạt động, rồi chạy script có tool runner để Claude gọi công cụ. Sau đó đọc tiếp Browser Use Demo để thấy cách làm đầy đủ hơn với Playwright: điều hướng, đọc phần tử, điền form. Cách học này đi từ đơn giản đến phức tạp và dễ kiểm soát chi phí.

### Nhóm kỹ thuật nhận bản tin hằng ngày trên Slack

Team của bạn dùng Slack và GitHub, ai cũng mất thời gian đọc tin cuối ngày. Mẫu Managed Agents: Daily Brief là agent chạy theo lịch, đọc kênh Slack và pull request GitHub vào mỗi ngày làm việc rồi đăng một bản tóm tắt ngắn lên Slack. README mô tả mẫu được thiết kế để chạy không người giám sát: nếu một nguồn không đọc được, agent báo là không đọc được thay vì coi như ngày yên ắng. Bạn có thể dùng nó như bản mẫu để dựng bản tin cho riêng team.

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

Tư liệu không liệt kê lỗi cụ thể, nên các lỗi dưới đây là những lỗi rất dễ xảy ra với loại dự án này.

### Lỗi xác thực hoặc từ chối truy cập

Thường do chưa đặt API key, đặt sai tên biến, hoặc đặt ở cửa sổ terminal khác. Hãy kiểm tra lại tên biến trong README của mẫu, đặt lại trong đúng cửa sổ đang chạy, và chắc chắn key còn hiệu lực trong trang quản lý tài khoản.

### Gõ lệnh sai thư mục

Báo không tìm thấy file hoặc không có gì để chạy. Nguyên nhân thường là bạn đang đứng ở thư mục gốc thay vì thư mục của mẫu. Dùng `cd` vào đúng thư mục rồi thử lại.

### Thiếu thư viện hoặc sai phiên bản

Báo không có module hay gói. Hãy đọc lại README của đúng mẫu và cài theo hướng dẫn. Đừng cài bừa nhiều gói khác nhau vào cùng môi trường, vì dễ xung đột giữa các dự án.

### Mẫu cần dịch vụ ngoài chưa được cấp quyền

Các mẫu Slack, Linear, Sentry cần tài khoản và cấp quyền cho ứng dụng. Nếu bot không phản hồi, kiểm tra lại phần cấp quyền và địa chỉ nhận webhook theo README của mẫu. Hãy cấp quyền ở mức tối thiểu cần thiết.

### Agent điều khiển máy tính làm việc ngoài ý muốn

Các mẫu computer use và browser use cho phép Claude thao tác trên màn hình hoặc trình duyệt. README của Computer Use Best Practices khuyên chạy trong máy ảo. Hãy làm theo, đừng cho agent chạy trên máy chứa dữ liệu quan trọng hay tài khoản đã đăng nhập.

## 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 được tự do sửa và dùng lại. Repo đa dạng: từ chatbot, phân tích dữ liệu đến agent điều khiển máy tính và các mẫu Managed Agents. Nhiều mẫu được viết để giải thích kỹ thuật, nên đọc để học rất tốt.

**Giới hạn:** đây là bộ mẫu, không phải phần mềm đóng gói sẵn để người không biết kỹ thuật bấm là chạy. README gốc không có lệnh cài chung, bạn phải đọc README của từng mẫu. Một số mẫu, như hai bộ toolset tối giản, được ghi rõ là chỉ để minh hoạ và không phải mã dùng cho môi trường thật. Bạn cũng cần API key và có thể phát sinh chi phí gọi API.

**Khi nào nên chọn cách khác:** nếu bạn chỉ cần chat với Claude để làm việc hằng ngày, dùng ứng dụng Claude sẵn có sẽ đơn giản hơn. Nếu cần sản phẩm hoàn chỉnh cho khách hàng, hãy coi mẫu là điểm khởi đầu rồi tự kiểm thử, bảo mật và đo chi phí kỹ trước khi đưa vào dùng thật.

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

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

Bản thân repo dùng giấy phép MIT nên tải và sửa tự do. Tuy vậy các mẫu cần API key của Claude. README nói đăng ký tài khoản tại console.anthropic.com là miễn phí, nhưng chưa có thông tin về hạn mức dùng thử hay giá gọi API, nên bạn cần xem trong tài khoản của mình.

### Tôi cần những gì để bắt đầu?

Theo README, thứ cần chung là một API key của Claude. Ngoài ra bạn cần tải repo về, chọn một mẫu, cài thư viện theo README của mẫu đó rồi đặt key dưới dạng biến môi trường. Yêu cầu chi tiết như phiên bản Python hay Node nằm trong README từng thư mục.

### Có cần GPU không?

Tư liệu không nói các mẫu cần GPU. Các dự án được mô tả là dùng Claude API, tức xử lý mô hình ở phía dịch vụ. Với từng mẫu cụ thể, bạn vẫn nên xem README để biết yêu cầu phần cứng.

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

README gốc không nêu hệ điều hành chung. Chỉ có mẫu Computer Use Best Practices được ghi rõ là chạy trực tiếp trên macOS. Với các mẫu còn lại, bạn cần xem README của từng thư mục.

### 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 xử lý dữ liệu. Các mẫu gọi Claude API nên nội dung bạn đưa vào sẽ đi qua dịch vụ đó. Với mẫu computer use và browser use, README khuyên chạy trong máy ảo, và bạn không nên dùng dữ liệu hay tài khoản nhạy cảm khi thử nghiệm.

### Repo này khác gì Claude Cookbooks?

Claude Quickstarts là các dự án mẫu hoàn chỉnh hơn, mỗi dự án nằm trong một thư mục riêng và có thể chạy để làm nền cho ứng dụng của bạn. README giới thiệu Claude Cookbooks là bộ đoạn mã và hướng dẫn cho các tác vụ phổ biến. Tư liệu không so sánh sâu hơn.

### Tôi nên bắt đầu từ mẫu nào?

Tư liệu không chỉ định mẫu nào đầu tiên. Nếu muốn học kỹ thuật, bạn có thể bắt đầu từ hai mẫu tối giản Browser Toolset hoặc Computer Toolset, vì README nói chúng có script chạy không cần mô hình. Nếu muốn thử ứng dụng kinh doanh, hãy xem Customer Support Agent hoặc Financial Data Analyst.
