Hướng dẫn từng bước để Claude tự làm việc trên cloud theo lịch, theo lệnh gọi API hoặc theo sự kiện GitHub, kể cả khi bạn đã gập laptop.
Vì sao mình viết bài này
Mỗi sáng mình từng mở terminal, gõ cùng một prompt nhờ Claude Code review các PR mới, tóm tắt issue và nhắn lên Slack. Việc lặp lại đó tốn 10–15 phút mỗi ngày, và hôm nào mình quên thì cả team thiếu thông tin.
Giải pháp là routines của Claude Code: lưu prompt một lần, gắn trigger, và để Claude tự chạy trên hạ tầng cloud của Anthropic. Máy của bạn không cần bật.
Sau bài này bạn sẽ biết cách:
- Thiết lập một cloud environment (mạng, biến môi trường, setup script).
- Tạo routine đầu tiên trên web.
- Gắn ba loại trigger: lịch, API và sự kiện GitHub.
- Theo dõi kết quả và tránh những lỗi hay gặp.
Lưu ý: Routines đang ở giai đoạn research preview, nên giao diện, giới hạn và API có thể thay đổi. Bài viết dựa trên tài liệu chính thức tại thời điểm tháng 11/2026.
Ba khái niệm cần nắm trước
Một routine là một phiên Claude Code chạy trên cloud, bên trong một cloud environment, được khởi động bởi trigger. Hiểu ba lớp này thì mọi bước sau sẽ rất rõ ràng.
| Khái niệm | Nó là gì | Quản lý ở đâu |
|---|---|---|
| Cloud session | Một phiên Claude Code chạy trên máy ảo (VM) do Anthropic quản lý. Repo GitHub được clone vào VM, Claude tự chạy lệnh, test, tạo branch và PR. | claude.ai/code, app Desktop, app mobile, hoặc claude --cloud từ terminal |
| Cloud environment | Cấu hình được lưu lại cho VM: mức truy cập mạng, biến môi trường, setup script. Một environment dùng chung cho mọi nơi bạn mở cloud session, kể cả routines. | Bộ chọn environment dưới ô nhập tin nhắn tại claude.ai/code |
| Routine | Cấu hình Claude Code đã lưu: prompt, một hoặc nhiều repo, environment, connectors và trigger. Mỗi lần trigger kích hoạt sẽ tạo một cloud session mới. | claude.ai/code/routines, app Desktop, hoặc lệnh /schedule trong CLI |
Routine có ba loại trigger, và một routine có thể gắn nhiều trigger cùng lúc:
- Schedule: chạy theo lịch (hàng giờ, hàng ngày, ngày trong tuần, hàng tuần) hoặc chạy một lần vào thời điểm cụ thể.
- API: gọi HTTP POST tới endpoint riêng của routine, kèm bearer token.
- GitHub event: tự chạy khi có pull request hoặc release trên repo.
Ví dụ: một routine review PR có thể chạy mỗi đêm, được gọi từ script deploy, và đồng thời phản ứng với mọi PR mới.
Routines vs. các cách lên lịch khác. Claude Code còn có /loop (chỉ sống trong phiên CLI đang mở) và Desktop scheduled tasks (chạy trên máy bạn, cần máy bật). Routines là lựa chọn duy nhất chạy hoàn toàn trên cloud.
Chuẩn bị
Bạn cần ba thứ: gói đăng ký phù hợp, quyền truy cập GitHub, và (tuỳ chọn) Claude Code CLI.
- Gói đăng ký: Routines có trên các gói Pro, Max, Team và Enterprise, với Claude Code on the web được bật. Với Team/Enterprise, Owner có thể tắt Routines trong Admin settings > Claude Code. Tổ chức bật Zero Data Retention không dùng được cloud session.
-
GitHub: có hai cách cấp quyền.
- Trên web: vào claude.ai/code, làm theo bước onboarding và cài Claude GitHub App cho repo. Nếu muốn dùng trigger GitHub thì bắt buộc phải cài App này.
- Từ terminal: nếu đã dùng GitHub CLI (
gh), chạy/web-setuptrong Claude Code. Lệnh này đồng bộ tokenghvào tài khoản Claude và tạo environment Default nếu bạn chưa có.
-
CLI (tuỳ chọn): để dùng
/schedule, bạn phải đăng nhập bằng tài khoản claude.ai qua/login. Đăng nhập bằng API key của Console, Bedrock hay Vertex sẽ không thấy lệnh này.
# Trong Claude Code CLI
/login
/web-setup
Mẹo:
/web-setupchỉ cấp quyền clone repo. Nó không cài Claude GitHub App và không bật webhook, nên trigger GitHub vẫn cần cài App riêng tại github.com/apps/claude.
[Ảnh chụp màn hình: màn hình onboarding tại claude.ai/code, bước kết nối GitHub]
Bước 1: Thiết lập cloud environment
Environment quyết định routine được truy cập những gì, nên hãy cấu hình nó trước khi tạo routine. Nếu chỉ cần cài package từ npm/PyPI và dùng connectors, environment Default là đủ.
1.1. Mở bộ chọn environment
- Vào claude.ai/code, ở màn hình tạo phiên mới.
- Bấm nút đầu tiên trong hàng dưới ô nhập tin nhắn (nút hình đám mây hiển thị tên environment, ví dụ Default).
- Chọn New environment để tạo mới, hoặc rê chuột lên một environment trong mục Cloud và bấm biểu tượng bánh răng để sửa.
[Ảnh chụp màn hình: menu chọn environment với mục Cloud, Default được tick và nút New environment]
1.2. Điền form
Hộp thoại có bốn phần chính:
| Trường | Ý nghĩa | Gợi ý |
|---|---|---|
| Name | Tên environment | Đặt theo mục đích, ví dụ routine-pr-review
|
| Network access | Mức truy cập internet | Giữ Trusted trừ khi cần gọi domain riêng |
| Environment variables | Biến dạng .env, mỗi dòng KEY=value
|
Không để secret ở đây (xem mục 1.4) |
| Setup script | Script Bash chạy trước khi Claude khởi động | Cài công cụ chưa có sẵn |
[Ảnh chụp màn hình: hộp thoại New environment với 4 trường trên]
1.3. Chọn mức truy cập mạng
| Mức | Kết nối ra ngoài |
|---|---|
| None | Không có |
| Trusted (mặc định) | Chỉ các domain trong allowlist: package registry, GitHub, SDK của cloud provider |
| Full | Mọi domain |
| Custom | Danh sách domain của bạn, có thể kèm danh sách mặc định |
Với Custom, nhập mỗi domain một dòng vào Allowed domains và tick Also include default list of common package managers để vẫn cài được package:
api.example.com
status.mycompany.vn
Dù ở mức nào, GitHub và các MCP connector vẫn hoạt động, vì chúng đi qua đường riêng chứ không qua allowlist. Request tới domain bị chặn sẽ trả về 403 với header x-deny-reason: host_not_allowed, rất tiện để debug.
1.4. Biến môi trường và secret
NODE_ENV=development
LOG_LEVEL=debug
Ai dùng được environment thì đọc được giá trị của biến. Với API key, hãy dùng network secret (trước đây gọi là API credentials): bạn khai báo key kèm các host áp dụng, và proxy của Anthropic tự gắn key vào request. Key không bao giờ nằm trong VM nên Claude dùng được mà không nhìn thấy.
1.5. Setup script và cache
VM chạy Ubuntu 24.04 với quyền root, cài sẵn Python, Node.js 20–22, Ruby, PHP, Java 21, Go, Rust, Docker, PostgreSQL 16, Redis 7 và các công cụ như git, gh, jq, ripgrep. Cần thêm gì thì viết setup script:
#!/bin/bash
apt update && apt install -y shellcheck
pip install --quiet pandas || true
Ba nguyên tắc khi viết script:
-
Exit code phải bằng 0, nếu không session sẽ không khởi động. Thêm
|| truecho lệnh không quan trọng. - Chạy dưới khoảng 5 phút để được cache. Khi được cache, Anthropic lưu snapshot filesystem và các phiên sau bỏ qua bước setup. Cache được xây lại khi bạn sửa script hoặc domain, hoặc sau khoảng 7 ngày.
-
Không dựa vào tiến trình nền: snapshot chỉ giữ file trên đĩa, không giữ database hay
docker compose upđang chạy.
Mỗi VM có khoảng 4 vCPU, 16 GB RAM và 30 GB đĩa. Bấm Add environment để lưu.
Dùng CLI? Chạy
/remote-envđể chọn environment mặc định cho các phiên bạn tạo bằngclaude --cloud.
Bước 2: Tạo routine đầu tiên trên web
Ví dụ xuyên suốt bài: một routine tên Daily PR digest, mỗi sáng ngày làm việc tổng hợp các PR đang mở và gửi lên Slack.
- Vào claude.ai/code/routines và bấm New routine. (Trên app Desktop: tab Code → Routines → New routine → chọn Cloud. Chọn Local sẽ tạo task chạy trên máy bạn.)
- Đặt tên và viết prompt. Đây là phần quan trọng nhất. Routine chạy tự động, không ai trả lời câu hỏi của Claude, nên prompt phải tự đủ và nói rõ thế nào là "xong". Ô prompt có bộ chọn model, dùng cho mọi lần chạy.
-
Chọn repository. Mỗi lần chạy, repo được clone từ branch mặc định. Claude đẩy thay đổi lên các branch có tiền tố
claude/. - Chọn environment đã tạo ở Bước 1 (hoặc Default).
- Chọn trigger trong mục Select a trigger: Schedule, GitHub event hoặc API. Có thể thêm nhiều trigger.
- Rà soát Connectors ở cuối form. Mặc định mọi connector bạn đã kết nối đều được bật. Hãy bỏ những cái không cần, vì trong lúc chạy Claude dùng mọi tool của connector, kể cả thao tác ghi, mà không hỏi.
- Bấm Create, sau đó bấm Run now trên trang chi tiết để chạy thử ngay.
[Ảnh chụp màn hình: form New routine với các mục tên, prompt, repository, environment, Select a trigger và Connectors]
Prompt mẫu cho routine này:
Bạn là trợ lý review cho repo này. Mỗi lần chạy:
1. Dùng `gh pr list --state open` để lấy các PR đang mở.
2. Với mỗi PR: tóm tắt thay đổi trong 1 câu, ghi số ngày đã mở,
và đánh dấu "cần chú ý" nếu CI đang fail hoặc mở quá 3 ngày.
3. Gửi bản tổng hợp lên kênh Slack #dev-daily, PR cần chú ý lên đầu.
4. Không sửa code, không comment vào PR.
Hoàn thành khi tin nhắn đã được gửi. Nếu không có PR nào,
gửi "Không có PR đang mở" thay vì bỏ qua.
Chú ý bước 4 và câu cuối: nói rõ điều không được làm và cách xử lý trường hợp rỗng giúp routine ổn định hơn nhiều.
Bước 3: Chạy theo lịch (Schedule trigger)
Trong Select a trigger, chọn Schedule và một tần suất có sẵn: hourly, daily, weekdays hoặc weekly. Với Daily PR digest, chọn weekdays lúc 8:30.
[Ảnh chụp màn hình: tab Schedule trong Select a trigger, chọn Weekdays và giờ chạy]
Một vài điểm cần biết:
- Múi giờ: bạn nhập giờ theo múi giờ địa phương (ví dụ giờ Việt Nam), hệ thống tự quy đổi. Routine chạy đúng giờ đó dù server đặt ở đâu.
- Độ trễ (stagger): lần chạy có thể bắt đầu trễ vài phút so với giờ đặt. Độ lệch cố định cho mỗi routine, nên đừng dùng routine cho việc cần chính xác từng phút.
- Khoảng cách tối thiểu là 1 giờ. Biểu thức cron chạy dày hơn sẽ bị từ chối.
-
Cron tùy chỉnh (ví dụ mỗi 2 giờ, hoặc ngày 1 hàng tháng): chọn preset gần nhất trên web, rồi chạy
/schedule updatetrong CLI để đặt biểu thức cron cụ thể.
Chạy một lần (one-off)
Muốn Claude làm một việc vào thời điểm cụ thể trong tương lai? Dùng one-off schedule. Sau khi chạy, routine tự tắt và được đánh dấu Ran. Lần chạy one-off không tính vào giới hạn số lần chạy routine mỗi ngày.
Tạo routine từ CLI bằng /schedule
Nếu bạn sống trong terminal, chạy /schedule (alias /routines) trong một phiên Claude Code. Claude sẽ hỏi lần lượt về lịch, repo và prompt, giống form trên web, rồi lưu vào cùng tài khoản. Bạn cũng có thể mô tả luôn:
/schedule daily PR review at 9am
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
Với các lệnh one-off, Claude quy đổi cụm từ thời gian thành mốc cụ thể và xác nhận với bạn trước khi lưu. Các lệnh quản lý khác:
| Lệnh | Tác dụng |
|---|---|
/schedule list |
Liệt kê mọi routine |
/schedule update |
Sửa routine (kể cả đặt cron) |
/schedule run |
Chạy ngay |
/schedule why did my nightly review do nothing this morning? |
Hỏi lịch sử chạy, Claude đọc log và giải thích |
CLI tạo được trigger Schedule và (từ v2.1.225) trigger GitHub. Trigger API và token chỉ tạo được trên web.
Bước 4: Kích hoạt routine qua API
API trigger cho mỗi routine một endpoint HTTP riêng. Bất cứ hệ thống nào gửi được HTTP request đều có thể đánh thức Claude: công cụ cảnh báo, pipeline CI/CD, n8n, Zapier hay một script cron của bạn.
4.1. Tạo URL và token
- Mở routine tại claude.ai/code/routines, bấm biểu tượng bút chì để vào Edit routine.
- Cuộn tới Select a trigger, bấm Add another trigger và chọn API.
- Hộp thoại hiện URL của routine và một lệnh
curlmẫu. Copy URL, bấm Generate token và copy token ngay lập tức: token chỉ hiển thị một lần. - Muốn đổi hoặc thu hồi token, quay lại hộp thoại này và bấm Regenerate hoặc Revoke.
[Ảnh chụp màn hình: hộp thoại API trigger với URL, lệnh curl mẫu và nút Generate token]
Nếu tạo routine mới và chọn API ngay từ đầu, URL và token chỉ xuất hiện sau khi lưu, vì chúng phụ thuộc vào ID của routine.
4.2. Gọi endpoint
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
-H "Authorization: Bearer sk-ant-oat01-xxxxx" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
Thay URL và token bằng giá trị của bạn, nếu không sẽ nhận lỗi 401. Kết quả trả về là link tới phiên vừa được tạo:
{
"type": "routine_fire",
"claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
"claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
Mở claude_code_session_url để xem Claude làm việc theo thời gian thực.
4.3. Truyền dữ liệu vào routine
Trường text trong body là nơi bạn đưa ngữ cảnh riêng cho lần chạy, ví dụ nội dung cảnh báo. Có hai điều nhiều người bỏ lỡ:
-
textlà chuỗi tự do, không được parse. Gửi JSON vào đây thì routine nhận nguyên chuỗi JSON đó. -
textđược bọc trong khối<routine-fire-payload>và bị coi là dữ liệu không tin cậy. Claude sẽ không làm theo chỉ dẫn bên trong, trừ khi prompt đã lưu của routine cho phép. Cơ chế này bảo vệ bạn khi token bị lộ.
Vì vậy, prompt của routine cần nhắc tới payload một cách rõ ràng:
Điều tra cảnh báo được mô tả trong khối routine-fire-payload.
Tìm commit gần đây liên quan, và mở một draft PR sửa lỗi
kèm link tới cảnh báo gốc.
Endpoint
/fiređang dùng beta headerexperimental-cc-routine-2026-04-01và chỉ dành cho người dùng claude.ai. Khi có thay đổi phá vỡ tương thích, Anthropic ra header mới có ngày, và hai phiên bản trước đó vẫn hoạt động để bạn kịp chuyển.
Bước 5: Chạy theo sự kiện GitHub
GitHub trigger tạo một phiên mới mỗi khi có sự kiện khớp trên repo. Mỗi sự kiện là một phiên độc lập: hai lần cập nhật PR sẽ sinh ra hai phiên.
Điều kiện: repo phải cài Claude GitHub App. Giao diện web sẽ nhắc bạn cài nếu thiếu.
- Mở routine, bấm bút chì để vào Edit routine.
- Tại Select a trigger, bấm Add another trigger → GitHub event.
- Chọn repo, chọn sự kiện và thêm bộ lọc nếu cần, rồi lưu.
[Ảnh chụp màn hình: cấu hình GitHub event với repo, sự kiện pull_request.opened và bộ lọc Is draft = false]
Hai nhóm sự kiện được hỗ trợ. Bạn có thể chọn một hành động cụ thể như pull_request.opened hoặc cả nhóm:
| Sự kiện | Kích hoạt khi |
|---|---|
| Pull request | PR được mở, đóng, gán người, gắn nhãn, đồng bộ commit… |
| Release | Release được tạo, publish, sửa hoặc xóa |
Bộ lọc PR gồm: Author, Title, Body, Base branch, Head branch, Labels, Is draft, Is merged. Toán tử: equals, contains, starts with, is one of, is not one of, matches regex. Mọi điều kiện phải cùng khớp.
Vài cách kết hợp hay dùng:
-
Chỉ review PR đã sẵn sàng: Is draft =
false. -
Backport theo nhãn: Labels chứa
needs-backport. -
Review kỹ module auth: Base branch =
main, Head branch containsauth-provider.
Bẫy hay gặp:
matches regexso khớp toàn bộ giá trị. Muốn bắt tiêu đề có chữhotfix, hãy viết.*hotfix.*, hoặc dùngcontainscho đơn giản.
Từ CLI (v2.1.225 trở lên), sau khi đã cài App, bạn có thể gắn trigger bằng câu lệnh tự nhiên:
/schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp
Trong giai đoạn preview, webhook GitHub có giới hạn theo giờ cho từng routine và từng tài khoản. Sự kiện vượt giới hạn sẽ bị bỏ qua cho đến khi sang khung giờ mới.
Theo dõi và quản lý các lần chạy
Bấm vào routine trong danh sách để mở trang chi tiết. Đây là nơi bạn thấy repo, connectors, prompt, lịch, token API, trigger GitHub và lịch sử các lần chạy.
[Ảnh chụp màn hình: trang chi tiết routine với nút Run now, mục Repeats và danh sách các lần chạy]
| Thao tác | Cách làm |
|---|---|
| Chạy ngay | Bấm Run now, có thể kèm text giống trường text của API |
| Tạm dừng lịch | Gạt công tắc trong mục Repeats |
| Sửa | Bấm bút chì để đổi tên, prompt, repo, environment, connectors, trigger |
| Xóa | Bấm biểu tượng thùng rác; các phiên đã chạy vẫn được giữ |
Mỗi lần chạy là một phiên đầy đủ. Mở ra để xem Claude đã làm gì, review thay đổi, tạo PR hoặc tiếp tục trò chuyện thủ công.
Quan trọng: trạng thái xanh chỉ có nghĩa là phiên khởi động và kết thúc không lỗi hạ tầng. Nó không có nghĩa nhiệm vụ đã thành công. Request mạng bị chặn, connector thiếu tool hay lỗi nghiệp vụ chỉ hiện trong transcript. Những tuần đầu, hãy mở vài lần chạy để kiểm tra.
Bảo mật, giới hạn và kinh nghiệm thực tế
Routine hành động với danh nghĩa của bạn
Routine chạy hoàn toàn tự động: không có bộ chọn permission mode và không có hộp thoại xin phép trong lúc chạy. Routine thuộc tài khoản cá nhân, không chia sẻ với đồng nghiệp. Commit, PR, tin nhắn Slack hay ticket Linear do routine tạo đều mang tên bạn.
Nên giới hạn phạm vi ở cả bốn chỗ:
- Repo: chỉ thêm repo routine thực sự cần.
- Mạng: ưu tiên Trusted hoặc Custom, chỉ dùng Full khi không còn cách khác.
- Connectors: bỏ mọi connector không dùng tới.
- Secret: dùng network secret thay vì biến môi trường; lưu token API trong secret store của hệ thống gọi nó.
Về branch: Claude luôn được đẩy lên branch claude/.... Nếu prompt yêu cầu đẩy lên branch khác, lệnh push sẽ bị chặn khi branch đó được bảo vệ, đang có PR của người khác, hoặc chứa commit của người khác.
Giới hạn sử dụng
- Routine tiêu tốn usage của gói đăng ký giống phiên tương tác thông thường.
- Ngoài ra có giới hạn số lần chạy routine mỗi ngày cho mỗi tài khoản. Xem mức còn lại tại claude.ai/code/routines hoặc claude.ai/settings/usage.
- Khi chạm giới hạn, nếu đã bật usage credits thì routine tiếp tục chạy theo hình thức tính phí vượt mức. Nếu chưa, các lần chạy mới bị từ chối cho đến khi sang khung mới.
Các lỗi hay gặp
| Triệu chứng | Nguyên nhân và cách xử lý |
|---|---|
Unknown command: /schedule |
Đang đăng nhập bằng API key, Bedrock/Vertex/Foundry, hoặc đang ở trong một phiên cloud. Gỡ ANTHROPIC_API_KEY, chạy /login với tài khoản claude.ai. |
/schedule yêu cầu xác thực |
CLI chưa có phiên đăng nhập claude.ai. Chạy /login. |
| "Routines are disabled by your organization's policy" | Owner đã tắt Routines trong Admin settings. Nhờ Owner bật lại. |
Lỗi 403, host_not_allowed trong transcript |
Domain không nằm trong allowlist. Chuyển mạng sang Custom và thêm domain. |
| Routine bỏ qua nội dung gửi qua API | Prompt chưa nhắc tới khối routine-fire-payload. |
| Phiên không khởi động được | Setup script trả về exit code khác 0. Thêm `\ |
Kinh nghiệm cá nhân
- Bắt đầu chỉ đọc. Cho routine tóm tắt và báo cáo trước, chỉ cho phép sửa code hay comment khi đã tin tưởng kết quả.
- Luôn Run now trước khi để lịch tự chạy, đọc transcript từ đầu đến cuối.
- Viết prompt như viết runbook: các bước đánh số, điều không được làm, và cách xử lý trường hợp rỗng hoặc lỗi.
- Một routine, một việc. Routine nhỏ dễ debug hơn routine "làm tất cả".
-
Đặt skill và {% raw %}
.mcp.jsontrong repo. Routine dùng được skill đã commit trong repo, và MCP server khai báo trong.mcp.json, nên cả team chia sẻ cùng quy trình.
Top comments (0)