GitHub Actions và Code Review

Nơi tốt nhất để giao việc lặp lại chính là pull request. Đó là nơi diễn ra review, nơi thay đổi được merge, và nơi chiếm phần lớn công việc lặt vặt của bạn. Có hai cách đưa Claude vào đây, và chúng giải quyết hai vấn đề khác nhau. Một là dịch vụ được quản lý sẵn mà bạn chỉ cần bật lên. Cái còn lại là một GitHub Action bạn tự đấu nối. Hãy đi qua cả hai và xác định khi nào nên dùng cái nào.

Con đường được quản lý sẵn: Code Review

Lựa chọn đơn giản nhất là Code Review. Đây là một dịch vụ do Anthropic host, review pull request của bạn thông qua Claude GitHub app. Không có gì để bạn phải xây hay host. Bạn bật nó lên, và nó bắt đầu đăng các phát hiện dưới dạng comment inline ngay trên đúng dòng code liên quan.

Một admin của tổ chức bật tính năng này từ phần cài đặt admin của Claude Code. Bạn sẽ thấy mục Code review với nút Configure để kết nối nó với các repository của bạn.

Từ đó, admin cài đặt Claude GitHub app, chọn repo nào nó theo dõi, và quyết định khi nào nó chạy. Có vài lựa chọn về thời điểm:

• Một lần khi PR được mở.
• Trên mỗi lần push vào PR.
• Chỉ khi ai đó comment @claude review.

Một khi đã bật, mọi thứ chạy trên hạ tầng của Anthropic. Một bộ agent review phân tích diff dựa trên toàn bộ codebase của bạn, không chỉ những dòng thay đổi một cách cô lập. Sau đó nó đăng các phát hiện dưới dạng comment inline trên đúng dòng, gắn nhãn theo mức độ nghiêm trọng, kèm một bảng tóm tắt trong check run.

Đây là hình dạng của một phát hiện như vậy: nó xuất hiện như một comment từ Claude, ngay trên dòng code, với giải thích rõ ràng và một gợi ý sửa.

Điểm hay là nó khử trùng lặp và xếp hạng các phát hiện. Vậy nên thay vì đọc cả một bức tường các lỗi vặt, bạn chỉ đọc một số ít vấn đề thực sự đáng chú ý.

Code Review sẽ và sẽ không làm gì

Vài điều cần nhớ về giới hạn của dịch vụ này:

• Nó không bao giờ approve hay chặn PR. Quyết định cuối cùng luôn thuộc về con người. Claude chỉ gắn cờ; bạn quyết định.
• Không có autofix được quản lý sẵn. Dịch vụ chỉ đăng các phát hiện.
• Đây hiện là research preview, khả dụng cho gói team và enterprise, nên hãy chờ đợi hành vi của nó tiếp tục thay đổi.

Vì dịch vụ không có autofix, việc áp dụng một phát hiện là một hành động cục bộ. Từ terminal của chính bạn, lệnh /code-review review một diff, và cờ --fix của nó áp dụng các phát hiện vào working tree của bạn. Vậy nên quy trình là: Claude tìm ra vấn đề trong PR, bạn pull về và sửa cục bộ.

Con đường tự làm: GitHub Action

Code Review xử lý việc review. Khi công việc vượt ra ngoài phạm vi review, bạn chuyển sang GitHub Action. Đây là cho các CI tuỳ biến: thực hiện thay đổi từ một comment, chạy báo cáo theo lịch, bất cứ việc gì bạn thường viết một workflow để làm. Nó chạy agent trên comment của PR, job theo lịch, và bất kỳ sự kiện GitHub nào.

Việc thiết lập bắt đầu ngay bên trong Claude Code. Chạy lệnh /install-github-app. Bạn cần quyền admin repo để làm việc này. Slash command này sẽ dẫn bạn qua các bước cài đặt GitHub app và thiết lập secret API key của Anthropic trên repo.

Bản thân action là anthropics/claude-code-action@v1. Đây là các input bạn sẽ thực sự dùng tới:

• anthropic_api_key - tùy chọn.
• github_token - mặc định là secrets.GITHUB_TOKEN.
• trigger_phrase - từ khóa action lắng nghe trong comment. Mặc định là @claude.
• use_bedrock / use_vertex - chuyển sang các provider đó nếu bạn dùng Bedrock hoặc Vertex.
• prompt - chỉ dẫn cho lần chạy.
• claude_args - một chuỗi tham số CLI được truyền thẳng vào Claude Code.

Một workflow phản hồi @claude

Đặt một workflow vào .github/workflows/claude.yaml và nó sẽ lắng nghe @claude trên comment của PR và issue. Bước cốt lõi trông như sau:

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    github_token: ${{ secrets.GITHUB_TOKEN }}
    trigger_phrase: "@claude"
    prompt: "Your instructions here"
    claude_args: "--max-turns 5 --model claude-sonnet-5"

Giờ ai đó viết @claude implement the spec in the linked Linear issue trên một pull request, action sẽ tiếp nhận. Claude push commit và đăng comment mô tả nó đã làm gì.

Một workflow chạy theo lịch

Cùng một action đó hoạt động cho một bản tổng hợp hằng ngày. Một trigger cron kích hoạt, chẳng hạn lúc 9:00 UTC, action chạy, và Claude đăng kết quả. Bạn cũng có thể thêm một trigger workflow_dispatch để có thể tự tay kích hoạt từ tab Actions.

Khi action chạy, bạn có thể theo dõi nó xử lý từng bước trong tab Actions, giống như bất kỳ workflow GitHub nào khác.

Tinh chỉnh lần chạy với claude_args

Dòng claude_args là nơi diễn ra việc tinh chỉnh. Vài “núm vặn” đáng biết:

• --max-turns 5 đặt giới hạn cứng cho vòng lặp agent, để nó không thể chạy mãi mãi.
• Permission mode. Với một job không giám sát, bạn sẽ muốn nó không dừng lại để hỏi, vì không có ai ở đó để trả lời.
• Allowed tools. Chỉ cho job đúng những gì nó cần, không hơn. Với một báo cáo, nghĩa là chỉ-đọc.

Nên dùng cái nào?

Đây là bản tóm tắt ngắn:

• Với việc review PR, hãy đi con đường được quản lý sẵn. Bật Code Review, để GitHub app đăng các phát hiện inline, và áp dụng fix cục bộ bằng /code-review --fix.
• Chuyển sang action khi công việc vượt ra ngoài phạm vi review. Dùng /install-github-app để thiết lập, một workflow cho các mention @claude, một workflow cho lịch cron, và mọi tinh chỉnh nằm trong claude_args.

Hãy bắt đầu với dịch vụ được quản lý sẵn. Chuyển sang action ngay khi bạn cần Claude thực sự làm gì đó trong CI, chứ không chỉ comment về nó.

Nguồn

Dịch từ bài giảng “GitHub Actions and Code Review”, khóa Claude Code in Action trên Claude Academy.