Claude Code Cloud Session: Giao Brief Và Nghiệm Thu Agent

TL;DR: Cloud session cho phép giao một dự án đã có tài liệu rõ cho Claude Code chạy trong máy ảo trên cloud, nối với repo GitHub, đóng laptop vẫn chạy tiếp. Chất lượng không nằm ở việc chọn model nào mà ở brief (bộ tài liệu cùng roadmap có cổng kiểm) và ở cách nghiệm thu bằng bằng chứng kiểm được: lịch sử commit, lệnh validate, bộ test. Bài này ghi lại một lần tôi giao việc như vậy, kể cả những chỗ tôi phải sửa lại cách nói của chính mình.

Tối 02/11/2026, theo bảng hạn mức trên màn hình của tôi, thanh hạn mức tuần của tài khoản Claude đã ở mức 76%, trong khi hôm đó mới là thứ Hai và hạn mức chỉ làm mới vào tối thứ Sáu. Cùng bảng hạn mức đó có thêm một dòng mà tôi ít để ý trước đây: Cloud session credits, còn $90 trên $100, hết hạn lúc 14:59 ngày 05/11 (giờ GMT+7).

Tôi quyết định dùng khoản đó cho một việc có thật: xây một nền tảng thư viện Prompt, Skill, Bot và Workflow cho bản thân và team, giao cho Claude Code chạy bằng Claude Code Cloud session. Bài này kể lại cách tôi viết brief, agent giao ra những gì, tôi nghiệm thu ra sao, cùng hai chỗ cần đính chính: một chỗ tôi đã sửa ngay trong video, một chỗ tôi chỉ nhận ra khi đọc lại lịch sử commit.

Nếu anh em chưa quen cách tôi chia việc theo ca để không chạm trần hạn mức giữa tuần, nên đọc bài đó trước vì phần nền của bài này nằm ở đó.

Nguồn số liệu trong bài: mọi con số đến từ ba nơi: (1) hai ảnh chụp bảng hạn mức trên tài khoản Claude gói Pro của tôi, (2) lịch sử commit (git log) của repo dự án, (3) kết quả các lệnh kiểm tra tôi chạy lại trên máy ngày 03/11/2026. Thông tin về cách Cloud session hoạt động lấy từ tài liệu chính thức của Claude Code mà tôi đã đọc ngày 03/11/2026.

Cloud session là gì và khác gì chạy Claude Code trên máy?

Trả lời ngắn: Cloud session là một phiên Claude Code chạy trong máy ảo cô lập trên hạ tầng do Anthropic quản lý thay vì trên máy của bạn. Phiên vẫn chạy sau khi bạn đóng laptop, và bạn theo dõi hoặc chỉnh hướng từ trình duyệt, ứng dụng điện thoại hoặc terminal.

Theo tài liệu chính thức, Cloud session dùng được trên các gói Pro, Max, Ultra và Team (cùng một số ghế Enterprise), và cần kết nối GitHub để clone mã nguồn rồi đẩy nhánh về. Có hai điểm khác biệt đáng nhớ so với chạy trên máy.

Chi tiết quan trọng với người mới: trong trường hợp thông thường, máy ảo clone repo từ GitHub, không đọc thư mục trên máy bạn. Tài liệu hướng dẫn rõ rằng nếu có commit chưa đẩy lên remote thì phải push trước khi bắt đầu. Với dự án của tôi, điều này có nghĩa là bộ tài liệu brief phải nằm sẵn trong repo trước khi bấm chạy.

Vì sao tôi dùng Cloud session khi hạn mức tuần đã gần cạn?

Trả lời ngắn: Vì tôi có một việc đã đủ rõ để giao đi và một khoản credit có hạn dùng ngắn. Việc cần tiêu trước ngày hết hạn, và việc giao đi thì tôi không phải ngồi canh từng bước.

Tôi ghi lại hai lần đọc bảng hạn mức, cách nhau một đêm:

Nguồn: hai ảnh chụp bảng hạn mức trên tài khoản của tôi. Hạn dùng ghi trên bảng: 14:59 ngày 05/11/2026 (GMT+7). Tôi đã dùng $10 trước lần đọc đầu tiên, khi thử tính năng này.

Chênh lệch giữa hai lần đọc là $51. Trong video tôi từng nhẩm nhầm thành 41 rồi tự sửa lại ngay trên hình; con số đúng là 90 trừ 39.

Có một điều cần nói thẳng. Tài liệu chính thức mô tả Cloud session dùng chung hạn mức với phần còn lại của tài khoản và không nhắc đến dòng "Cloud session credits". Tôi chỉ mô tả đúng thứ bảng hạn mức trên tài khoản của tôi hiển thị. Tôi chưa biết bao nhiêu tài khoản khác có dòng này, và hai lần đọc của tôi (theo hai ảnh chụp ở trên, thanh tuần nhích từ 76% lên 78% trong khi credit giảm $51) chưa đủ để suy ra cách hệ thống tính. Anh em mở bảng hạn mức của mình để xem có gì khác không.

Một brief đủ tốt để agent tự chạy nhiều milestone trông thế nào?

Trả lời ngắn: Một bộ tài liệu có vai trò rõ ràng cộng một prompt giao việc có vai trò, nhiệm vụ đánh số, ngưỡng tối thiểu và cổng kiểm đo được. Agent không đoán ý bạn; nó đọc những gì bạn đã viết ra.

Tôi không viết một prompt dài. Tôi đưa vào repo bốn tài liệu, mỗi tài liệu trả lời một câu hỏi khác nhau:

Prompt giao việc chỉ còn là một bản tóm lược trỏ vào bốn tài liệu đó. Đây là khung tôi dùng, đã thay phần riêng của dự án bằng ngoặc vuông để anh em áp dụng:

Vai trò: Bạn là [vai trò kỹ sư] của [tên dự án].
Repo đã có sẵn các tài liệu chuẩn:
- CLAUDE.md: chỉ thị kỹ thuật, coding style, tiêu chuẩn bàn giao.
- docs/POD.md: tầm nhìn sản phẩm, personas, mô hình phân tầng.
- docs/SPEC.md: đặc tả kỹ thuật và interface.
- docs/ROADMAP_TASKS.md: danh sách [N] milestone.

Nhiệm vụ: tự chủ thực thi từ Milestone 1 đến Milestone [N] đúng thứ tự trong ROADMAP_TASKS.md.
1. Dựng khung ứng dụng với công nghệ [stack].
2. [Tính năng lõi thứ nhất].
3. [Tính năng lõi thứ hai].
4. Nạp dữ liệu khởi tạo với ngưỡng tối thiểu: [số lượng từng loại].
5. Đảm bảo lệnh typecheck và build đạt 0 lỗi.
6. Commit lên nhánh và tạo Pull Request tổng kết.
Hãy đọc CLAUDE.md và docs/ROADMAP_TASKS.md để bắt đầu từ Milestone 1.

Trong prompt thật của tôi có bảy nhiệm vụ, và hai chi tiết nằm ở đó: ngưỡng tối thiểu (ít nhất 25 prompt, 10 skill, 5 boost cho dữ liệu khởi tạo) và cổng kiểm (npx tsc --noEmit cùng npm run build phải đạt 0 lỗi). Có ngưỡng và cổng thì tôi mới có thứ để nghiệm thu, thay vì phải tin vào câu "đã xong" của agent.

Tài liệu của Claude Code cũng gợi ý đúng cách làm này: lập kế hoạch ở máy, lưu kế hoạch vào repo, commit và push để máy ảo clone được, rồi mới giao cho Cloud session thực thi. Các quy tắc trong CLAUDE.md của dự án (kiểu dữ liệu chặt, không để mã giữ chỗ, không đưa khoá bí mật vào file) chính là những cổng kiểm mà agent phải tự giữ.

Nghiệm thu thế nào khi agent làm xong, và phần nào thật sự do agent tạo ra?

Trả lời ngắn: Nghiệm thu bằng bằng chứng kiểm được (lịch sử commit, lệnh validate, bộ test), rồi tách rạch ròi phần agent viết với phần tôi nhập từ kho có sẵn. Khi tách ra, câu chuyện khác với cách tôi kể trong video.

Lịch sử commit cho thấy bốn đợt, không phải một đêm

Giờ dưới đây theo múi giờ Việt Nam, lấy từ git log của repo:

Hai điều rút ra từ bảng này. Một: đợt đầu tiên hoàn tất trước khi tôi đi ngủ, theo mốc commit chỉ khoảng nửa giờ sau bản khởi tạo. Hai: từ 21:45 tối đến 06:33 sáng hôm sau, repo không có commit nào. Cái tôi gọi là "ca đêm" trong video thực ra là khoảng thời gian giữa hai lần tôi đọc bảng hạn mức, còn công việc của các đợt V2 đến V4 diễn ra vào buổi sáng. Tôi cũng không có số liệu chi phí theo từng phiên, nên không thể gán khoản $51 cho đợt nào.

Những lệnh kiểm tra tôi chạy lại

Sau khi gộp đợt cuối, tôi chạy lại ba lệnh trong thư mục dự án:

npm run validate
  files scanned : 525
  prompts       : 139
  skills        : 57
  boosts        : 7  (shown as Prompts > Deep Reasoning)
  workflows     : 5
  bots          : 317
  All content items conform to the schema.

npm test
  tests 52 | pass 52 | fail 0

npx tsc --noEmit
  (không có lỗi)

Trên giao diện, bảy mục Deep Reasoning được gộp vào nhóm Prompt, nên màn hình hiển thị 146 prompt thay vì 139. Tôi chưa chạy lại npm run build ở bước này, nên không khẳng định gì về nó.

525 tài sản đến từ đâu?

Đây là phần tôi muốn nói rõ nhất, vì trong video tôi trình bày con số 525 dễ khiến người xem hiểu rằng agent tạo ra toàn bộ.

Cộng lại: 72 tài sản do agent viết mới và 453 tài sản có sẵn được chuẩn hóa, tổng cộng 525. Vì vậy phép chia $51 cho 525 tài sản mà tôi đưa lên hình trong video (khoảng $0,10 mỗi món) dễ gây hiểu nhầm, anh em đừng dùng nó làm đơn giá. Phần giá trị agent thật sự giao ra là nền tảng chạy được và việc chuẩn hóa vào một schema có cổng kiểm: ứng dụng, bàn làm việc điền biến, xuất sang nhiều đích, tìm kiếm, máy chủ MCP, giao diện song ngữ.

Nền tảng thư viện này dùng được vào việc gì cho doanh nghiệp nhỏ?

Trả lời ngắn: Nó là một thư viện chia bốn nhóm Prompt, Skill, Bot, Workflow, trong đó mỗi mục là một file thường, điền biến và xem trước ngay, rồi copy hoặc xuất sang đúng công cụ bạn đang dùng. Mục tiêu là rút ngắn thời gian từ lúc tìm đến lúc dùng.

Cách dùng nhanh một prompt có biến, theo thiết kế của ứng dụng:

1. Chọn prompt, hoặc bấm Cmd/Ctrl+K để tìm trên cả bốn nhóm.
2. Điền các biến {{TEN_BIEN}} vào form có sẵn ví dụ.
3. Xem bản xem trước, ô nào còn trống được đánh dấu.
4. Copy cho ChatGPT hoặc Claude, copy dạng quy tắc cho Cursor, hoặc xuất ra file SKILL.md để dùng với Claude Code.

Mục Workflows còn xuất được JSON cho n8n và script Python, và ứng dụng có một máy chủ MCP chỉ đọc với năm công cụ để các môi trường như Claude Code hoặc Cursor tra cứu thư viện.

Tình trạng hiện tại, nói đúng như nó đang là: ứng dụng đang chạy trên máy của tôi; mã nguồn mở theo giấy phép MIT nằm trên GitHub; bản web chưa có tên miền nên chưa có đường dẫn công khai để dùng. Trong lúc chờ, phần lớn tinh thần của nó đã có thể dùng ngay ở kho prompt trên toilatung.com và Workflow Vault, nơi 107 prompt kia xuất phát.

Checklist trước khi giao một dự án cho Cloud session

• Repo đã nằm trên GitHub và đã kết nối với tài khoản Claude của bạn.
• Toàn bộ tài liệu brief đã được commit và push, vì máy ảo clone từ remote chứ không đọc máy bạn.
• CLAUDE.md ghi rõ tiêu chuẩn bàn giao và các lệnh kiểm tra bắt buộc.
• Roadmap chia milestone, mỗi milestone có tiêu chí xong đo được.
• Ngưỡng tối thiểu (số lượng, tính năng) được viết thẳng trong prompt giao việc.
• Cổng kiểm typecheck, build, validate và test phải đạt 0 lỗi trước khi agent báo xong.
• Không có khoá API hay mật khẩu trong repo, trong prompt hoặc trong dữ liệu mẫu.
• Bạn biết sẽ nghiệm thu bằng gì (diff, lịch sử commit, lệnh kiểm tra) và ai là người bấm gộp.
• Đã chụp bảng hạn mức trước và sau để tự đối chiếu chi phí.

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

Cloud session có tính vào hạn mức tuần không?

Tài liệu chính thức của Claude Code ghi rằng Cloud session tính vào hạn mức sử dụng của gói, cùng với phần còn lại của tài khoản, và chạy nhiều tác vụ song song sẽ tiêu hạn mức tương ứng. Bảng hạn mức của tôi còn hiển thị thêm "Cloud session credits" mà tài liệu không nhắc tới. Hai lần đọc của tôi chưa đủ để kết luận cách tính, nên hãy tự kiểm bảng của bạn.

Tài khoản nào cũng có Cloud session credits không?

Tôi chỉ biết tài khoản gói Pro của tôi có dòng này, kèm hạn dùng ngắn. Tôi không khẳng định tài khoản khác cũng có. Cách kiểm tra là mở bảng hạn mức trong Claude Code và xem có dòng đó hay không.

Đóng máy rồi agent có chạy tiếp không?

Theo tài liệu, phiên tiếp tục chạy sau khi bạn đóng laptop và bạn xem lại được từ thiết bị khác. Tuy vậy môi trường có thể hết hạn sau một thời gian không hoạt động. Mở lại phiên từ claude.ai/code sẽ cấp một máy ảo mới: lịch sử hội thoại được khôi phục nhưng tác vụ đang chạy dở thì không.

Có cần biết lập trình mới giao được dự án như vậy không?

Theo trải nghiệm của tôi, không cần tự viết mã nhưng cần đủ khả năng nghiệm thu: đọc được lịch sử commit, chạy được các lệnh kiểm tra, và nhìn ra khi nào "đã xong" chưa có bằng chứng. Nếu chưa làm được, hãy đặt cổng kiểm tự động trong brief để máy tự báo lỗi thay bạn.

Thư viện Prompt, Skill, Bot, Workflow đã dùng được công khai chưa?

Mã nguồn đã mở trên GitHub, còn bản web chưa có tên miền nên chưa có đường dẫn để dùng trực tiếp. Kho prompt trên toilatung.com và Workflow Vault dùng được ngay.

Kết luận

Cloud session không thay thế việc nghĩ kỹ trước khi giao. Phần lớn công việc của tôi nằm ở bốn tài liệu, các ngưỡng tối thiểu và cổng kiểm, còn việc agent viết mã chỉ là phần còn lại. Đọc kỹ lịch sử commit sau đó cho tôi một bài học khác, về cách kể: số liệu thật nhưng cách gom chúng lại dễ khiến người xem hiểu sai. Tôi ghi cả chỗ đó vào đây để lần sau, và cả anh em, đều có thứ để đối chiếu.

Mang về dùng ngay: khung brief ở trên, checklist chín dòng, và kho prompt trên toilatung.com cùng Workflow Vault để bắt đầu từ những tài sản đã có sẵn.

Muốn nghĩ xa hơn về việc hệ thống nhiều lớp giải phóng hay thành gánh nặng bảo trì với một người vận hành, tôi đã viết riêng một bài: khi nào kiến trúc AI nhiều lớp giải phóng founder và khi nào thành gánh nặng.

Bài viết thuộc chuỗi Proof of Work của Tôi Là Tùng. Video gốc: YouTube @toilatungAI.