Định nghĩa tác nhân con
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.name là cách bạn gọi tác nhân; description là cách Claude quyết định tự gọi tác nhân, vì vậy hãy viết nó như một quy tắc định tuyến ("sử dụng sau mọi thay đổi không đơn giản") thay vì một chức danh. tools giới hạn những gì tác nhân được phép làm — một tác nhân rà soát không thể chỉnh sửa sẽ an toàn hơn. model ấn định một cấp mô hình: haiku cho việc khảo sát và phân loại, sonnet cho phần lớn công việc, opus cho bước khó, hoặc inherit để dùng theo phiên cha.
Tác nhân dự án và tác nhân người dùng
Các tệp trong .claude/agents/ thuộc về kho mã và đi cùng kho mã — hãy commit chúng, và mọi thành viên trong nhóm sẽ có cùng tác nhân rà soát, viết kiểm thử và chuyển đổi. Các tệp trong ~/.claude/agents/ là của riêng bạn trên mọi dự án. Khi trùng tên, tác nhân dự án được ưu tiên. /agents trong một phiên sẽ liệt kê, tạo và chỉnh sửa cả hai loại mà không cần thao tác với tệp bằng tay.
Khi nào Claude giao việc
Có hai cách. Ngầm định: tác nhân chính đọc mô tả của mọi tác nhân con và giao việc khi có nhiệm vụ phù hợp — không cần yêu cầu "chạy tác nhân con code-reviewer cho việc này" nếu mô tả đã nêu rõ khi nào nên sử dụng nó. Tường minh: nêu tên tác nhân trong prompt. Trong cả hai trường hợp, tác nhân con chạy trong ngữ cảnh riêng, chỉ thấy những gì được cung cấp cùng những gì nó đọc và trả về kết quả để phiên chính tóm tắt vào lịch sử của mình. Tác nhân con không khởi tạo tác nhân con khác; hệ phân cấp chỉ sâu một cấp.
Vì sao chúng giúp giảm chi phí phiên
Mỗi lượt trong Claude Code đều gửi lại toàn bộ cuộc hội thoại. Một tác tử phụ đọc bốn mươi tệp sẽ làm việc đó trong cửa sổ ngữ cảnh riêng; tác tử chính chỉ nhận một đoạn văn. Nếu không có tác tử phụ, bốn mươi tệp đó sẽ nằm trong ngữ cảnh chính suốt phần còn lại của phiên và được gửi lại ở mỗi lượt. Vì vậy, cách làm cho các cơ sở mã lớn là: khảo sát bằng tác tử phụ Haiku, rà soát bằng tác tử phụ Sonnet, giữ ngữ cảnh của tác tử chính cho các quyết định. Mỗi tác tử phụ được tính phí theo token riêng — không miễn phí, nhưng phạm vi được giới hạn.
Chạy song song và giới hạn tốc độ
Có thể chạy nhiều tác tử phụ cùng lúc, và mỗi tác tử là một yêu cầu truyền luồng song song. Đó là cách nhanh nhất để chạm giới hạn yêu cầu đồng thời trên bất kỳ điểm cuối nào, vì vậy với tài khoản cổng API mới, hãy bắt đầu bằng hai hoặc ba tác tử chạy song song và yêu cầu mức đồng thời cao hơn khi đã có khối lượng công việc thực tế. Hướng dẫn về lỗi giải thích 429 mà bạn sẽ gặp nếu không làm vậy.
Nhóm tác tử
Các bản dựng Claude Code mới hơn bổ sung nhóm tác tử: thay vì một tác tử chính giao việc cho các tác tử phụ tồn tại ngắn hạn, nhiều phiên phối hợp dưới dạng các thành viên có tên, dùng chung danh sách tác vụ và trao đổi tin nhắn với nhau, để người phụ trách có thể phân công, hỏi tiến độ và dừng một thành viên. Đây là khả năng thử nghiệm, cần bật qua một thiết lập và thay đổi giữa các bản phát hành — hãy kiểm tra claude --help và nhật ký thay đổi để biết cờ hiện hành thay vì dựa vào bài blog. Cách hình dung vẫn giống tác tử phụ, nhưng bổ sung khả năng duy trì hoạt động và giao tiếp; mô hình chi phí cũng tương tự, nhân lên theo số thành viên.
Trên cổng API
Tác tử phụ và nhóm dùng cùng điểm cuối và khóa với phiên chính, vì vậy ANTHROPIC_BASE_URL=https://aiprimetech.io áp dụng cho tất cả. Với gói không giới hạn có mức phí cố định, việc chạy song song trở thành vấn đề sử dụng hợp lý thay vì vấn đề tính phí, nên người dùng nhiều tác tử với cường độ cao thường chuyển sang gói này.
| Kế hoạch | Thời hạn | Giá |
|---|---|---|
| Không giới hạn trong 1 giờ | 1 giờ | $1 |
| Không giới hạn trong 24 giờ | 24 giờ | $10 |
| Không giới hạn trong 1 tuần | 1 tuần | $49 |
| Không giới hạn trong 15 ngày | 15 ngày | $89 |
Tất cả các gói không giới hạn →
Dùng thử miễn phí trước
Tài khoản mới nhận được $5 tín dụng API miễn phí với mã CLAUDECODE — đủ cho một buổi tối dùng Claude Code với Sonnet — sau đó là tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyCâu hỏi thường gặp
Tác tử phụ trong Claude Code là gì?
Một tác tử riêng có lời nhắc hệ thống, quyền sử dụng công cụ, lựa chọn mô hình và cửa sổ ngữ cảnh riêng, được định nghĩa bằng tệp Markdown trong .claude/agents/, để phiên chính giao tác vụ cho.
Tài liệu về tác tử phụ của Claude Code ở đâu?
Tài liệu tham khảo chính thức nằm trong tài liệu Claude Code của Anthropic, ở mục Tác tử phụ; trang này là phiên bản thực hành — định dạng tệp, thời điểm giao việc và chi phí.
Tác tử phụ có tốn thêm phí không?
Chúng được tính phí theo token riêng như mọi yêu cầu khác. Chúng giúp tiết kiệm trong các phiên dài bằng cách giữ nội dung đọc lớn ngoài ngữ cảnh của tác tử chính, nhưng sẽ tốn hơn nếu bạn chạy nhiều tác tử song song trên Opus.
Nhóm tác tử là gì?
Một phần mở rộng thử nghiệm cho phép nhiều phiên Claude Code phối hợp dưới dạng các thành viên có tên, có tính năng nhắn tin và danh sách tác vụ chung, thay vì một tác tử chính cùng các trợ lý tồn tại ngắn hạn.
Chạy Claude Code trên cổng API
Vẫn các mô hình đó, hai biến môi trường, tín dụng có giá trị sử dụng gấp 7.69231× mệnh giá — hoặc gói không giới hạn với phí cố định. Tài khoản mới: $5 tín dụng API miễn phí với mã CLAUDECODE.
Lấy khóa API Xem các gói không giới hạnAI Prime Tech là một cổng API độc lập, không có quan hệ liên kết với Anthropic và không được Anthropic chứng thực hay tài trợ. “Claude” và “Claude Code” là các nhãn hiệu của Anthropic. Các tính năng Claude Code được mô tả ở đây dựa trên tài liệu công khai của Anthropic tại thời điểm viết và thường xuyên thay đổi; giá và danh sách mô hình trên trang này được đọc từ cấu hình hiện hành của cổng API này.