AIDiveTL;DR और फ़ैसला
- Ultracode Claude Code को ज़्यादा समझदार नहीं बनाता। वह मॉडल को जो बताया जाता है उसे बदलता है और तीन गार्ड हटा देता है, इसलिए रन ज़्यादा खर्च करता है और देर से रुकता है।
- नियम: fan-out तभी करें जब कोई test suite या नियमों का सेट आउटपुट को परखे और काम स्वतंत्र टुकड़ों में बँटे। बाकी सब कुछ सादा चलाएँ, high पर।
- पाँच सेटिंग रन को सीमित करती हैं: workflow आकार-दिशानिर्देश small पर, एक साथ चलने वाले agents की सीमा 4, हर workflow agent के लिए एक सस्ता मॉडल, टॉगल की जगह keyword, और usage limit पर auto-continue बंद।
- सीमाएँ रखने वाली दो फ़ाइलें
settings.jsonऔरultracode-caps.shहैं। चेकलिस्टwhen-to-fan-out.mdहै। नापी गई जोड़ियाँpaired-runs.csvमें हैं। - आकार-दिशानिर्देश सलाह है, सीमा नहीं। हमारे अपने रन में उसने 5 से कम agents कहा और रन ने 9 इस्तेमाल किए।
सोर्स क्या कहते हैं
Keyword बनाम टॉगल। Prompt में ultracode टाइप करने से वह एक काम workflow में चला जाता है। अपने शब्दों में माँगना, जैसे "use a workflow", उसी तरह का opt-in है s1। -p से दिए prompt में, बिना stamp वाले Agent SDK इनपुट में, या शेड्यूल किए टास्क में keyword कुछ नहीं करता s1। टॉगल अलग है। Ultracode चालू होने पर Claude हर ठोस काम के लिए workflow प्लान करता है, और एक अनुरोध लगातार कई workflows बन सकता है s1। Docs जोड़ते हैं कि ultracode चालू सेशन उसी काम की तुलना में, उसके बंद रहने पर, सेशन या साप्ताहिक लिमिट तक जल्दी पहुँचता है s1।
इंजेक्ट किया गया वाक्य। Ultracode चालू होने पर workflow-authoring reference कहता है: "author and run a workflow for every substantive task by default. The goal is the most exhaustive, correct answer you can produce" और यह कि "token cost is not a constraint." यही टेक्स्ट "Ultracode overrides the workflow size guideline" शीर्षक वाली एक सार्वजनिक issue में उद्धृत है s8। अनुक्रम का हर workflow अपना agent बजट पाता है, इसलिए 15 agents के चार चरण 60 agents बनते हैं जबकि कोई अकेला workflow दिशानिर्देश नहीं तोड़ता s8।
तीन गार्ड। Ultracode तीन जाँचें बंद करता है। Large workflow चेतावनी नहीं दिखती। Agent tool से Claude जिन subagents को spawn करता है उन पर सेशन की एक साथ चलने वाले subagents की सीमा लागू नहीं होती। Auto permission mode में पहला workflow लॉन्च मंज़ूर करने को नहीं कहा जाता s1।
आकार-दिशानिर्देश। Small का मतलब 5 से कम agents, medium 10 से कम, large 50 से कम। डिफ़ॉल्ट medium है, या v2.1.271 या बाद के संस्करण वाले Pro प्लान पर small। Claude Code इसे मॉडल को सलाह के रूप में भेजता है, सीमा के रूप में नहीं, इसलिए किसी दूसरे पैमाने की माँग करने वाला prompt इसे override कर देता है s1। कठोर सीमाएँ डिफ़ॉल्ट रूप से एक साथ 16 agents और प्रति रन 1,000 agents हैं। बड़े-workflow की चेतावनी 25 agents या 1.5 मिलियन अनुमानित tokens से ऊपर आती है, और सिर्फ़ चेतावनी देती है s1।
हमारा अपना रन। हमने दो फ़ाइलों और कोड की 16 पंक्तियों वाले सैंडबॉक्स पर आकार-दिशानिर्देश small रखकर keyword टाइप किया और सिर्फ़ पढ़ने वाली समीक्षा माँगी। रन ने 9 agents इस्तेमाल किए: 2 finders और 7 verifiers। हर finder ने लगभग 45.2k tokens पढ़े। हमने उसी prompt का सादा रन नहीं किया, इसलिए हमारे पास अपना कोई जोड़ीदार आँकड़ा नहीं है।
जोड़ीदार टेस्ट। $200 वाले प्लान पर एक developer ने सादे रन और ultracode रन को वही spec दिया। दोनों ने 136/136 hidden checks पास किए। सादा रन 25 मिनट में 5-घंटे की लिमिट के 8% पर ख़त्म हुआ। Ultracode रन 76 मिनट पर कट गया जब 18% जा चुका था, और उसने दो टीमों (9 और 3) में 12 agents इस्तेमाल किए, 1,000 नहीं। प्रति मिनट खपत लगभग बराबर थी: बस वह रुका नहीं s3।
Pro प्लान पर तीन और जोड़ियाँ। Single agent बनाम workflow, वही निष्कर्ष: 115k बनाम 972k tokens, 52k बनाम 936k, और 102k बनाम 683k। /usage मीटर 4 बनाम 12, 7 बनाम 12 और 4 बनाम 8 अंक हिला, जिसे लेखक मोटे तौर पर दोगुना कोटा, अधिकतम तीन गुना, बताता है। Opus प्लान स्क्रिप्ट पर दीवार-घड़ी का समय 173 s बनाम 178 s था। चार स्वतंत्र शोध कामों पर समानांतर रन 2.3x tokens के बदले 1.6x तेज़ था s4।
30x वाली जोड़ी। xhigh पर एक agent को 1 h 13 m लगे और API कीमतों पर लगभग $18। Ultracode के साथ max को 9 h 14 m लगे, 40 subagents के साथ, लगभग $554। हर एक का एक रन, API सूची कीमतें, सब्सक्रिप्शन पर बिल नहीं हुआ s11।
एक जोड़ी कैसी दिखती है। एक सार्वजनिक टेस्ट repo में एक ही काम पर single agent बनाम workflow की एक जोड़ी है। Single agent ने 181,646 tokens इस्तेमाल किए, workflow ने 1,326,703। API कीमत पर लागत $0.2678 बनाम $1.3744 रही। दीवार-घड़ी का समय 43 s बनाम 80 s था, और सेशन मीटर +0 बनाम +12 अंक हिला s22। यह एक जोड़ी है, इसलिए इसे नियम नहीं, एक आकार की तरह पढ़ें। Docs subagents और workflows को token चलाने वाले कारकों में गिनते हैं: workflow जो भी agent spawn करता है वह मुख्य बातचीत के ऊपर अपने request भेजता है s5। Anthropic की शोध टीम ने chat की तुलना में agent के लिए लगभग 4x और multi-agent सिस्टम के लिए लगभग 15x tokens नापे s20।
जहाँ फ़ायदा है: Bun। Bun को Zig से Rust में लगभग 50 dynamic workflows से दोबारा लिखा गया, जो 11 दिन लगातार चले। स्रोत 535,496 पंक्तियों का Zig था, और पोर्ट शुरुआत से सभी प्लेटफ़ॉर्म पर test suite के 100% पास होने तक 11 दिन में पहुँचा s19। जज एक मौजूदा test suite था।
जहाँ फ़ायदा है: bug शिकार। Anthropic ने 116k पंक्तियों के कोडबेस में 70 bugs छिपाए। 3 रन में अकेले agent ने 14, 15 और 27 ढूँढे। Workflow ने अपने 3 रन में से हर एक में 66 ढूँढे s24। वह टेस्ट Managed Agents पर चला, जो API प्रोडक्ट है, Claude Code पर नहीं। Anthropic ने उसकी कोई लागत नहीं बताई और छोटे दायरे वाले काम से शुरू करने की सलाह देता है s24। लॉन्च ब्लॉग कहता है कि ज़्यादातर पारंपरिक coding कामों को 5 reviewers के पैनल की ज़रूरत नहीं होती s2।
बेकाबू रन। Max 20x प्लान पर मॉडल की लिखी एक स्क्रिप्ट ने 51 मिनट में 221 agents शुरू किए। पहली session-limit error के बाद 189 और agents शुरू हुए। Filer की तालिका cache समेत 47,465,299 tokens गिनती है s7। Filer की दो चेतावनियाँ: बाद के 189 agents के कोई मॉडल जवाब दर्ज नहीं थे, और जब merge कुछ नहीं लौटाता था तब स्क्रिप्ट का fallback dispatch करता रहा। वह रन v2.1.266 पर था, usage limit पर pause आने से पहले s7। एक दूसरी सार्वजनिक रिपोर्ट 56 और 104 agents के दो workflows बताती है, 1,472,855 और 1,752,360 tokens के, जहाँ 160 में से 92 agents सेशन लिमिट से fail हुए s21। Filer कहता है कि ultracode को उपयोगकर्ता के चालू किए बिना रिपोर्ट किया गया था।
सीमाएँ। CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 1 से 256 तक का मान लेता है और v2.1.269 चाहिए s10। CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL हर workflow agent को एक मॉडल पर चलाता है जबकि बाकी subagents अपना मॉडल रखते हैं, v2.1.296 से s18। autoContinueAtUsageLimit चालू होने पर लिमिट छूने वाला रन pause होकर रीसेट पर फिर शुरू होता है, अधिकतम दो प्रतीक्षाएँ, और तीसरी बार agent fail होता है। बंद होने पर प्रभावित agents दीवार पर fail होते हैं s1। लॉन्च ब्लॉग कहता है कि prompt में बजट, जैसे "use 10k tokens", सीमा तय करता है s2। /workflows व्यू हर agent का token उपयोग दिखाता है, और x रन रोकता है s1। /usage उन व्यवहारों को चिह्नित करता है जो हाल के usage का 10% या अधिक बनाते हैं, और v2.1.299 ने workflows के लिए चेतावनियाँ जोड़ीं s5 s18।
Cap kit
Settings ब्लॉक। सीमा 1 आकार-दिशानिर्देश है, सीमा 4 ultracode को false रखना है ताकि keyword ही एकमात्र रास्ता रहे, और सीमा 5 auto-continue बंद है। इसे .claude/settings.json या किसी भी settings फ़ाइल में रखें। कुंजी workflowSizeGuideline v2.1.219 से किसी भी settings फ़ाइल में काम करती है s1।
settings.json
{
"workflowSizeGuideline": "small",
"ultracode": false,
"autoContinueAtUsageLimit": false
}
Env पंक्तियाँ। सीमाएँ 2 और 3। प्लेसहोल्डर की जगह उस मॉडल की पूरी id रखें जिस पर आप अपने workflow agents चलाना चाहते हैं।
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
वह चेकलिस्ट जो आप keyword टाइप करने से पहले चलाते हैं।
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.
सोर्स से नापी गई जोड़ियाँ और मामले, हर एक की एक पंक्ति, सोर्स id के साथ।
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"
Kit पर दो टिप्पणियाँ। ultracode कुंजी तभी मायने रखती है जब आप सेशन टॉगल चालू करके शुरू करते, और उसे false रखने का मतलब है कि हर fan-out एक prompt में लिया गया आपका फ़ैसला है। Workflows पूरी तरह बंद करने से keyword और टॉगल दोनों हट जाते हैं: ~/.claude/settings.json में "disableWorkflows": true सेट करें s1।
सोमवार को यह करें
-
settings.jsonको अपनी प्रोजेक्ट settings में कॉपी करें और जाँचें कि/configआकार-दिशानिर्देश small दिखा रहा है। - उस shell में
ultracode-caps.shको source करें जिससे आप Claude Code लॉन्च करते हैं, प्लेसहोल्डर की जगह असली मॉडल id के साथ। - जाँचें कि
/effortमेंultracodeटॉगल बंद है, और fan-out चाहिए तो एक अकेले prompt में keyword इस्तेमाल करें। - किसी भी fan-out से पहले
when-to-fan-out.mdके दो सवालों के जवाब दें। एक भी जवाब "नहीं" हो तो high पर सादा रन चलाएँ। - पहले एक टुकड़ा चलाएँ और काम चौड़ा करने से पहले
/workflowsमें token योग पढ़ें। - Prompt में बजट जोड़ें, उदाहरण के लिए "use 10k tokens"।
- पहले रन में
/workflowsखुला रखें और agents की संख्या आपकी उम्मीद से ऊपर जाए तोxदबाएँ। - रन के बाद
/usageखोलें और ध्यान दें कि कितना हिस्सा workflows में गया।
आगे बढ़ें
मॉडल से worker और gate लिखवाने की जगह उन्हें खुद तय करें। एक Hacker News पोस्ट बताती है कि workflow के execution और monitoring का token खर्च पहले के लगभग 20% पर आ गया, और जो workflows 5 से 6 घंटे लेते थे अब 20 से 40 मिनट लेते हैं। यह खुद की रिपोर्ट है और इसमें प्लान नहीं बताया गया s6। तरीके के दो हिस्से हैं। workflow-worker agent फ़ाइल को प्लान का एक टुकड़ा मिलता है और सख़्त अनुमतियाँ, ताकि वह सिर्फ़ अपने हिस्से के टेस्ट लिखे और चलाए। workflow-gate agent फ़ाइल समानांतर agents के नतीजे लेती है, और क्रमिक जाँचें Makefile में चली जाती हैं जिसके दो targets हैं: make workflow-serial-gate git tree जाँचता है और बदले हिस्से के टेस्ट चलाता है, और make workflow-final-gate सब कुछ पर साफ़ टेस्ट चलाता है s6। जटिल प्लान के लिए जो gate जाँच 10 मिनट लेती थी वह अब, उसी पोस्ट के अनुसार, एक सेकंड लेती है। 20% execution और monitoring को कवर करता है, प्लान बनाने या implementation को नहीं। आज़माने के लिए दोनों agent फ़ाइलें एक बार लिखें, उन्हें repo में रखें, और अपने workflow prompt को उनकी ओर इशारा करें।
जनरेट की गई स्क्रिप्ट पर भरोसा करने से पहले बेकाबू रन की रिपोर्ट पढ़ें। Issue चरण-वार तालिका और उस एक पैटर्न को दिखाती है जो 189 अतिरिक्त agents के पीछे था: जब merge agent कुछ नहीं लौटाता, स्क्रिप्ट कच्ची सूची पर लौट जाती है और आगे बढ़ जाती है s7। मॉडल से ऐसी स्क्रिप्ट माँगें जो fail हुए agent पर रुक जाएँ। जिस भी रन को आप देख नहीं रहे उस पर auto-continue बंद रखें।
जानें कि दिशानिर्देश क्यों हारता है। Issue 92631 दिशानिर्देश का टेक्स्ट ultracode के वाक्य के बगल में दिखाती है, और यह कि दोनों के टकराने पर दूसरा क्यों जीतता है s8। कठोर छत चाहिए तो concurrency variable सीमित करता है कि एक साथ कितने agents चलें, और prompt में बजट सीमित करता है कि वे कितना खर्च करें।
चौड़े कामों के लिए लॉन्च थ्रेड इस्तेमाल करें। पहले दिन की सबसे तीखी आपत्ति लॉन्च थ्रेड में है, ऐसी टिप्पणियों के साथ जैसे "an exciting new way to burn up as many tokens as possible" और "Quantity of output is not the issue right now. Quality is." s9। वहाँ लोग जिन सफलताओं की रिपोर्ट करते हैं उनका आकार एक जैसा है: नियम-फ़ाइल के विरुद्ध समीक्षा, कोडबेस का अनुवाद, स्कैन किए पन्नों की सफ़ाई।
Managed Agents एक अलग प्रोडक्ट है। 70-bug टेस्ट में Managed Agents के dynamic workflows इस्तेमाल हुए, जो सिर्फ़ API पर हैं। अगर आप API पर बनाते हैं, तो Anthropic की सलाह के अनुसार छोटे दायरे वाले काम से शुरू करें s24। Claude Code की settings उन पर लागू नहीं होतीं।
किस पर भरोसा न करें। बिना प्लान या अंक वाले कोटा किस्से सुनी-सुनाई बातें हैं। एक टिप्पणीकार बताता है कि 6 agents ने 4-घंटे का कोटा खा लिया, और दूसरा लगभग 2 अरब tokens के एक पोर्ट की रिपोर्ट करता है जिसकी लागत किसी दूसरे विक्रेता के सस्ते मॉडल पर, टिप्पणीकार के अपने क्लोन से, $20 रही s23 s9। इनमें से कोई प्लान पर Claude Code का माप नहीं है। कोई अंक आपके नोट्स में तभी जाए जब वह प्लान, मॉडल, वर्ज़न और काम के साथ आए।
FAQ
क्या keyword की लागत टॉगल जितनी होती है? नहीं। Keyword एक काम को workflow की तरह चलाता है। टॉगल हर ठोस काम के लिए workflow प्लान करता है, इसलिए एक अनुरोध कई बन सकता है s1। दोनों आपकी बातचीत के ऊपर खर्च करते हैं, क्योंकि हर agent अपने request भेजता है s5।
क्या आकार-दिशानिर्देश small रखने से रन 4 agents तक सीमित हो जाता है? नहीं। यह मॉडल को भेजी गई सलाह है, और कोई prompt या ultracode का वाक्य इसे override कर सकता है s1 s8। हमारे रन में उसने 5 से कम कहा और रन ने 9 इस्तेमाल किए। कठोर सीमाएँ concurrency variable और आपका अपना stop हैं।
जब रन मेरी usage limit छू ले तो क्या होता है?
autoContinueAtUsageLimit चालू होने पर, इंटरैक्टिव claude.ai सेशन रन को pause करता है और रीसेट पर आगे बढ़ाता है, अधिकतम दो प्रतीक्षाएँ, v2.1.271 से। पुराने संस्करण प्रभावित agents को fail कर देते हैं s1। बंद होने पर agents लिमिट पर fail होते हैं और रन वहीं ख़त्म हो जाता है।
Workflow agents के लिए सस्ता मॉडल क्यों?
Workflow का ज़्यादातर हिस्सा जाँच है, और हर agent अपने request भेजता है। CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL सभी workflow agents को एक मॉडल पर रखता है और आपके बाकी subagents को छूता नहीं s18। भरोसा करने से पहले नतीजा एक टुकड़े पर जाँच लें।
क्या मैं अब भी ultracode इस्तेमाल कर सकता हूँ? हाँ, उन कामों के लिए जो चेकलिस्ट के दोनों सवाल पास करते हैं। Bun के पोर्ट में जज के रूप में पूरा test suite था s19। छोटे फ़ीचर या bug fix के लिए high पर सादा रन ही डिफ़ॉल्ट है।