Đúng vậy, GitHub hoàn toàn miễn phí: gói GitHub Free cung cấp không giới hạn repository công khai và riêng tư, không giới hạn số lượng cộng tác viên cùng 2.000 phút chạy GitHub Actions mỗi tháng. Các AI agent cũng hoàn toàn có thể tận dụng gói này. Tài liệu chính thức của GitHub cho biết MCP server của họ “khả dụng cho tất cả người dùng GitHub bất kể loại gói dịch vụ,” do đó Claude Code, Codex hay OpenCode đều có thể đọc issue, mở pull request và kiểm tra trạng thái workflow run mà không cần tài khoản GitHub trả phí. Khoản chi phí duy nhất bạn có thể phải chi trả là mô hình AI cho agent, nhưng vẫn có phương án giúp bạn giữ mức phí đó ở mức 0 USD.
TL;DR
Kết nối MCP server chính thức của GitHub với coding agent của bạn bằng fine-grained personal access token. Với gói GitHub Free, những giới hạn quan trọng cần lưu ý gồm số phút Actions trên repo riêng tư, giới hạn tần suất gọi API (REST rate limit) và một số ít tính năng cộng tác chỉ dành riêng cho repo công khai. Chi phí thực sự nằm ở phía agent: Claude Code và Codex yêu cầu gói trả phí hoặc API credit, trong khi OpenCode hiện hỗ trợ một số mô hình miễn phí. Khi các agent bắt tay vào xử lý công việc thực tế, tính năng tích hợp GitHub của Sharkly sẽ chuyển các issue mới thành Task để bạn giao việc trực tiếp cho Agent.
| Hạng mục | Miễn phí? | Hạn mức | Chi phí khi vượt hạn mức |
|---|---|---|---|
| GitHub Free | Có | 2.000 phút Actions/tháng cho repo riêng tư (repo công khai miễn phí); 500 MB dung lượng lưu trữ Packages | Gói GitHub trả phí hoặc mua thêm phút theo mức sử dụng |
| GitHub MCP server | Có, áp dụng cho mọi gói | Hạn mức REST của token: 5.000 request/giờ | Các công cụ gắn liền với tính năng trả phí yêu cầu gói đăng ký tương ứng |
| Copilot Free | Có | 2.000 gợi ý code (completions)/tháng, hạn mức AI Credit không công bố cụ thể, không có cloud agent | Gói Copilot Pro trở lên |
| Agent: Mô hình OpenCode miễn phí | Có, ở thời điểm hiện tại | Các mô hình ưu đãi thử nghiệm, có thời hạn | Gói OpenCode Zen hoặc Go |
| Agent: Claude Code / Codex | Không | Yêu cầu gói đăng ký hoặc API key | Gói tài khoản Claude, ChatGPT hoặc trả theo token |
| Sharkly board | Hiện đang miễn phí | Tổ chức có quy mô tối đa 5 người | 7 USD/người/tháng, thanh toán theo năm |
Gói GitHub Free: Những giới hạn quan trọng đối với AI agent
GitHub Free khá thoải mái về dung lượng lưu trữ và số lượng thành viên, nhưng lại siết chặt hơn ở những tác vụ mà agent thường xuyên khai thác.
Số phút Actions. Trang bảng giá liệt kê hạn mức 2.000 phút mỗi tháng, và Actions được “Miễn phí cho các repository công khai.” Mỗi khi agent mở pull request, hệ thống CI sẽ được kích hoạt sau từng lần push. Nếu mỗi ngày agent tạo 10 PR, mỗi PR chạy bộ test kéo dài 6 phút và được push 2 lần, bạn sẽ tiêu tốn khoảng 3.600 phút mỗi tháng. Do đó, trên các repo riêng tư, hạn mức thời gian chạy Actions có thể nhanh chóng trở thành rào cản đầu tiên. Hãy tối ưu để CI chạy thật nhanh, hoặc hủy các lượt chạy cũ không còn cần thiết bằng nhóm concurrency trong workflow.
Giới hạn tần suất gọi API (Rate limits). Mỗi lệnh gọi công cụ MCP đều chuyển thành một lệnh gọi GitHub API thực hiện thông qua token của bạn. Theo tài liệu về REST rate limit của GitHub, mỗi personal token có hạn mức 5.000 request/giờ, đi kèm các giới hạn phụ như khoảng 80 request tạo nội dung mỗi phút. Một agent riêng lẻ hiếm khi chạm đến các ngưỡng này, nhưng nếu nhiều agent dùng chung một token thì hoàn toàn có thể.
Các tính năng chỉ dành cho repo công khai. Ở gói Free, các tính năng như code owner, draft pull request và quy tắc bảo vệ môi trường (environment protection rules) chỉ áp dụng cho repository công khai. Nếu bạn muốn agent mở draft PR trên repo riêng tư, đó là tính năng bắt buộc phải nâng cấp lên gói trả phí.
Copilot Free. Gói này bao gồm tối đa 2.000 gợi ý code mỗi tháng, chế độ agent và hỗ trợ MCP ngay trong trình biên tập mã (editor). Tuy nhiên, trang so sánh các gói nêu rõ Copilot cloud agent không được đi kèm, và hạn mức AI Credit cũng không được công bố con số cụ thể. Hãy xem Copilot Free như một trợ lý viết code trong editor, thay vì một đồng đội có thể giao issue độc lập.
Bản thân MCP server. Tài liệu hướng dẫn thiết lập MCP của GitHub lưu ý thêm một ranh giới: “Nếu một tính năng yêu cầu giấy phép GitHub hoặc Copilot trả phí, công cụ MCP tương ứng cũng sẽ yêu cầu gói đăng ký tương đương.” Các công cụ thao tác với Issue, pull request, repository và Actions log đều hoạt động bình thường trên gói Free; riêng những công cụ điều khiển Copilot cloud agent thì không.
Kết nối GitHub với Claude Code, Codex hoặc OpenCode
Repository github-mcp-server hướng dẫn hai cách vận hành: sử dụng hosted endpoint của GitHub tại https://api.githubcopilot.com/mcp/ hoặc chạy Docker image cục bộ. Hosted endpoint không yêu cầu cài đặt thêm gì, vì vậy bạn nên bắt đầu từ lựa chọn này.
1. Tạo fine-grained personal access token. Chỉ cấp quyền truy cập vào đúng các repository mà agent cần thao tác, với quyền đọc và ghi (read/write) cho Issues và Pull requests, cùng quyền đọc (read) cho Contents và Actions. Dù tài liệu hướng dẫn của GitHub có đề cập đến phạm vi (scope) repo cổ điển, nhưng việc dùng token dạng fine-grained giới hạn trong một vài repository cụ thể sẽ an toàn hơn nhiều cho agent.
2a. Claude Code. Từ terminal thông thường, theo hướng dẫn về Claude của GitHub:
claude mcp add --transport http github https://api.githubcopilot.com/mcp \
-H "Authorization: Bearer YOUR_GITHUB_PAT"
Sau đó chạy claude mcp list và xác nhận github đã được kết nối.
2b. Codex. Hướng dẫn về Codex của GitHub đọc token từ biến môi trường, giúp tránh lưu lộ thông tin vào file cấu hình:
export GITHUB_PAT_TOKEN=your_token
codex mcp add github --url https://api.githubcopilot.com/mcp/ \
--bearer-token-env-var GITHUB_PAT_TOKEN
Gõ /mcp bên trong Codex để xem danh sách công cụ khả dụng.
2c. OpenCode. Thêm đoạn sau vào file opencode.json tại thư mục gốc của dự án, theo hướng dẫn về OpenCode của GitHub:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"github": {
"type": "remote",
"url": "https://api.githubcopilot.com/mcp/",
"enabled": true,
"oauth": false,
"headers": {
"Authorization": "Bearer {env:GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}
Cú pháp {env:...} giúp lưu giữ token an toàn trong biến môi trường shell, thay vì ghi trực tiếp vào file có nguy cơ bị commit lên repository.
3. Tinh gọn bộ công cụ (toolsets). Bộ công cụ mặc định gồm có context, repos, issues, pull_requests và users. Càng ít công cụ thì lượng context tiêu tốn để mô tả công cụ càng giảm. Phiên bản local server còn hỗ trợ cờ --read-only, một lựa chọn khởi đầu hợp lý cho agent chỉ làm nhiệm vụ phân loại (triage) issue.
4. Thử nghiệm với một yêu cầu nhỏ. Câu lệnh “Liệt kê các issue đang mở có gắn nhãn bug trong repo này và tóm tắt 3 issue cũ nhất” là cách đơn giản để kiểm tra toàn bộ token, server và agent chỉ bằng một prompt duy nhất.
Giải pháp 0 USD hoàn toàn miễn phí
Dưới đây là sự kết hợp hoàn toàn không tốn chi phí ở thời điểm hiện tại: gói GitHub Free, hosted MCP server kết hợp với fine-grained token, và OpenCode chạy trên một trong các mô hình miễn phí của nền tảng này.
Gói miễn phí của OpenCode không yêu cầu đăng nhập hay API key. Chúng tôi đã thử nghiệm vào ngày 16 tháng 10 năm 2026 (OpenCode 1.19.2 qua npx opencode-ai@latest): một tác vụ viết mã và thực thi hoàn tất trong 32 giây với mô hình opencode/deepseek-v4.1-flash-free. Tài liệu OpenCode Zen liệt kê mô hình này hiện đang miễn phí cùng với glm-5.3-flash-free và một số lựa chọn khác, đồng thời xác nhận nhà cung cấp cam kết không lưu trữ dữ liệu (zero retention) và không dùng dữ liệu của bạn để huấn luyện. Tuy nhiên, các mô hình miễn phí khác trong cùng danh sách có thể thu thập dữ liệu của bạn, vì vậy hãy đọc kỹ lưu ý trước khi chỉ định chúng làm việc trên repo riêng tư.
Những giới hạn thực tế cần lưu ý:
- Mô hình miễn phí thực chất là chương trình ưu đãi. Zen ghi rõ hầu hết các mô hình này chỉ miễn phí “trong thời gian có hạn”. Hãy chuẩn bị sẵn phương án dự phòng khi mô hình bạn dùng ngừng cung cấp.
- Gói miễn phí chỉ phục vụ riêng cho OpenCode. Nếu gọi cùng endpoint đó từ script bên ngoài, hệ thống sẽ trả về mã lỗi HTTP 403
FreeTierError. - Số phút Actions vẫn bị tính. Agent hoàn toàn miễn phí, nhưng CI mà agent kích hoạt trên repo riêng tư thì không vô hạn.
- Claude Code và Codex không nằm trong phương án này. Claude Code yêu cầu gói Claude trả phí hoặc API credit; Codex yêu cầu gói ChatGPT hoặc OpenAI API key.
Từ giao tiếp qua chat đến giao việc tự động
Gõ lệnh “sửa issue #142” vào terminal có thể phù hợp với một cá nhân làm việc độc lập. Nhưng với một đội ngũ, bước tiến thực sự hiệu quả là giao trực tiếp issue cho agent và nhận kết quả trả về ngay tại nơi mọi người đều có thể theo dõi.
Sharkly cung cấp giải pháp tích hợp GitHub chuyên sâu cho quy trình này, được mô tả chi tiết trong tài liệu tích hợp GitHub:
- Chuyển Issue thành Task. Owner hoặc Admin của Organization cài đặt GitHub App và chọn các repository cần dùng. Khi liên kết một repository với một Space, các issue mới tạo sẽ tự động đồng bộ thành các Task. Những issue cũ tạo trước đó sẽ không được nhập vào. Luồng đồng bộ một chiều sẽ chuyển dữ liệu từ GitHub sang Sharkly; ngoài ra, mỗi Space cũng có thể liên kết hai chiều với một repository.
- Liên kết ngược với Pull Request. Chỉ cần gắn Task ID vào tên nhánh, tiêu đề PR hoặc nội dung mô tả PR, Sharkly sẽ tự động liên kết PR đó với Task tương ứng. Việc merge PR không làm thay đổi trạng thái của Task, nhưng việc đóng hoặc mở lại issue được đồng bộ thì có thể.
- Giao Task cho Agent. Agent sẽ chạy Claude Code, Codex hoặc OpenCode trực tiếp trên Computer của riêng bạn, với mỗi Task nằm trong một git worktree hoàn toàn cô lập, sau đó tiến độ và kết quả sẽ được phản hồi ngược lại vào Task.
Một điểm giới hạn quan trọng cần lưu ý: GitHub App không cấp quyền clone mã nguồn cho Agent. Thao tác clone vẫn sử dụng SSH key hoặc thông tin xác thực HTTPS của Computer, vốn được cấu hình dưới dạng repository trên Agent hoặc Space.
Vậy còn MCP server trong một phiên chạy của Sharkly thì sao? Tài liệu của Sharkly không đề cập đến MCP. Suy luận của chúng tôi: Agent sẽ trực tiếp khởi chạy agent CLI trong worktree của repository, vì vậy file cấu hình phạm vi dự án .mcp.json được commit vào repo (hoặc cấu hình người dùng trên Computer đó) sẽ được nạp khi thực thi. Hãy chạy thử nghiệm (smoke test) với một Task nhỏ trước khi đưa vào vận hành chính thức. Bài viết Cách giao GitHub issue cho AI agent hướng dẫn chi tiết quy trình này, và bài Giải mã GitHub Agent HQ sẽ phân tích góc nhìn của chính GitHub về việc phân chia công việc cho agent.
Bảng quản lý công việc này hiện miễn phí cho các tổ chức có quy mô tối đa 5 người, Agent và Computer không tính vào số lượng seat người dùng, còn chi phí mô hình AI sẽ được tính vào gói đăng ký hoặc API key của chính bạn. Toàn bộ ngữ cảnh, tiến độ, vướng mắc phát sinh, kết quả và quy trình đánh giá của con người đều được quản lý tập trung tại một nơi duy nhất từ lúc mở issue cho đến khi merge mã nguồn.
Những cạm bẫy cần lưu ý
- Dùng chung một token đồng nghĩa với việc chia sẻ rate limit. Hãy cấp cho mỗi agent một fine-grained token riêng biệt để tránh tình trạng một agent hoạt động quá tải làm nghẽn các agent còn lại.
- Tuyệt đối không lưu token dưới dạng văn bản thô (plain text) trong
.mcp.json. Claude Code hỗ trợ nội suy${VAR}trong header của.mcp.json, vì vậy bạn chỉ nên commit tên biến môi trường và lưu giữ giá trị thực tế trên chính Computer. - Draft PR trên repo riêng tư yêu cầu gói trả phí. Với gói Free, hãy hướng dẫn agent mở PR thông thường kèm tiền tố “WIP” ở tiêu đề thay thế.
- Mỗi lượt push của agent đều làm hao hụt số phút Actions. Hãy thêm nhóm
concurrencykèm thuộc tínhcancel-in-progress: trueđể tự động hủy các lượt chạy không còn cần thiết. - Các công cụ cho Copilot cloud agent sẽ báo lỗi trên gói Free. Đây là quy định bắt buộc phải có license trả phí, chứ không phải do token bị hỏng hay cấu hình sai.
Câu hỏi thường gặp
GitHub có miễn phí không? Có. Gói GitHub Free bao gồm không giới hạn repository công khai và riêng tư, không giới hạn số lượng cộng tác viên, 2.000 phút chạy Actions mỗi tháng cho repo riêng tư và 500 MB dung lượng lưu trữ Packages.
GitHub MCP server có miễn phí không? Có. GitHub tuyên bố công cụ này khả dụng cho mọi người dùng bất kể loại gói dịch vụ. Tuy nhiên, các công cụ gắn liền với tính năng trả phí, chẳng hạn như Copilot cloud agent, sẽ yêu cầu gói đăng ký tương ứng.
Gói GitHub Free thiếu những tính năng gì đối với AI agent? Không có số phút Actions không giới hạn trên repo riêng tư, không hỗ trợ draft pull request và code owner trên repo riêng tư, đồng thời không bao gồm Copilot cloud agent.
Tôi có thể chạy một coding agent trên GitHub với chi phí 0 USD không? Hoàn toàn có thể, bằng cách kết hợp OpenCode chạy mô hình miễn phí với gói GitHub Free và hosted MCP server. Các mô hình miễn phí này chỉ mang tính ưu đãi có thời hạn, nên bạn cần chuẩn bị tinh thần chuyển đổi khi cần. Để tìm hiểu các phương án chi phí giữa các mô hình khác nhau, hãy tham khảo bài viết chi phí vận hành một nhóm agent trên các gói miễn phí và giá rẻ, và để quản lý luồng công việc của nhiều agent một cách ngăn nắp, hãy đọc thêm bài quản lý dự án dành cho Claude Code.
