Bộ chặn ultracode: năm cài đặt, checklist khi nào tỏa agent và các cặp đã đo

TL;DR và kết luận

• Ultracode không làm Claude Code thông minh hơn. Nó đổi những gì model được bảo và gỡ ba lớp bảo vệ, nên một lần chạy tiêu nhiều hơn và dừng muộn hơn.
• Quy tắc: chỉ tỏa agent khi có bộ test hoặc bộ quy tắc chấm kết quả và công việc tách được thành các phần độc lập. Mọi thứ còn lại, chạy thường ở mức high.
• Năm cài đặt chặn một lần chạy: hướng dẫn kích cỡ workflow đặt là small, mức trần 4 agent đồng thời, một model rẻ hơn cho mọi agent của workflow, từ khóa thay vì công tắc, và tắt auto-continue tại giới hạn sử dụng.
• Hai tệp chứa các mức trần là settings.json và ultracode-caps.sh. Checklist là when-to-fan-out.md. Các cặp đã đo nằm trong paired-runs.csv.
• Hướng dẫn kích cỡ là lời khuyên, không phải mức trần. Ở lần chạy của chính ta, nó nói dưới 5 agent và lần chạy dùng 9.

Các nguồn nói gì

Từ khóa so với công tắc. Gõ ultracode trong một prompt cho tác vụ đó chạy dưới dạng workflow. Hỏi bằng lời của bạn, ví dụ "use a workflow", cũng là cùng một lựa chọn bật s1. Từ khóa không có tác dụng trong prompt truyền bằng -p, trong đầu vào Agent SDK chưa được đóng dấu, hay trong một tác vụ theo lịch s1. Công tắc thì khác. Khi ultracode bật, Claude lên kế hoạch một workflow cho mỗi tác vụ đáng kể, và một yêu cầu có thể thành nhiều workflow nối tiếp nhau s1. Tài liệu nói thêm rằng một phiên bật ultracode chạm giới hạn phiên hoặc giới hạn tuần sớm hơn cùng công việc đó khi tắt s1.

Câu được chèn vào. Khi ultracode bật, tài liệu tham chiếu viết workflow nói: "author and run a workflow for every substantive task by default. The goal is the most exhaustive, correct answer you can produce" và rằng "token cost is not a constraint." Cùng đoạn văn bản được trích trong một issue công khai tên "Ultracode overrides the workflow size guideline" s8. Mỗi workflow trong một chuỗi có ngân sách agent riêng, nên bốn pha 15 agent thành 60 agent trong khi không workflow đơn lẻ nào vi phạm hướng dẫn s8.

Ba lớp bảo vệ. Ultracode tắt ba lớp kiểm tra. Cảnh báo Large workflow không xuất hiện. Giới hạn subagent đồng thời của phiên không được áp dụng cho các subagent mà Claude tạo bằng công cụ Agent. Ở chế độ quyền auto, bạn không được hỏi duyệt lần khởi chạy workflow đầu tiên s1.

Hướng dẫn kích cỡ. Small nghĩa là dưới 5 agent, medium dưới 10, large dưới 50. Mặc định là medium, hoặc small trên gói Pro với v2.1.271 trở lên. Claude Code gửi nó cho model như lời khuyên, không phải mức trần, nên một prompt yêu cầu quy mô khác vẫn ghi đè được s1. Các giới hạn cứng là 16 agent đồng thời theo mặc định và 1.000 agent cho mỗi lần chạy. Cảnh báo workflow lớn nổ ra khi vượt 25 agent hoặc 1,5 triệu token dự kiến, và nó chỉ cảnh báo s1.

Lần chạy của chính ta. Ta gõ từ khóa trên một sandbox hai tệp và 16 dòng code, với hướng dẫn kích cỡ đặt là small, và yêu cầu một review chỉ đọc. Lần chạy dùng 9 agent: 2 finder và 7 verifier. Mỗi finder đọc khoảng 45,2k token. Ta không chạy bản thường của cùng prompt, nên không có số ghép cặp của riêng mình.

Bài test ghép cặp. Trên gói 200 đô la, một lập trình viên đưa cùng một đặc tả cho một lần chạy thường và một lần chạy ultracode. Cả hai qua 136/136 bài kiểm tra ẩn. Lần chạy thường xong trong 25 phút với 8% giới hạn 5 giờ. Lần chạy ultracode bị cắt ở phút 76 khi đã mất 18%, và nó dùng 12 agent trong hai đội (9 và 3), không phải 1.000. Tính theo phút thì mức đốt gần bằng nhau: nó chỉ không dừng s3.

Ba cặp nữa trên gói Pro. Agent đơn so với workflow, cùng kết quả tìm được: 115k so với 972k token, 52k so với 936k, và 102k so với 683k. Đồng hồ /usage nhích 4 so với 12, 7 so với 12 và 4 so với 8 điểm, mà tác giả tóm lại là khoảng hai lần hạn mức, tới ba lần. Thời gian thực của script kế hoạch Opus là 173 s so với 178 s. Trên bốn việc nghiên cứu độc lập, song song nhanh hơn 1,6 lần với 2,3 lần số token s4.

Cặp 30x. Một agent ở xhigh mất 1 h 13 m cho khoảng 18 đô la theo giá API. Max với ultracode mất 9 h 14 m, với 40 subagent, cho khoảng 554 đô la. Mỗi bên một lần chạy, giá niêm yết API, không tính tiền trên thuê bao s11.

Một cặp trông thế nào. Một repo test công khai chứa một cặp agent đơn so với workflow trên cùng một tác vụ. Agent đơn dùng 181.646 token, workflow 1.326.703. Chi phí theo giá API là 0,2678 đô la so với 1,3744 đô la. Thời gian thực là 43 s so với 80 s, và đồng hồ phiên nhích +0 so với +12 điểm s22. Đó là một cặp, nên hãy đọc nó như một hình dạng chứ không phải một định luật. Tài liệu liệt kê subagent và workflow là một yếu tố đẩy token: mỗi agent mà workflow tạo ra gửi request riêng của nó lên trên cuộc trò chuyện chính s5. Nhóm nghiên cứu của Anthropic đo được khoảng 4 lần token nhiều hơn cho một agent so với một cuộc chat, và khoảng 15 lần cho một hệ đa agent s20.

Chỗ có lời: Bun. Bun được viết lại từ Zig sang Rust với khoảng 50 workflow động chạy liên tục trong 11 ngày. Mã nguồn là 535.496 dòng Zig, và bản port đi từ lúc bắt đầu đến 100% bộ test qua trên mọi nền tảng trong 11 ngày s19. Giám khảo là một bộ test có sẵn.

Chỗ có lời: vụ săn lỗi. Anthropic gài 70 lỗi vào một codebase 116k dòng. Qua 3 lần chạy, một agent đơn tìm được 14, 15 và 27. Một workflow tìm được 66 trong mỗi lần trong 3 lần chạy s24. Bài test đó chạy trên Managed Agents, sản phẩm API, không phải trên Claude Code. Anthropic không đưa chi phí cho nó và khuyên nên bắt đầu bằng một tác vụ có phạm vi hẹp s24. Blog ra mắt nói hầu hết các tác vụ code truyền thống không cần một hội đồng 5 người review s2.

Lần chạy mất kiểm soát. Một script do model viết trên gói Max 20x khởi động 221 agent trong 51 phút. Sau lỗi giới hạn phiên đầu tiên, 189 agent nữa được khởi động. Bảng của người báo cáo đếm 47.465.299 token gồm cache s7. Hai lưu ý từ người báo cáo: 189 agent sau đó không có phản hồi model nào được ghi lại, và fallback của script cứ tiếp tục điều phối khi một bước merge không trả về gì. Lần chạy đó ở v2.1.266, trước cơ chế tạm dừng tại giới hạn sử dụng s7. Một báo cáo công khai thứ hai mô tả hai workflow 56 và 104 agent, 1.472.855 và 1.752.360 token, trong đó 92 trên 160 agent thất bại vì giới hạn phiên s21. Người báo cáo nói ultracode được ghi nhận là bật mà người dùng không hề bật.

Các đòn bẩy. CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS nhận giá trị từ 1 đến 256 và cần v2.1.269 s10. CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL chạy mọi agent của workflow trên một model trong khi các subagent khác giữ model của chúng, từ v2.1.296 s18. Với autoContinueAtUsageLimit bật, một lần chạy chạm giới hạn sẽ tạm dừng và tiếp tục tại lần reset, tối đa hai lần chờ, và lần thứ ba thì agent thất bại. Khi tắt, các agent bị ảnh hưởng thất bại tại bức tường s1. Blog ra mắt nói một ngân sách trong prompt, như "use 10k tokens", đặt mức trần s2. Khung /workflows cho thấy mức dùng token của từng agent, và x dừng lần chạy s1. /usage đánh dấu các hành vi chiếm 10% trở lên mức dùng gần đây, và v2.1.299 đã thêm cảnh báo cho workflow s5 s18.

Bộ công cụ chặn

Khối cài đặt. Mức trần 1 là hướng dẫn kích cỡ, mức trần 4 là ultracode giữ ở false để từ khóa là cách duy nhất vào, và mức trần 5 là tắt auto-continue. Đặt nó trong .claude/settings.json hoặc bất kỳ tệp settings nào. Khóa workflowSizeGuideline hoạt động trong mọi tệp settings từ v2.1.219 s1.

settings.json

{
  "workflowSizeGuideline": "small",
  "ultracode": false,
  "autoContinueAtUsageLimit": false
}

settings.json on GitHub

Các dòng env. Mức trần 2 và 3. Thay phần giữ chỗ bằng id đầy đủ của model mà bạn muốn các agent workflow chạy trên đó.

ultracode-caps.sh

#!/usr/bin/env bash
# Source this file before you launch Claude Code: `source ultracode-caps.sh && claude`.
# These two lines are caps 2 and 3 of the five. Caps 1, 4 and 5 live in settings.json.

# Cap 2: at most 4 workflow agents run at once. The default is 16 (fewer on a machine
# with few CPUs). Accepted values are 1 to 256. Needs Claude Code v2.1.269 or later.
export CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=4

# Cap 3: run every workflow agent on one cheaper model, while your other subagents
# keep theirs. Replace the placeholder with the full model id you want to pay for.
# Needs Claude Code v2.1.296 or later.
export CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL="<your-cheaper-model-id>"

# Optional kill switch for a shared machine: no workflows at all.
# export CLAUDE_CODE_DISABLE_WORKFLOWS=1

ultracode-caps.sh on GitHub

Checklist bạn chạy qua trước khi gõ từ khóa.

when-to-fan-out.md

# When to fan out: the two-condition checklist

Fan out (use the ultracode keyword in one prompt) only if both answers are yes.

1. Does a test suite or a rule set judge the output?
   - [ ] A suite that already exists and says pass or fail without anyone's opinion.
   - [ ] Or a written rule file the output is reviewed against.
2. Does the job split into independent pieces?
   - [ ] No piece waits on the result of another piece.
   - [ ] Each piece can be checked on its own.

If either answer is no, run plain at high effort. A plain run costs one bill. A
workflow costs one bill per agent.

Jobs that usually pass both tests:
- A port or migration across many files with a test suite as the judge.
- A review of a whole codebase against a rule file.
- A translation of many files with the same prompt.
- A cleanup pass over a pile of similar documents.

Jobs that usually fail one of them:
- A small feature, a bug fix, a refactor of one module.
- Anything where "good" is a matter of taste.
- A chain of steps where each one needs the previous result.

Before you start:
- [ ] Run a slice first (one folder, ten files) and read the token total.
- [ ] Put a budget in the prompt, for example "use 10k tokens".
- [ ] Open /workflows and watch per-agent tokens. Press x to stop.
- [ ] After the run, open /usage and read the share that went to workflows.

when-to-fan-out.md on GitHub

Các cặp và trường hợp đã đo từ các nguồn, mỗi dòng một trường hợp, kèm id nguồn.

paired-runs.csv

source_id,run,measure,baseline,workflow_or_fanout,note
s22,rebuild-your-claude-md pair (rep 2),tokens,181646,1326703,"all four usage fields summed, 14 agent transcripts on the workflow side"
s22,rebuild-your-claude-md pair (rep 2),API cost in USD,0.2678,1.3744,single agent vs workflow
s22,rebuild-your-claude-md pair (rep 2),wall time in seconds,43,80,single agent vs workflow
s22,rebuild-your-claude-md pair (rep 2),session meter points,+0,+12,"/usage before to after: 17% to 17% vs 19% to 31%"
s24,70 planted bugs in 116k lines,bugs found,"14, 15 and 27 (3 runs)","66 in each of 3 runs","Managed Agents, not Claude Code; no cost given"
s19,Bun port from Zig to Rust,test suite passing,,100%,"about 50 dynamic workflows, 11 days, 535,496 lines of Zig"
s6,fixed worker and gate files,tokens for workflow execution and monitoring,100%,about 20%,"self-reported, no plan stated; runs 5 to 6 hours down to 20 to 40 minutes"
s7,runaway run on Max 20x,agents started,,221,"51 minutes; 189 started after the first session-limit error; 47,465,299 tokens including cache"
s21,ultracode reported on without the user enabling it,agents started,,"56 and 104","1,472,855 and 1,752,360 tokens; 92 of 160 agents failed with the session limit"
s20,multi-agent research system,tokens vs a chat,about 4x for an agent,about 15x for multi-agent,Anthropic's own data
s3,same spec on a $200 plan,hidden checks passed,136/136,136/136,"both runs perfect"
s3,same spec on a $200 plan,time and 5-hour limit used,"25 min, 8%","76 min (cut off), 18%","12 agents in two teams (9 and 3)"
s4,Opus plan script,tokens,115k,972k,"Pro plan; /usage 4 vs 12 points; 173 s vs 178 s"
s4,compact script,tokens,52k,936k,"Pro plan; /usage 7 vs 12 points"
s4,Claude.md script,tokens,102k,683k,"Pro plan; /usage 4 vs 8 points"
s4,four independent research jobs,time and tokens,"102 s, about 33k","about 64 s, 76k","parallel 1.6x faster for 2.3x tokens"
s11,Cybercity,time and API cost,"1 h 13 m, about $18 (1 agent)","9 h 14 m, about $554 (40 subagents)","xhigh vs max with ultracode; one run each; API list prices"

paired-runs.csv on GitHub

Hai ghi chú về bộ công cụ. Khóa ultracode chỉ quan trọng nếu bạn vốn bắt đầu các phiên với công tắc bật, và giữ nó ở false nghĩa là mỗi lần tỏa agent là một quyết định bạn đưa ra trong một prompt. Tắt hẳn workflow sẽ gỡ cả từ khóa lẫn công tắc: đặt "disableWorkflows": true trong ~/.claude/settings.json s1.

Làm việc này vào thứ Hai

• Sao chép settings.json vào settings dự án của bạn và kiểm tra /config hiện hướng dẫn kích cỡ là small.
• Source ultracode-caps.sh trong shell mà bạn khởi chạy Claude Code, với một id model thật thay cho phần giữ chỗ.
• Kiểm tra công tắc ultracode đang tắt trong /effort, và dùng từ khóa trong một prompt đơn khi bạn muốn tỏa agent.
• Trước mỗi lần tỏa agent, trả lời hai câu hỏi trong when-to-fan-out.md. Nếu một câu trả lời là không, chạy thường ở mức high.
• Chạy thử một lát cắt trước và đọc tổng token trong /workflows trước khi mở rộng công việc.
• Thêm một ngân sách vào prompt, ví dụ "use 10k tokens".
• Mở /workflows suốt lần chạy đầu và bấm x nếu số agent leo quá mức bạn dự kiến.
• Sau lần chạy, mở /usage và ghi lại phần đã dành cho workflow.

Đi xa hơn

Cố định worker và cổng kiểm thay vì để model tự viết. Một bài đăng Hacker News báo cáo đã đưa chi phí token cho việc thực thi và giám sát workflow xuống khoảng 20% so với trước, với các workflow từng mất 5 đến 6 giờ nay mất 20 đến 40 phút. Đó là tự báo cáo và không nêu gói nào s6. Phương pháp có hai phần. Một tệp agent workflow-worker nhận một phần của kế hoạch và quyền hạn chặt để viết và chạy test chỉ cho phần của nó. Một tệp agent workflow-gate nhận kết quả của các agent song song, và các bước kiểm tra tuần tự chuyển vào một Makefile với hai target: make workflow-serial-gate kiểm tra git tree và chạy test cho phần đã đổi, còn make workflow-final-gate chạy test sạch trên tất cả s6. Bước kiểm tra cổng từng mất 10 phút với các kế hoạch phức tạp nay mất một giây, theo cùng bài đăng. Con số 20% bao gồm thực thi và giám sát, không gồm việc tạo kế hoạch hay triển khai. Để thử, hãy viết hai tệp agent một lần, giữ chúng trong repo, và trỏ prompt workflow của bạn vào chúng.

Đọc báo cáo mất kiểm soát trước khi tin một script được sinh ra. Issue cho thấy một bảng theo từng pha và một mẫu hình đứng sau 189 agent thừa: khi một agent merge không trả về gì, script quay về danh sách thô và đi tiếp s7. Hãy yêu cầu model viết các script dừng lại khi một agent thất bại. Giữ auto-continue tắt trên mọi lần chạy bạn không theo dõi.

Hiểu vì sao hướng dẫn thua. Issue 92631 cho thấy văn bản hướng dẫn đặt cạnh câu của ultracode, và vì sao câu thứ hai thắng khi chúng mâu thuẫn s8. Nếu bạn muốn một mức trần cứng, biến đồng thời giới hạn số agent chạy cùng lúc, và ngân sách trong prompt giới hạn những gì chúng tiêu.

Dùng chuỗi bài ra mắt cho các việc rộng. Phản biện sắc nhất ngay ngày đầu nằm trong chuỗi bài ra mắt, với các bình luận như "an exciting new way to burn up as many tokens as possible" và "Quantity of output is not the issue right now. Quality is." s9. Các thành tích mà mọi người báo cáo ở đó có chung một hình dạng: review theo một tệp quy tắc, dịch một codebase, dọn các trang quét.

Managed Agents là một sản phẩm khác. Bài test 70 lỗi dùng workflow động của Managed Agents, chỉ có trên API. Nếu bạn xây trên API, hãy bắt đầu bằng một tác vụ có phạm vi hẹp, như Anthropic khuyên s24. Các cài đặt của Claude Code không áp dụng sang đó.

Không nên tin gì. Các giai thoại về hạn mức không có gói hay con số là đồ truyền miệng. Một người bình luận báo cáo 6 agent ăn hết hạn mức 4 giờ, và một người khác báo cáo một bản port gần 2 tỷ token tốn 20 đô la trên model rẻ của một nhà cung cấp khác, qua bản clone riêng của người đó s23 s9. Cả hai đều không phải phép đo Claude Code trên một gói. Một con số chỉ thuộc về ghi chú của bạn khi nó đi kèm gói, model, phiên bản và tác vụ.

FAQ

Từ khóa có tốn bằng công tắc không? Không. Từ khóa chạy một tác vụ như một workflow. Công tắc lên kế hoạch một workflow cho mọi tác vụ đáng kể, nên một yêu cầu có thể thành nhiều workflow s1. Cả hai đều tiêu thêm trên cuộc trò chuyện của bạn, vì mỗi agent gửi request riêng s5.

Đặt hướng dẫn kích cỡ là small có giới hạn lần chạy ở 4 agent không? Không. Đó là lời khuyên gửi cho model, và một prompt hoặc câu của ultracode có thể ghi đè nó s1 s8. Ở lần chạy của ta, nó nói dưới 5 và lần chạy dùng 9. Các giới hạn cứng là biến đồng thời và việc bạn tự dừng.

Chuyện gì xảy ra khi một lần chạy chạm giới hạn sử dụng của tôi? Với autoContinueAtUsageLimit bật, một phiên claude.ai tương tác sẽ tạm dừng lần chạy và tiếp tục tại lần reset, tối đa hai lần chờ, từ v2.1.271. Các phiên bản trước làm các agent bị ảnh hưởng thất bại s1. Khi tắt, các agent thất bại tại giới hạn và lần chạy kết thúc ở đó.

Vì sao dùng model rẻ hơn cho các agent của workflow? Phần lớn một workflow là kiểm tra, và mỗi agent gửi request riêng. CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL đặt mọi agent workflow lên một model và không đụng đến các subagent khác của bạn s18. Hãy kiểm tra kết quả trên một lát cắt trước khi dựa vào nó.

Tôi vẫn dùng ultracode được chứ? Được, cho những việc qua cả hai câu hỏi trong checklist. Bản port của Bun có cả một bộ test làm giám khảo s19. Với một tính năng nhỏ hay một bản sửa lỗi, chạy thường ở mức high là mặc định.