DEV Community

Tommy
Tommy

Posted on

Tự động hóa công việc với Claude: Cloud Environment và Routines

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:

  1. Thiết lập một cloud environment (mạng, biến môi trường, setup script).
  2. Tạo routine đầu tiên trên web.
  3. Gắn ba loại trigger: lịch, API và sự kiện GitHub.
  4. 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-setup trong Claude Code. Lệnh này đồng bộ token gh và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
Enter fullscreen mode Exit fullscreen mode

Mẹo: /web-setup chỉ 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

  1. Vào claude.ai/code, ở màn hình tạo phiên mới.
  2. 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).
  3. 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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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 || true cho 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ằng claude --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.

  1. 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.)
  2. Đặ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.
  3. 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/.
  4. Chọn environment đã tạo ở Bước 1 (hoặc Default).
  5. Chọn trigger trong mục Select a trigger: Schedule, GitHub event hoặc API. Có thể thêm nhiều trigger.
  6. 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.
  7. 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.
Enter fullscreen mode Exit fullscreen mode

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 update trong 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
Enter fullscreen mode Exit fullscreen mode

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

  1. Mở routine tại claude.ai/code/routines, bấm biểu tượng bút chì để vào Edit routine.
  2. Cuộn tới Select a trigger, bấm Add another trigger và chọn API.
  3. Hộp thoại hiện URL của routine và một lệnh curl mẫu. Copy URL, bấm Generate token và copy token ngay lập tức: token chỉ hiển thị một lần.
  4. 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."}'
Enter fullscreen mode Exit fullscreen mode

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"
}
Enter fullscreen mode Exit fullscreen mode

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ỡ:

  • text là 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.
Enter fullscreen mode Exit fullscreen mode

Endpoint /fire đang dùng beta header experimental-cc-routine-2026-04-01 và 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.

  1. Mở routine, bấm bút chì để vào Edit routine.
  2. Tại Select a trigger, bấm Add another trigger → GitHub event.
  3. 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 contains auth-provider.

Bẫy hay gặp: matches regex so khớp toàn bộ giá trị. Muốn bắt tiêu đề có chữ hotfix, hãy viết .*hotfix.*, hoặc dùng contains cho đơ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
Enter fullscreen mode Exit fullscreen mode

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

  1. 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ả.
  2. Luôn Run now trước khi để lịch tự chạy, đọc transcript từ đầu đến cuối.
  3. 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.
  4. Một routine, một việc. Routine nhỏ dễ debug hơn routine "làm tất cả".
  5. Đặt skill và {% raw %}.mcp.json trong 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)