Làm app cùng AI agent

Giao diện

Thông tin kiểm chứng ngày 2026-10-24T00:00:00.000Z

Headless / CI ​

Headless (chạy không giao diện) là chạy agent bằng một lệnh: đưa prompt vào, nhận kết quả ra, không ai ngồi gõ. Dùng cho script, CI, vòng lặp.

Giải quyết vấn đề gì ​

Phiên tương tác cần bạn ngồi trước màn hình. Nhiều việc lại không cần:

  • Review tự động mỗi PR.
  • Sửa lỗi lint/typecheck trong pipeline.
  • Chạy lặp một prompt trong script cho tới khi đạt tiêu chí.
  • Chạy theo lịch, qua đêm (nấc 4, xem Hiện trạng).

Headless biến agent thành một lệnh như mọi lệnh khác trong terminal hay CI.

Khi nào cần ​

  • Có một việc lặp lại, prompt cố định, kết quả kiểm tra được bằng máy.
  • Muốn agent tham gia vào CI (GitHub Actions).
  • Chưa cần khi bạn còn đang học nấc 3. Headless không có ai duyệt giữa chừng, nên mọi rào chắn (test, hook, quyền hẹp) phải có sẵn.

Ví dụ tối thiểu ​

bash
claude -p "Chạy bun test, sửa test đang fail, không sửa file test" \
  --allowedTools "Read,Edit,Bash(bun test*)" \
  --max-turns 10 \
  --output-format json

Từng cờ:

CờÝ nghĩa
-p "..."Chạy một prompt rồi thoát
--allowedToolsTool được dùng không cần hỏi; nên hẹp
--permission-modeĐặt mode, ví dụ auto
--max-turns NGiới hạn số lượt; không đặt thì không giới hạn
--output-formattext, json hoặc stream-json (để script đọc)
--continue / --resumeTiếp tục phiên trước
--bareKhuyên dùng cho CI

claude -p mặc định là Manual

Từ v2.1.302, -p không tự vào auto mode. Nếu không đặt mode, phiên chạy ở default (Manual), và tool cần duyệt bị từ chối vì không ai ở đó để bấm "Yes". Phải có allow rule (--allowedTools hoặc allowlist trong settings) hoặc truyền --permission-mode auto.

Một bẫy nữa, đã chạy thử trên practice/starter: nếu thư mục chưa được trust (chưa từng mở phiên tương tác và bấm tin), allowlist trong .claude/settings.json của dự án không áp dụng cho claude -p. Mở claude tương tác một lần trong thư mục đó và chấp nhận trust trước khi chạy headless. Allowlist của starter xem ở Permission mode.

GitHub Actions ​

Action chính thức là anthropics/claude-code-action@v1. Cài nhanh bằng lệnh /install-github-app trong phiên Claude Code.

yaml
- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review PR này: tìm bug logic và trường hợp biên chưa có test."
    claude_args: "--max-turns 5"

claude_args nhận các cờ như dòng lệnh. Trong CI, marketplace plugin chính thức chưa có sẵn; xem Plugin.

Bên Codex ​

Tương đương là codex exec. Ý tưởng giống nhau: một lệnh, một prompt, chạy không giao diện. Xem chương 7.

Nguồn ​