Claude Code의 ultracode란? 하는 일과 드는 비용

ultracode는 강도 수준이 아니라 Claude Code의 설정입니다. 켜 두면 Claude는 실질적인 작업마다 dynamic workflow, 즉 여러 서브에이전트를 실행하는 스크립트를 작성합니다. 켜고 끄는 방법, max 강도가 아닌 이유, 그리고 같은 코드 리뷰를 Opus 5.5에서 xhigh로 한 번, ultracode로 한 번 실행한 결과를 소개합니다. 토큰은 약 4배, 시간은 2배 이상 들었고, claude -p에서는 검증 결과가 끝내 돌아오지 않았습니다.

"What is ultracode in Claude Code"는 Google 트렌드에서 14일 밤 연속으로 오르고 있고, Google은 이제 "what does ultracode do in claude code", "what does opus ultracode do", "what does ultracode mode do"를 추천 검색어로 보여 줍니다. 여기에 답하는 페이지들은 서로 말이 다릅니다. 한 곳은 가장 높은 강도 모드라고 하고, 다른 곳은 xhigh라고 합니다. 지금 기준으로는 둘 다 틀렸습니다.

짧은 답: ultracode는 Claude가 실질적인 작업을 하나의 대화에서 턴마다 처리하는 대신, 각 작업을 dynamic workflow, 즉 스크립트가 실행하는 여러 서브에이전트로 구성하게 만드는 Claude Code 설정입니다. 강도 수준이 아니며, 토큰도 더 많이 듭니다. 얼마나 더 드는지는 실제 작업 하나로 측정했습니다.

아래 내용은 모두 2026년 11월 19일에 Anthropic 문서(code.claude.com의 Model configuration, Dynamic workflows 페이지), Claude Code changelog, 그리고 우리 머신에 설치한 Claude Code 2.1.318로 확인했습니다.

ultracode를 한 문단으로

dynamic workflow는 Claude가 여러분의 작업을 위해 작성하는 JavaScript 스크립트입니다. 런타임이 이를 백그라운드에서 실행합니다. 스크립트는 서브에이전트를 시작하고(흔히 여러 개를 동시에), 각자에게 맡을 부분을 넘기고, 그 결과를 대화에 쌓는 대신 스크립트 변수에 보관합니다. ultracode가 켜져 있으면 작업이 워크플로를 쓸 만큼 실질적인지를 Claude가 스스로 판단합니다. Anthropic의 표현으로는 "요청 하나가 여러 워크플로로 이어질 수 있습니다. 코드를 이해하는 워크플로, 변경을 만드는 워크플로, 그리고 그것을 검증하는 워크플로입니다". Anthropic의 모델 설정 페이지는 이를 한 줄로 요약합니다. ultracode는 "모델의 강도 수준이 아니라 Claude Code의 설정"입니다.

켜는 방법, 그리고 끄는 방법

쓰는 방법은 두 가지이고, 효과가 지속되는 기간이 다릅니다.

작업 하나에만: 키워드. 직접 입력하는 프롬프트에 ultracode를 넣습니다. 예를 들어 ultracode: audit every API endpoint under src/routes/ for missing auth checks처럼요. Claude Code가 그 단어를 강조 표시하고, Claude는 그 작업 하나만을 위한 워크플로를 작성하며, 세션의 강도 수준은 바뀌지 않습니다. 자기 말로 "워크플로를 써 줘"라고 해도 똑같이 작동합니다. 실수로 입력했다면 macOS에서는 Option+W, Windows와 Linux에서는 Alt+W로 이 프롬프트의 강조 표시를 없앨 수 있습니다.

세션 전체에: 설정.

  • /effort ultracode는 현재 세션에서 켜고, /effort ultracode off는 끕니다. /effort 슬라이더에서는 Tab으로 Ultracode 토글을 바꾸고 Enter로 적용합니다.
  • claude --effort ultracode는 켜진 상태로 세션을 시작하고, 강도 수준도 xhigh로 설정합니다.
  • 설정 파일에 "ultracode": true를 넣으면 모든 세션에서 켜집니다. Claude Code는 이 키를 읽기만 하고 쓰지는 않습니다.

완전히 멈추려면. /config에서 "Ultracode keyword trigger"를 끄면 그 단어로 워크플로가 시작되지 않습니다. /config에서 "Dynamic workflows"를 끄거나, "disableWorkflows": true를 설정하거나, CLAUDE_CODE_DISABLE_WORKFLOWS=1을 설정하면 워크플로가 ultracode와 함께 사라집니다. 조직은 관리형 설정에서 같은 일을 할 수 있습니다.

아예 선택지에 나오지 않는 경우가 두 가지 있습니다. 워크플로가 꺼져 있을 때, 또는 모델이 xhigh 강도를 지원하지 않을 때입니다. 워크플로 자체는 모든 유료 요금제, Anthropic API 접근, 그리고 Amazon Bedrock, Google Cloud, Microsoft Foundry에서 쓸 수 있습니다. Pro에서는 먼저 /config에서 Dynamic workflows 항목을 켜야 합니다.

ultracode는 max 강도가 아닙니다

설정바뀌는 것
low, medium, high모델 호출 한 번이 답하기 전에 얼마나 생각하는지
xhigh토큰을 더 써서 더 깊이 추론
max가장 깊은 추론 수준, 내가 없어도 풀리길 바라는 어려운 문제용
ultracode작업을 구성하는 방식: 여러 에이전트로 된 워크플로, 강도는 세션이 쓰는 수준 그대로

강도 수준은 호출 하나하나에 작용합니다. ultracode는 작업의 형태에 작용합니다. medium에서 ultracode를 쓸 수도 있고, ultracode 없이 max를 쓸 수도 있습니다.

이 혼동에는 내력이 있습니다. dynamic workflow는 2026년 5월 말 Claude Code v2.1.154에서 처음 나왔고, 그때 트리거 단어는 workflow였습니다. 며칠 뒤 v2.1.160에서 키워드가 ultracode로 바뀌었습니다. 9월 말 v2.1.284 전까지는 ultracode를 켜면 세션도 xhigh로 바뀌었고, 다른 수준을 고르면 ultracode가 꺼졌습니다. 여름 동안 쓰인 많은 페이지가 "ultracode는 xhigh다"라고 말하는 이유입니다. v2.1.284부터는 어떤 수준에서도 켜진 채로 남는 별도의 토글입니다. 남은 흔적은 하나뿐입니다. 시작 플래그 --effort ultracode는 지금도 동시에 xhigh를 설정합니다.

켜면 무엇이 바뀌나

ultracode를 켜는 것은 큰 실행을 받아들인다는 뜻으로 간주되므로, 세 가지 안전장치가 조용해집니다.

  • "Large workflow" 경고가 더 이상 나타나지 않습니다. 보통은 워크플로가 에이전트 25개 초과, 또는 예상 토큰 150만 개 초과를 계획할 때 표시됩니다.
  • 세션의 동시 서브에이전트 수 제한이 Claude가 Agent 도구로 시작하는 서브에이전트에는 적용되지 않습니다.
  • auto 권한 모드에서는 첫 워크플로 실행을 승인하라는 요청이 나오지 않습니다.

그래도 유지되는 것은 크기 가이드라인과 런타임 상한입니다. 가이드라인은 Claude가 스크립트를 작성할 때 Claude Code가 Claude에게 건네는 조언입니다. small은 에이전트 5개 미만, medium은 10개 미만, large는 50개 미만을 뜻합니다. 기본값은 medium이고, Pro 요금제에서는 small입니다. /config(Dynamic workflow size)나 workflowSizeGuideline 키로 바꿀 수 있습니다. 런타임 자체는 기본적으로 한 번에 최대 16개 에이전트를 실행하고, 한 번의 실행에서 에이전트 1,000개를 넘기는 것은 거부합니다.

실행 중에는 /workflows가 진행 상황 화면을 열어 에이전트별 토큰 사용량을 보여 주며, 거기서 실행을 멈출 수도 있습니다.

같은 리뷰를 두 번 실행했습니다

Anthropic 문서는 ultracode를 쓰면 요청마다 토큰이 더 들고 시간도 더 걸린다고 말합니다. 우리는 실제 작업 하나로 우리만의 숫자를 얻고 싶어서, 같은 일을 두 번 실행했습니다.

작업. 바로 이 웹사이트의 스크립트 6개입니다. 야간 에이전트가 링크, 번역, IndexNow 제출을 확인할 때 쓰는 도구로, Python 파일 3개와 TypeScript 파일 3개, 모두 1,394줄입니다. 두 실행의 프롬프트는 같습니다. 폴더를 리뷰해 진짜 버그(잘못된 로직, 크래시를 일으킬 처리되지 않은 오류, 잘못된 엣지 케이스)를 찾고, 어떤 파일도 수정하지 말고, 버그마다 파일, 줄, 한 줄짜리 수정안을 심각도 순으로 제시하라는 내용입니다.

환경. Claude Code 2.1.318, 1M 컨텍스트 창의 Opus 5.5, 임시 폴더에 새로 복사한 파일 6개, 읽기 전용 도구(Read, Grep, Glob, 그리고 Agent와 Workflow), 크기 가이드라인은 small, claude -p로 시작. 실행 A는 --effort xhigh. 실행 B는 --effort ultracode이며, 앞에서 봤듯이 이것도 xhigh를 뜻합니다. 같은 모델, 같은 강도 수준이니 차이는 ultracode 하나뿐입니다.

실행 A: xhigh실행 B: ultracode
실제 소요 시간6분 8초14분 14초
에이전트1개, 세션 자체세션과 워크플로 에이전트 4개
처리된 입력 토큰99,400735,111
출력 토큰(그중 사고)39,054(35,105)148,602(126,222)
해당 토큰의 정가 기준 비용1.20달러4.87달러
명령이 출력한 것심각도 순으로 정렬된 버그 14개실행이 시작됐다는 메시지

입력 토큰의 대부분은 캐시 읽기입니다(실행 A 47,730개, 실행 B 424,037개). 비용 줄은 Claude Code가 JSON 출력에서 이 토큰들에 대해 계산한 정가입니다. 구독에서는 토큰 단위로 청구되는 것이 없으니, 실행이 여러분의 한도에서 얼마나 가져가는지를 보여 주는 척도입니다.

ultracode를 켰을 때 Claude가 한 일. 먼저 파일 6개를 직접 읽고 의심되는 버그 23개를 나열했습니다. 그런 다음 small 가이드라인을 지키는 2단계 워크플로 스크립트를 작성했습니다. 파일 그룹마다 하나씩 탐색 에이전트 3개를 병렬로 돌리고(서로 연결된 TypeScript 파일 2개, 링크 검사기, Python 스크립트 3개), 이어서 회의론자 에이전트 하나를 두었습니다. 회의론자의 유일한 일은 Claude 자신의 23개를 포함해 모든 후보를 반박해 보는 것이었습니다. Anthropic 문서가 설명하는 교차 검증 패턴이고, 서류상으로는 버그 찾기에서 바라는 그대로입니다.

탐색 에이전트가 찾은 것. 결과는 23개입니다. 실행 A에서 중요한 버그는 모두 들어 있었고(IndexNow에 끝내 도달하지 않는 새 파일, URL 10,000개를 넘으면 삭제되는 큐, 따옴표 없는 제목에서 나는 크래시, zh-TW를 놓치는 로케일 제거, 고아 페이지를 가리는 자기 링크), 실행 A가 보고하지 않은 것이 8개 더 있었는데 대부분 심각도가 낮았습니다. JSX 속성 안의 첫 >에서 멈추는 nofollow 검사, 하이픈에서 멈추는 namespace 정규식, 블로그 글을 빠뜨리는 감사 같은 것들입니다. 실행 A가 놓친 심각한 버그는 없었습니다.

끝내 돌아오지 않은 것. claude -p에서 Claude는 워크플로를 백그라운드로 시작한 뒤 "I'll send the final list, sorted by severity, when it finishes"라는 말로 턴을 마쳤습니다. 명령이 출력한 것은 이 문장이었습니다. 그 뒤 프로세스는 기다리다가 601초 후에 종료됐고, 그때 회의론자는 아직 확인 중이었습니다. 검증된 목록은 도착하지 않았고, 탐색 에이전트의 결과는 ~/.claude/projects/ 아래 실행 파일에서만 읽을 수 있었습니다. 우리가 읽은 페이지에서는 -p의 백그라운드 작업에 대해 문서화된 대기 한도를 찾지 못했습니다. 이것은 2.1.318에서 우리가 본 동작입니다. 대화형 세션에서는 대화가 열린 채로 남아 있고, 실행이 끝나면 결과가 돌아옵니다.

우리의 해석. 세션 하나가 전부 읽을 수 있는 파일 6개짜리 리뷰에서 ultracode는 토큰 약 4배, 시간 2배 이상을 들여 심각도 낮은 후보 8개를 더 얻었을 뿐이고, 스크립트 안에서는 검증된 목록을 내놓지 못했습니다. 대화 하나에 모든 파일을 담을 수 없는 저장소 전체 감사라면 계산이 달라집니다. 이 작업에서는 그냥 xhigh가 더 나은 결과를 냈습니다.

무엇을 소비하는지, 언제 꺼 둘지

Anthropic은 대가를 분명히 밝힙니다. ultracode를 켜면 "각 요청은 워크플로 없는 같은 요청보다 토큰을 더 쓰고 시간도 더 걸리며", 구독 요금제에서는 "ultracode를 켠 세션은 끈 상태로 같은 작업을 할 때보다 세션 한도나 주간 한도에 더 빨리 도달합니다". 우리 실행은 작업 하나에서 얻은 데이터 하나일 뿐 벤치마크가 아니지만, 같은 방향을 가리킵니다.

꺼 두어야 할 때:

  • 일상적인 작업: 이름 바꾸기, 작은 수정, 코드에 대한 질문;
  • 5시간 창이나 주간 한도가 이미 얼마 남지 않았을 때. 요청 하나가 여러 워크플로로 이어질 수 있기 때문입니다;
  • 스크립트와 예약 작업: 거기서는 키워드가 무시되고, 플래그를 쓴 우리 claude -p 실행은 검증 결과가 돌아오기 전에 종료됐습니다;
  • Pro: Anthropic이 이미 기본 크기를 small로 설정해 둡니다.

켤 때는 세션 전체보다는 되도록 키워드로 작업 하나에만:

  • 대화 하나로는 너무 넓은 작업: 저장소 전체 감사, 수백 개 파일의 마이그레이션, 출처를 서로 대조해야 하는 조사;
  • 결과를 읽기 전에 독립된 에이전트들이 서로의 결과를 검증하게 하고 싶을 때.

큰 실행 전에는 문서의 조언이 그대로 정답입니다. 먼저 작은 범위에서 워크플로를 시험하고, /workflows를 지켜보고, 토큰 수가 감당할 수 없게 늘면 실행을 멈추세요.

AgentsRoom에서 ultracode 에이전트는 어떻게 보이나

우리는 대부분의 에이전트를 AgentsRoom에서 나란히 실행하는데, ultracode는 먼저 우리 제품의 무언가를 망가뜨렸습니다. 워크플로가 실행되는 동안 Claude Code의 메인 루프는 프롬프트로 돌아갑니다. 남는 유일한 생존 신호는 작업 패널의 진행 줄로, 6/7 agents done · 5m 45s · 411.6k tokens나 "Waiting for 1 dynamic workflow to finish" 같은 형태입니다. 우리 상태 감지는 조용한 프롬프트를 "완료"로 읽고, 워크플로의 서브에이전트가 아직 일하는 중인데도 에이전트를 유휴 상태로 표시했습니다. 이제 AgentsRoom은 이 진행 줄을 읽기 때문에, 워크플로를 실행하는 에이전트는 마지막 서브에이전트가 돌아올 때까지 데스크톱과 휴대폰 모두에서 카드에 "작업 중"으로 남습니다.

같은 방식을 쓴다면 실무 메모 두 가지:

  • AgentsRoom은 CLI마다 고른 기본 추론 강도(low부터 max까지)로 Claude Code를 시작합니다. ultracode는 그 수준 중 하나가 아닙니다. 애초에 수준이 아니니까요. 작업이 그럴 만할 때 에이전트의 터미널에 /effort ultracode를 입력하고, 끝나면 /effort ultracode off를 입력하세요.
  • 진행 줄은 실행의 토큰 수가 늘어나는 대로 보여 줍니다. 우리 토큰 카운터는 그 옆에 세션 사용량을 보여 주고, 5시간 창은 긴 ultracode 실행이 가장 먼저 갉아먹는 것입니다.

자주 묻는 질문

Claude Code의 ultracode란 무엇인가요?

추론 강도 수준이 아니라 Claude Code의 설정입니다. 켜 두면 Claude는 실질적인 작업마다 dynamic workflow를 계획합니다. 여러 서브에이전트를 시작하는 짧은 스크립트로, 백그라운드에서 실행되는 동안 세션은 계속 쓸 수 있습니다. 입력한 프롬프트에 키워드 ultracode를 넣으면 그 작업 하나에 대해 같은 일이 일어납니다.

ultracode는 max 강도와 같은가요?

아니요. 강도 수준은 모델 호출 한 번이 얼마나 깊이 생각할지를 정합니다. ultracode는 하나의 대화 대신 여러 에이전트로 작업을 어떻게 구성할지를 정합니다. v2.1.284부터는 어떤 강도 수준에서도 켜진 상태로 남습니다. 지금도 xhigh가 함께 따라오는 곳은 시작 플래그 --effort ultracode 하나뿐입니다.

ultracode를 켜고 끄려면 어떻게 하나요?

작업 하나라면 직접 입력하는 프롬프트에 키워드를 넣습니다. 세션이라면 /effort ultracode와 /effort ultracode off, 또는 /effort 슬라이더에서 Tab. 시작할 때는 claude --effort ultracode. 모든 세션이라면 설정 파일에 "ultracode": true. /config의 Ultracode keyword trigger는 키워드를 막고, disableWorkflows는 워크플로와 ultracode를 함께 없앱니다.

ultracode는 토큰을 더 많이 쓰나요?

네. Anthropic 문서에 따르면 워크플로를 쓰면 요청마다 토큰이 더 들고 시간도 더 걸리며, 구독 요금제에서는 세션 한도나 주간 한도에 더 빨리 도달합니다. 우리가 측정한 실행에서 Opus 5.5로 파일 6개를 똑같이 리뷰했더니 출력 토큰이 ultracode에서는 148,602개, 그냥 xhigh에서는 39,054개였습니다. 정가 기준 비용은 약 4배(4.87달러 대 1.20달러)였는데, Claude가 파일을 직접 읽은 뒤 에이전트 4개를 더 시작했기 때문입니다.

claude -p나 예약 작업에서는 왜 ultracode 키워드가 아무 일도 하지 않나요?

키워드는 사람이 입력했을 때만 인정됩니다. 대화형 프롬프트, IDE 패널, Remote Control 클라이언트, 또는 입력을 사람의 것으로 표시하는 Agent SDK 앱이 그렇습니다. -p, 예약 작업, webhook, 중계된 pull request 댓글에서는 대신 --effort ultracode나 ultracode 설정을 쓰세요.

ultracode는 Claude Ultra 요금제나 ultrareview와 관련이 있나요?

아니요. Ultra는 Anthropic이 Max 20x에서 이름을 바꾼 구독 요금제로, 월 200달러입니다. ultrareview는 여러 에이전트가 수행하는 클라우드 코드 리뷰(/code-review ultra)로, 리서치 프리뷰 단계이며 Pro, Max, Ultra에서 3회 무료, 그 뒤에는 사용 크레딧을 씁니다. ultracode는 로컬 Claude Code 세션의 설정입니다.

AgentsRoom 다운로드

모든 AI 에이전트를, 모든 프로젝트에서, 하나의 창으로 실행하세요.

AgentsRoom 다운로드무료

컴패니언 앱: 이동 중에도 에이전트를 모니터링

Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.

버그와 요청을 공개 백로그로 바로 보내세요.

계속 읽기