# Chạy Claude Code tự động mỗi ngày: chế độ không giao diện, GitHub Actions và lịch hẹn

URL: https://opcaios.org/blog/chay-claude-code-tu-dong-moi-ngay
Ngày: 2026-11-19
Cập nhật: 2026-11-04
Tác giả: Lê Quốc Nghĩa
Chuyên mục: Hướng dẫn

Chạy [Claude Code](/tien-ich/claude-code) tự động là gì? Chạy Claude Code tự động là cho tác tử lập trình Claude Code làm một việc định sẵn mà không cần người ngồi gõ lệnh: một tập lệnh gọi `claude -p` ở chế độ không tương tác, một quy trình GitHub Actions chạy khi có bình luận `@claude` hoặc theo giờ, hay một tác vụ hẹn giờ chạy trên đám mây hoặc trên ứng dụng desktop. Bài này không hứa Claude Code sẽ "tự làm việc thay bạn" một cách an toàn; mọi lần chạy không người đều có thể sai, tốn tiền hoặc làm nhiều hơn mức bạn muốn, nên thiết kế đúng là để máy soạn nháp và người duyệt trước khi đăng hay merge. OPCAIOS cũng chưa chạy Claude Code qua GitHub Actions; phần đó được viết theo tài liệu chính thức, không phải kinh nghiệm. Bài trình bày cờ `-p`, Claude Code GitHub Actions, các cách hẹn lịch, giới hạn quyền và một quy trình giả định soạn nháp mỗi sáng.

![Sơ đồ chạy Claude Code tự động mỗi ngày: lịch hẹn (cron máy, GitHub Actions schedule hoặc tác vụ hẹn giờ trên đám mây) kích hoạt claude -p với quyền tối thiểu, Claude Code soạn bản nháp trên nhánh riêng, người duyệt diff rồi mới đăng hoặc merge](https://opcaios.org/images/blog/chay-claude-code-tu-dong-moi-ngay/so-do.webp)
*Lịch hẹn chỉ kích hoạt, quyền tối thiểu giới hạn việc làm, người duyệt là cửa cuối. Sơ đồ: OPCAIOS.*

Chưa quen công cụ này thì đọc trước [Claude Code là gì](/blog/claude-code-la-gi).

## Chế độ không giao diện của Claude Code là gì?

Chế độ không giao diện (headless, không tương tác) là cách chạy Claude Code bằng cờ `-p` (hoặc `--print`): bạn đưa lời nhắc ngay trên dòng lệnh, Claude Code làm xong, in kết quả rồi thoát, không mở khung chat. Theo trang "Run Claude Code programmatically" trên code.claude.com/docs (đọc ngày 03/11/2026), lệnh thoát với mã 0 khi thành công và mã khác 0 khi thất bại, nên tập lệnh có thể rẽ nhánh theo mã thoát. Lệnh cũng nhận dữ liệu đẩy vào qua đầu vào chuẩn, tối đa 10MB. Tài liệu khuyên thêm cờ `--bare` khi chạy trong CI hay tập lệnh: Claude Code bỏ qua việc tự nạp hook, skill, subagent, plugin, MCP server, bộ nhớ tự động và CLAUDE.md, để kết quả giống nhau trên mọi máy. Điểm cần biết: chế độ `--bare` không đọc thông tin đăng nhập gói đăng ký, nên phải đặt biến `ANTHROPIC_API_KEY` bằng khoá tạo trong Claude Console.

```bash
claude -p "What does the auth module do?"
claude --bare -p "Summarize README.md" --allowedTools "Read"
```

## Chọn kiểu đầu ra nào khi chạy bằng tập lệnh?

Kiểu đầu ra được chọn bằng `--output-format`, và tài liệu chính thức liệt kê 3 giá trị:

1. **`text`** (mặc định): văn bản thường, hợp khi chỉ cần ghi kết quả ra file.
2. **`json`**: một khối JSON có trường `result` chứa câu trả lời, mã phiên và siêu dữ liệu; tài liệu ghi khối này có `total_cost_usd`, là ước tính phía máy khách, có thể khác hoá đơn thật.
3. **`stream-json`**: mỗi dòng một sự kiện JSON, dùng khi cần hiện tiến trình theo thời gian thực.

Muốn kết quả theo khuôn cố định, ghép thêm `--json-schema`; kết quả nằm ở trường `structured_output`, nhớ kiểm tra trường này có tồn tại trước khi dùng.

```bash
claude -p "Summarize this project" --output-format json | jq -r '.result'
```

## Claude Code GitHub Actions cài đặt thế nào?

Claude Code GitHub Actions là một GitHub Action (`anthropics/claude-code-action@v1`) chạy Claude Code trong quy trình của kho mã. Theo trang "Claude Code GitHub Actions" (đọc ngày 03/11/2026), có 2 cách cài và đều cần quyền quản trị kho:

1. **Cài nhanh**: mở `claude` trong kho, chạy `/install-github-app`. Lệnh cài Claude GitHub App, lưu khoá thành secret của kho (`ANTHROPIC_API_KEY` cho khoá API hoặc `CLAUDE_CODE_OAUTH_TOKEN` cho token gói đăng ký tạo bằng `claude setup-token`), rồi mở sẵn một pull request chứa file workflow. Cách này chỉ hỗ trợ kho trên github.com và cần GitHub CLI đã đăng nhập.
2. **Cài tay**: cài Claude GitHub App, thêm secret, chép file `examples/claude.yml` từ kho của action vào `.github/workflows/`.

Lưu ý: cài app chính thức là chấp nhận cả bộ quyền của nó, gồm nhiều quyền ngoài Contents, Issues, Pull requests; muốn ít quyền hơn thì tự tạo GitHub App riêng theo hướng dẫn của action.

## Gọi @claude trong issue và pull request hoạt động ra sao?

Gọi `@claude` là chế độ tương tác của action: khi workflow không có đầu vào `prompt`, Claude chờ cụm từ kích hoạt (mặc định `@claude`) trong bình luận issue, bình luận pull request, bài review, hoặc trong tiêu đề và nội dung issue mới, rồi trả lời bằng bình luận ngay tại đó. Khi workflow có `prompt`, action chuyển sang chế độ tự động hoá và chạy không cần ai nhắc. Tài liệu nêu 2 kiểm tra trước mỗi lần chạy: người kích hoạt phải có quyền ghi vào kho (trừ sự kiện không do người tạo như lịch hẹn), và bot bị từ chối trừ khi được liệt kê trong `allowed_bots`, để tránh bot gọi nhau thành vòng lặp. Phần kiểm tra quyền ghi rất quan trọng: nội dung issue do người lạ viết là dữ liệu không tin cậy, có thể chứa câu lệnh cài cắm nhắm vào AI. Xem thêm bài [bảo mật khi dùng AI viết code](/blog/bao-mat-khi-dung-ai-viet-code).

## Có những cách nào để hẹn lịch cho Claude Code?

Hẹn lịch cho Claude Code có 4 cách, khác nhau ở chỗ máy chạy và việc có cần bật máy hay không:

| Cách | Chạy ở đâu | Cần bật máy | Ghi chú theo tài liệu (đọc ngày 03/11/2026) |
|---|---|---|---|
| Cron của máy gọi `claude -p` | Máy của bạn hoặc máy chủ | Có | Bạn tự lo xác thực, quyền, nhật ký |
| GitHub Actions `schedule` | Máy chạy của GitHub | Không | Chỉ chạy từ nhánh mặc định; kho công khai bị tắt lịch sau 60 ngày không hoạt động |
| Tác vụ hẹn giờ trên đám mây (trước gọi là routines) | Hạ tầng Anthropic | Không | Đang ở dạng xem trước nghiên cứu; tạo tại claude.ai/code/routines hoặc lệnh `/schedule`; khoảng cách tối thiểu 1 giờ; gói Pro, Max, Ultra, Team, Enterprise |
| Tác vụ hẹn giờ trên Claude Code Desktop | Máy của bạn | Có, ứng dụng phải mở | Ngủ máy thì bỏ lượt; khi thức chỉ chạy bù một lần cho lượt gần nhất trong 7 ngày |

Lệnh `/loop` chỉ lặp trong phiên đang mở và tự hết hạn sau 7 ngày, không hợp cho lịch hằng ngày. Tác vụ trên đám mây làm trên bản clone mới, đẩy lên nhánh tiền tố `claude/`, mặc định ở chế độ auto, và hành động qua GitHub hay connector mang danh tài khoản của bạn.

Ví dụ lịch hằng ngày lúc 09:00 UTC, rút từ tài liệu GitHub Actions (bỏ dòng chọn mô hình, khi đó action dùng mô hình mặc định):

```yaml
name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: |
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"
```

Lưu ý giờ: cron của GitHub tính theo UTC, 09:00 UTC là 16:00 giờ Việt Nam.

## Giới hạn quyền khi chạy không người thế nào?

Giới hạn quyền khi chạy không người là chỉ cấp đúng công cụ cần cho việc đó và để mọi thứ khác bị từ chối thay vì chờ người bấm đồng ý. Theo tài liệu chính thức (đọc ngày 03/11/2026), có 6 lớp nên dùng:

1. **Liệt kê công cụ bằng `--allowedTools`**, càng hẹp càng tốt, ví dụ `Bash(git diff *)` thay vì cả `Bash`. Tài liệu lưu ý dấu cách trước `*` là quan trọng.
2. **Chọn chế độ quyền bằng `--permission-mode`**: `dontAsk` từ chối mọi thao tác lẽ ra phải hỏi, hợp cho CI khoá chặt; `acceptEdits` cho sửa file; `auto` để bộ phân loại rà soát, nhưng không phải bảo đảm an toàn.
3. **Thêm `--permission-prompts none`** (cần bản 2.1.259 trở lên) để lần chạy không treo chờ ai trả lời.
4. **Giới hạn khối lượng**: `--max-turns` để chặn số lượt, `--max-budget-usd` để chặn ngân sách, cộng giới hạn thời gian của workflow.
5. **Dùng `--bare` với kho không do mình viết**: tài liệu cảnh báo phiên `-p` không hiện hộp thoại tin cậy thư mục, nên hook trong `.claude/settings.json` và server trong `.mcp.json` của kho vẫn chạy nếu không có `--bare`.
6. **Không đưa khoá vào file workflow**: luôn để trong GitHub Secrets.

Muốn hiểu kỹ các chế độ quyền, xem [plan mode và chế độ quyền trong Claude Code](/blog/plan-mode-va-che-do-quyen-trong-claude-code); muốn chặn lệnh bằng hook, xem [hooks trong Claude Code](/blog/hooks-trong-claude-code).

## Vì sao luôn để người duyệt trước khi đăng hoặc merge?

Người duyệt là lớp kiểm soát cuối cùng mà tự động hoá không thay được, vì máy có thể viết sai sự thật, sửa nhầm file hoặc làm theo một câu lệnh cài trong dữ liệu đầu vào. Tài liệu GitHub Actions viết rõ: chỉ cấp cho workflow quyền cần thiết và xem lại thay đổi của Claude trước khi merge. Cách làm thực dụng gồm 4 điểm:

1. Lần chạy tự động chỉ được tạo nhánh và pull request, không đẩy thẳng lên nhánh chính; dùng quy tắc bảo vệ nhánh của GitHub để buộc điều này.
2. Nội dung (bài viết, email, bài đăng mạng xã hội) chỉ vào trạng thái nháp.
3. Người duyệt đọc diff, không chỉ đọc lời tóm tắt của AI.
4. Hành động khó đảo ngược (xoá, gửi, xuất bản, thanh toán) không bao giờ nằm trong danh sách quyền của lần chạy tự động. Ngoài ra mỗi lần chạy tiêu token và phút GitHub Actions; xem [chi phí Claude Code](/blog/chi-phi-claude-code) trước khi đặt lịch dày.

## Ví dụ quy trình soạn nháp hằng ngày

Quy trình giả định, không phải người thật: một người bán khoá học muốn mỗi sáng có bản nháp blog từ ghi chú hôm trước:

1. Ghi chú được đưa vào một thư mục trong kho Git riêng tư.
2. Lúc 6 giờ sáng, một tác vụ hẹn giờ (cron máy chủ gọi `claude --bare -p`, hoặc workflow `schedule`) yêu cầu Claude đọc ghi chú mới và viết một bản nháp vào thư mục nháp, chỉ với quyền đọc và sửa file.
3. Lần chạy tạo nhánh mới và mở pull request, không chạm nhánh chính.
4. Kết quả `--output-format json` được lưu lại để xem chi phí ước tính và lỗi.
5. Chủ đọc bản nháp, sửa, rồi tự merge và tự đăng.

Ngày nào tác vụ lỗi thì chỉ thiếu một bản nháp, không có gì bị đăng sai.

## Kinh nghiệm của OPCAIOS

OPCAIOS có việc nền chạy hằng ngày trên máy chủ dùng AI soạn nháp: một việc chọn chủ đề và viết bài SEO, một việc soạn bản giới thiệu cho các repo GitHub mới được gắn sao. Cả hai chỉ tạo bản nháp chờ duyệt, không bao giờ tự đăng; khi duyệt, chúng tôi từng phải sửa lỗi chính tả, trường bị cắt cụt và đánh giá bị thổi phồng trong bản nháp AI. Các việc nền này gọi AI qua API, không phải Claude Code. Claude Code được dùng trong phiên làm việc có người (CLI và ứng dụng desktop, thường ở chế độ auto, hành động khó đảo ngược vẫn cần chủ đồng ý). Chúng tôi chưa chạy Claude Code qua GitHub Actions, chưa dùng tác vụ hẹn giờ trên đám mây cho website, nên không có số liệu thật về độ ổn định hay chi phí của các cách đó.

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

### Chạy claude -p có cần gói trả phí không?
Cần một cách xác thực hợp lệ. Chạy `-p` bình thường dùng được thông tin đăng nhập hiện có trên máy, còn `--bare` không đọc thông tin đăng nhập gói đăng ký nên phải đặt `ANTHROPIC_API_KEY` từ Claude Console, tính tiền theo token. Trong GitHub Actions có thể dùng khoá API hoặc token gói đăng ký tạo bằng `claude setup-token`. Giá và hạn mức thay đổi, nên xem trang giá chính thức của Anthropic thay vì tin con số trong bài viết bên thứ ba.

### GitHub Actions hay tác vụ hẹn giờ trên đám mây tốt hơn?
Tuỳ nơi bạn muốn quản lý. GitHub Actions nằm trong kho, xem được lịch sử chạy, tiêu phút chạy của GitHub cộng token, và bạn tự viết file workflow. Tác vụ hẹn giờ trên đám mây của Anthropic tạo bằng giao diện hoặc lệnh `/schedule`, không cần file workflow, nhưng đang ở dạng xem trước nghiên cứu, hành vi và giới hạn có thể đổi. Nếu cần đọc file trên máy mình, chỉ cách cron máy hoặc tác vụ desktop làm được.

### Có nên cho lần chạy tự động merge thẳng vào nhánh chính không?
Không nên. Lần chạy tự động nên dừng ở pull request hoặc bản nháp. Dùng quy tắc bảo vệ nhánh của GitHub để chặn đẩy thẳng, và chỉ cấp quyền đọc khi việc chỉ cần đọc như báo cáo hằng ngày. Merge tự động khiến một lỗi hay một câu lệnh cài cắm trong issue đi thẳng vào sản phẩm mà không ai nhìn qua. Một lần duyệt diff vài phút rẻ hơn nhiều so với sửa hậu quả.

### Làm sao biết lần chạy hằng ngày bị lỗi?
Với `claude -p`, kiểm tra mã thoát: 0 là thành công, khác 0 là thất bại; lỗi trong lúc chạy như thiếu xác thực được in ra làm kết quả. Lưu đầu ra `--output-format json` vào file nhật ký để xem lại. Với GitHub Actions, xem lịch sử chạy của workflow và bật thông báo khi thất bại. Với tác vụ desktop, trang chi tiết tác vụ có lịch sử, kể cả lượt bị bỏ vì máy ngủ.

### Người không biết code có tự động hoá Claude Code được không?
Được ở mức đơn giản, nếu bắt đầu bằng việc chỉ đọc như tóm tắt commit hay issue hằng ngày, và luôn để kết quả ở dạng nháp. Phần khó là hiểu quyền, secret và quy tắc bảo vệ nhánh; đừng bỏ qua chúng để cho nhanh. Đọc thêm [quy trình an toàn dùng tác tử lập trình](/blog/tac-tu-lap-trinh-cho-nguoi-khong-biet-code-quy-trinh-an-toan). Muốn được hướng dẫn từng bước, xem [khoá đào tạo ứng dụng AI](/services/dao-tao-ung-dung-ai) của OPCAIOS.

*Nguồn: tài liệu Claude Code trên code.claude.com/docs, các trang "Run Claude Code programmatically", "Claude Code GitHub Actions", "Automate work with scheduled tasks", "Schedule recurring tasks in Claude Code Desktop", "Run prompts on a schedule" (đọc ngày 03/11/2026); quy trình soạn nháp trong bài là giả định; chưa kiểm chứng giá và hạn mức cụ thể, chưa chạy thử các khối lệnh trong bài trên kho của OPCAIOS. Kinh nghiệm là của OPCAIOS.*
