본문으로 건너뛰기

Claude Code Ultracode란: /effort ultracode 사용법, xhigh·동적 워크플로우

Claude Code Ultracode는 동적 워크플로우 스위치로, v2.1.284부터 켜도 effort는 그대로입니다. --effort ultracode로 시작할 때만 xhigh도 설정됩니다.

LaoZhang AI Team게시업데이트 12 분 소요
목차
Claude Code Ultracode 의사결정 보드: 명령, 사용 사례, 피해야 할 작업, 비용 중단 규칙

2026년 11월 3일 기준으로 Claude Code Ultracode는 새 모델도, effort의 한 단계도 아닙니다. 실질적인 작업마다 Claude Code가 동적 워크플로우(dynamic workflows)를 자동으로 오케스트레이션하게 하는 설정 스위치이며, v2.1.284부터는 켜도 세션의 effort 수준이 그대로 유지됩니다. 예외는 claude --effort ultracode로 시작하는 경우 하나로, 이때는 ultracode가 켜지면서 effort도 xhigh로 설정됩니다.

세션 안에서 켜는 명령은 /effort ultracode, 끄는 명령은 /effort ultracode off이고, 모든 세션을 켠 채로 시작하려면 설정 파일에 "ultracode": true를 넣습니다. 다만 이 설정은 모든 작업을 더 좋게 만드는 버튼이 아닙니다. 대규모 감사, 마이그레이션 pilot, 여러 가설 비교, 반례 검증, 넓은 리서치처럼 여러 lane이 독립적인 근거를 만들어야 할 때 쓸 가치가 있고, 한 파일 수정이나 순서가 정해진 작은 작업에서는 ultracode를 끈 채 high나 xhigh 같은 effort 수준만 고르는 편이 더 안전합니다.

켜기 전에 중단 규칙을 정해야 합니다. 작은 범위에서 먼저 시험하고, workflow plan을 본 뒤 편집을 승인하고, 각 lane이 새 근거를 만드는지 확인하고, 반복 탐색이 시작되면 멈추고, 무거운 작업이 끝나면 /effort ultracode off로 끕니다. effort 수준은 이와 별개로 고르는 값입니다. 이 규칙이 없으면 Ultracode는 생산성 기능이 아니라 토큰과 리뷰 작업을 늘리는 설정이 됩니다.

빠른 답

Ultracode는 Claude Code의 어려운 작업용 설정입니다. 켜 두면 작업이 충분히 클 때 Claude Code가 동적 워크플로우를 구성해 여러 lane으로 조사, 구현, 반증, 검증을 나눕니다. 모델에 보내는 effort 수준은 바꾸지 않으므로, 기본값이 medium인 Opus 5.5 세션이라면 ultracode를 켜도 medium 그대로 워크플로우만 켜집니다.

지금 하려는 작업먼저 쓸 경로경계
대규모 감사, 마이그레이션, 다중 가설 검증/effort ultracode먼저 read-only 또는 작은 pilot을 돌리고, 넓은 편집은 plan 확인 후 승인합니다.
일반 세션 안에서 한 번만 무거운 workflow가 필요함직접 입력하는 prompt에 ultracode라는 단어를 넣어 이번 작업만 요청세션 전체를 계속 고비용 모드로 두지 않습니다. -p 실행에서는 키워드가 동작하지 않습니다.
한 파일 수정, 기계적 변경, 명확한 작은 리팩터링ultracode 끄기, effort는 high 또는 xhighworkflow 오케스트레이션은 오히려 소음과 비용이 될 수 있습니다.
Ultracode가 보이지 않거나 동작이 다름claude --version, 동적 워크플로우 활성 여부, xhigh 지원 모델, plan/provider/admin 설정 확인CLAUDE_CODE_EFFORT_LEVEL, 저장되는 effortLevel은 ultracode 값을 받지 않습니다.

Claude Code 안에서 켜고 끄는 가장 짧은 명령은 다음입니다.

/effort ultracode
/effort ultracode off

이번 작업 하나만 workflow로 처리하고 싶다면 세션 전체를 바꾸지 않아도 됩니다. 대화형 세션에 직접 입력한 prompt에 ultracode라는 단어가 들어 있으면 ultracode가 꺼져 있어도 그 요청에만 워크플로우가 시작됩니다.

Use an ultracode workflow for this task.
First create the workflow plan, keep edits scoped, and stop after verification.

필요한 버전은 어떤 동작을 원하느냐에 따라 다릅니다. 켜도 effort가 바뀌지 않는 현재 토글 동작, /effort ultracode off, 슬라이더의 Ultracode 토글은 v2.1.284 이상, claude --effort ultracode 플래그는 v2.1.203 이상이 필요합니다. Claude Code 공식 workflows 문서에는 동적 워크플로우 전체에 대한 단일 최소 버전이 더 이상 적혀 있지 않고, 기능별 최소 버전만 있습니다. 2026년 11월 3일 기준 npm의 stable 태그는 2.1.309, latest는 2.1.316이라 두 채널 모두 v2.1.284보다 높지만, 네이티브 설치본은 버전이 다를 수 있으니 설치된 CLI를 직접 확인하세요.

bash
claude --version
npm view @anthropic-ai/claude-code version dist-tags --json

팀에서 사용할지 결정할 때는 먼저 작업의 모양을 봅니다. Ultracode는 여러 lane이 서로 다른 증거를 만드는 작업에서 강합니다. 예를 들어 한 lane은 후보 수정안을 만들고, 다른 lane은 반례를 찾고, 또 다른 lane은 테스트와 문서 경계를 검증할 수 있습니다. 반대로 작업이 작거나, 모든 판단이 하나의 추론 흐름에 묶여 있거나, 리뷰 예산이 빡빡하면 ultracode를 끄고 effort 수준만 조절하는 편이 낫습니다.

Ultracode가 실제로 바꾸는 것

가장 중요한 구분은 모델, effort 수준, 설정 스위치 세 가지입니다. Claude Code Ultracode라는 이름 때문에 별도 모델이나 더 높은 effort 단계를 고른다고 생각하기 쉽지만, 실제로는 Claude Code가 실질적인 작업에서 동적 워크플로우를 자동으로 오케스트레이션할지 정하는 스위치입니다. Claude Code 모델 설정 문서는 /effort나 ultracode 설정으로 켜고 꺼도 effort 수준은 바뀌지 않고, /effort 슬라이더나 /model에서 수준을 다시 골라도 ultracode 상태는 그대로라고 설명합니다.

xhigh는 effort 수준, 즉 모델이 한 요청에서 어려운 추론에 쓰는 노력의 크기입니다. Ultracode는 수준과 별개로 workflow 권한을 켭니다. Claude Code는 작업을 lane으로 나누고, 각 lane에서 조사, 비교, 구현, 반증, 검증, 종합을 수행할 수 있습니다. v2.1.284 이전에는 ultracode를 켜면 세션이 xhigh로 바뀌고 다른 수준을 고르면 ultracode가 꺼졌기 때문에 "xhigh + 워크플로우"라는 설명이 그때는 맞았지만, 지금은 medium이든 max든 세션이 쓰던 수준에서 워크플로우만 켜집니다. effort 수준 자체의 의미와 모델별 기본값은 Claude Code effort 설정과 차이: Opus 5.5 기본값 medium, 안 먹힐 때 해결에서 다룹니다.

바뀌는 항목실제 영향독자가 할 일
effort 수준v2.1.284부터 바뀌지 않습니다. claude --effort ultracode로 시작할 때만 xhigh가 함께 설정됩니다.더 깊은 추론이 필요하면 /effort xhigh처럼 수준을 따로 고릅니다.
dynamic workflow orchestrationClaude가 작업 lane을 나누고 비교 또는 검증합니다.독립 검증이나 병렬 증거가 필요할 때 사용합니다.
적용 범위/effort ultracode는 현재 세션에만, 설정 파일의 "ultracode": true는 모든 세션에 적용됩니다.어려운 작업 후에는 /effort ultracode off로 끕니다.
workflow planClaude가 여러 단계의 계획을 제안하거나 실행할 수 있습니다.넓은 편집 전 plan을 검토합니다.

워크플로우 자체가 어떻게 돌아가는지, 즉 스크립트, /workflows, 동시 실행 한도, 첫 실행 방법은 Claude Code Dynamic Workflows: 언제 쓰고, ultracode가 무엇을 바꾸며, 어떻게 안전하게 시작할까에서 정리합니다. 여기서 기준은 단순합니다. 오케스트레이션이 비용을 벌어야 합니다. lane 분할, 독립 검증, 넓은 탐색이 필요하지 않다면 ultracode를 끄고 high나 xhigh만 쓰는 편이 더 깔끔합니다. 강한 이름 때문에 항상 켜두면 파일 변경 범위, 리뷰 부담, 토큰 사용량, 대기 시간이 함께 커집니다.

2026년 11월 3일 실측: 모델에 실제로 전송된 effort

2026년 11월 3일, macOS의 Claude Code 2.1.316에서 claude -p를 실제 모델 대신 요청의 effort 필드를 기록하는 로컬 mock 엔드포인트에 연결하고 모델을 claude-opus-5-5로 지정해 조건별로 실행했습니다. 설정 파일에 "ultracode": true만 넣었을 때 전송된 effort는 아무것도 설정하지 않은 기준 실행과 같은 medium이었고, 워크플로우 도구는 요청에 들어 있었습니다. --effort로 직접 수준을 고른 경우와 --effort ultracode 플래그만 결과가 달랐습니다.

조건전송된 effort비고
아무것도 설정하지 않음mediumOpus 5.5 기본값
"ultracode": truemedium수준은 그대로
"ultracode": true + --effort highhigh직접 고른 수준이 적용됨
--effort ultracodexhigh켜면서 xhigh 설정
--effort ultracode + CLAUDE_CODE_DISABLE_WORKFLOWS=1xhigh워크플로우 도구가 요청에서 빠짐

같은 날 /effort ultracode를 -p prompt로 넘기자 Ultracode on (this session only): dynamic workflows on every task. Effort stays medium.이 출력되었습니다. 하루 전인 11월 2일 같은 방식의 테스트에서는 xhigh를 지원하지 않는 claude-opus-4-6으로 --effort ultracode를 실행하자 high가 전송되었습니다. 워크플로우가 실제로 lane을 나눠 실행되는 과정, 토큰 비용, 대화형 슬라이더에서 토글을 바꾸는 동작은 mock이 평문만 돌려주는 구조라 테스트하지 않았고, 해당 내용은 Anthropic 공식 문서를 따릅니다.

켜는 방법

일반적인 Claude Code 사용자는 세션 안에서 /effort ultracode로 켜고 /effort ultracode off로 끕니다. 이 명령은 현재 세션에만 적용되고 effort 수준은 바꾸지 않습니다. 매번 켜기 번거로우면 설정 파일에 "ultracode": true를 넣어 모든 세션이 켜진 채로 시작하게 하고, 시작부터 xhigh까지 함께 원하면 claude --effort ultracode로 실행합니다.

/effort ultracode
/effort ultracode off

/effort만 입력하면 나오는 슬라이더에서는 Tab으로 Ultracode 토글을 바꾸고 Enter로 적용합니다. 슬라이더에서 low부터 max까지 수준을 다시 골라도 ultracode 상태는 그대로입니다. Claude Code는 ultracode 설정 키를 읽기만 하고 직접 쓰지 않으므로, 모든 세션에 적용하려면 설정 파일을 손으로 고쳐야 합니다. Agent SDK control request도 있지만, 이미 SDK로 세션을 제어하는 제품을 만들고 있을 때만 고려하면 됩니다.

제어 방식Ultracode 켜기/끄기적용 범위effort 수준
/effort ultracode켬현재 세션그대로
/effort ultracode off끔현재 세션그대로
/effort 슬라이더에서 Tab 후 Enter켬/끔 전환현재 세션그대로
직접 입력한 prompt에 ultracode그 요청에만 워크플로우 시작한 요청문서에 언급 없음
"ultracode": true (설정 파일, --settings)켬모든 세션 시작 시그대로
claude --effort ultracode (v2.1.203+)켬그 세션xhigh로 설정
Agent SDK effortLevel: "ultracode"켬SDK 세션xhigh로 설정
CLAUDE_CODE_EFFORT_LEVEL사용 불가—ultracode 값을 받지 않음
저장되는 effortLevel 설정사용 불가—ultracode 값을 받지 않음

CLAUDE_CODE_EFFORT_LEVEL과 저장되는 effortLevel은 수준만 정하는 값이라 ultracode를 넣어도 켜지지 않습니다. 반대로 CLAUDE_CODE_EFFORT_LEVEL이나 조직의 effort 상한이 세션 수준을 정하고 있어도 ultracode는 막히지 않고, 그 수준에서 켜진 채로 유지됩니다.

한 번만 workflow가 필요하다면 prompt에서 명시적으로 요청하세요. 이렇게 하면 다음 작은 편집이나 확인까지 모두 Ultracode 경로에 들어가는 것을 피할 수 있습니다. 키워드는 대화형 세션에 직접 입력한 prompt에서만 동작하고, -p로 넘긴 prompt, 예약 작업, webhook이나 PR 댓글로 들어온 내용에서는 워크플로우를 시작하지 않습니다. 단어만 쓰고 싶었다면 macOS에서는 Option+W, Windows와 Linux에서는 Alt+W로 취소하고, 아예 끄려면 /config의 "Ultracode keyword trigger"를 끕니다.

보이지 않을 때 점검 목록

Ultracode가 보이지 않거나 workflow 동작이 시작되지 않는다면 원인은 대부분 두 가지입니다. 동적 워크플로우가 꺼져 있거나, 지금 모델이 xhigh를 지원하지 않는 경우입니다. 아래 순서대로 확인합니다.

  1. claude --version을 실행합니다. 토글 동작과 /effort ultracode off는 v2.1.284 이상, --effort ultracode는 v2.1.203 이상이 필요합니다.
  2. 동적 워크플로우가 켜져 있는지 봅니다. Pro 사용자는 /config의 Dynamic workflows 행에서 직접 켜야 하고, "disableWorkflows": true, CLAUDE_CODE_DISABLE_WORKFLOWS=1, 관리형 설정이나 관리자 토글로 꺼져 있을 수도 있습니다.
  3. 선택한 모델이 xhigh를 지원하는지 확인합니다.
  4. plan과 provider를 확인합니다. 동적 워크플로우는 모든 유료 플랜, Anthropic API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에서 제공됩니다.
  5. 설정 변경 후 세션을 재시작합니다.

두 가지 사용 불가 메시지는 원문으로 구분할 수 있습니다. 2026년 11월 3일 Claude Code 2.1.316에서 CLAUDE_CODE_DISABLE_WORKFLOWS=1로 워크플로우를 끈 채 /effort ultracode를 실행하면 다음이 출력되었고, 이때는 /config에서 동적 워크플로우를 켜면 됩니다.

Ultracode needs dynamic workflows enabled (see /config). Valid options are: low, medium, high, xhigh, max, auto

같은 날 xhigh가 없는 claude-opus-4-6에서는 다음이 출력되었습니다. 이 경우는 xhigh를 지원하는 모델로 바꿔야 합니다.

Ultracode isn't available on claude-opus-4-6. Valid options are: low, medium, high, xhigh, max, auto

--effort ultracode 플래그로 시작했는데 이런 조건에 걸리면 오류로 멈추지 않습니다. 세션은 ultracode가 꺼진 채, 모델과 상한이 허용하는 가장 높은 수준(최대 xhigh)으로 시작하므로, 플래그를 썼다고 워크플로우가 켜졌다고 단정하지 마세요. 2026년 11월 3일 같은 mock 테스트에서도 CLAUDE_CODE_DISABLE_WORKFLOWS=1 상태로 --effort ultracode를 실행하자 xhigh는 전송되었지만 워크플로우 도구는 요청에서 빠져 있었습니다.

비슷한 이름과의 차이

Claude Code 모드 맵: high, xhigh, max, ultrathink, Ultracode, dynamic workflows, Ultraplan 비교

위 그림은 v2.1.284 이전 동작(Ultracode = xhigh + 워크플로우)을 기준으로 그린 것이며, 아래 표와 본문은 effort 수준과 별개인 현재 토글 동작을 기준으로 합니다.

Ultracode, xhigh, max, ultrathink, 동적 워크플로우, Ultraplan은 이름만 보면 모두 "더 강한 모드"처럼 보입니다. 하지만 비교 기준은 무엇을 제어하느냐입니다. high, xhigh, max는 effort 수준이고, Ultracode는 그 위에 얹는 단계가 아니라 수준과 따로 켜고 끄는 스위치입니다.

표면제어하는 것사용할 때피할 때
higheffort 수준. 일반적으로 높은 Claude Code 작업 품질.workflow 없이 품질을 높이고 싶을 때.독립 lane 검증이 필요할 때.
xhigheffort 수준.어렵지만 한 줄기의 추론으로 충분할 때.작업을 여러 lane으로 나눠야 할 때(이때는 Ultracode를 함께 켭니다).
max가장 높은 effort 수준.한 줄기의 추론에 최대 노력을 쓰고 싶을 때. Ultracode와 함께 켤 수 있습니다.실제로는 workflow가 필요한 경우.
ultrathink더 깊게 생각하라는 prompt 표현.한 번만 더 깊은 추론이 필요할 때.세션 수준 workflow 행동이 필요할 때.
Ultracodeautomatic workflow orchestration 켜기/끄기. effort 수준은 그대로.감사, 마이그레이션, 리서치, 반증, 검증.작은 수정이나 낮은 위험 작업.
Dynamic workflows오케스트레이션 runtime.workflow plan이나 lane 실행이 필요할 때.effort만 올리고 싶을 때.
Ultraplan계획 중심 경로.구현 전 계획이 필요할 때.자동 실행과 검증 lane이 필요할 때.

Ultracode와 max는 위아래 관계가 아니어서 "어느 쪽이 더 높은가"로 고르는 대상이 아닙니다. max는 모델이 요청 하나에 쓰는 추론 노력을 가장 크게 하는 effort 수준이고, Ultracode는 작업을 여러 lane의 워크플로우로 나눌지 정하는 스위치이므로, /effort max로 수준을 올린 뒤 /effort ultracode를 켜면 두 설정이 함께 적용됩니다. 비용이 늘어나는 이유도 다릅니다. max는 요청마다 추론이 길어져서, Ultracode는 워크플로우가 여러 서브에이전트와 단계를 돌려 요청 수가 늘어서 토큰을 더 씁니다. 다섯 단계 effort 수준이 각각 언제 맞는지는 Claude Code effort 설정과 차이: Opus 5.5 기본값 medium, 안 먹힐 때 해결을 보세요.

실제 문제가 context 과부하, 너무 많은 tool output, 정리되지 않은 MCP 설정이라면 Ultracode가 답이 아닐 수 있습니다. 그때는 Claude Code MCP context overload guide를 먼저 보세요. 반복 가능한 작업 규칙이 필요하면 Claude Code best skills, 외부 데이터와 실행 표면이 필요하면 Claude Code best MCP servers가 더 직접적인 해결책입니다.

안전한 prompt 예시

Ultracode prompt에는 자유와 경계를 함께 줘야 합니다. 목적, lane 구조, 편집 범위, 증거, 중단 조건이 있어야 합니다. 아래 예시 중 ultracode라는 단어가 들어간 것은 대화형 세션에 직접 입력하면 그 요청에 워크플로우가 시작되고, -p로 넘기면 키워드가 동작하지 않습니다.

read-only 감사:

Use an ultracode workflow for a read-only audit.
Map the risky areas first, split into independent verification lanes, and return findings with evidence.
Do not edit files. Stop if the task needs credentials, production data, or broad repo changes.

마이그레이션 pilot:

Use Ultracode for a migration pilot, not the full migration.
Pick one representative module, create the workflow plan, and ask before editing shared files.
Return the migration rule, the test command, and what would block scaling.

반례 검증:

Create a workflow with two lanes: one implements the candidate fix, one tries to disprove it.
Keep changes scoped to the named files.
Report the commands run, strongest counterexample, and whether the fix should proceed.

route 비교:

Use a workflow to compare the viable routes.
Each lane should own one route, cite its evidence, and state the stop condition.
Synthesize only after the lanes report back.

패턴은 같습니다. 작업, 경계, workflow 모양, 허용된 편집, 증거, stop condition. ownership이 분명하면 Ultracode는 강합니다. ownership이 흐리면 중간 결과만 늘어나고, 결정은 더 늦어집니다.

비용과 중단 규칙

Claude Code Ultracode 비용 제어 흐름: pilot scope, workflow monitoring, approval, stop, downgrade

동적 워크플로우는 더 많은 추론, 중간 결과, 검증, 종합을 만들기 때문에 token을 더 씁니다. 공식 workflows 문서도 ultracode를 켜면 각 요청이 더 많은 토큰을 쓰고 더 오래 걸린다고 설명합니다. 이것은 Ultracode가 나쁘다는 뜻이 아니라, 예산 규칙 없이 쓰면 위험하다는 뜻입니다.

켜져 있는 동안에는 평소의 안전장치 몇 가지가 빠진다는 점도 중단 규칙이 필요한 이유입니다. Large workflow 경고가 나오지 않고, Agent 도구로 띄운 서브에이전트에는 동시 실행 한도가 적용되지 않으며, auto 모드에서는 첫 워크플로우를 시작할 때 승인도 묻지 않습니다. 그래서 범위를 좁히고 멈추는 판단은 사람이 미리 정해 두어야 합니다.

권장 순서는 다음입니다.

  1. 가장 작은 대표 범위에서 시작합니다.
  2. 넓은 편집 전에 workflow plan을 요청합니다.
  3. lane이 목표에서 벗어나면 개입합니다.
  4. 공유 파일, 설정, migration, generated code 편집은 명시적으로 승인합니다.
  5. 새 증거가 없는 반복 탐색을 멈춥니다.
  6. 어려운 단계가 끝나면 /effort ultracode off로 끕니다. effort 수준을 high나 xhigh로 둘지는 따로 정합니다.

중단 규칙은 단순히 "토큰이 비싸다"는 말이 아닙니다. 엔지니어링 통제입니다. workflow가 결정보다 분기를 더 많이 만들면 멈춰야 합니다. 각 lane이 같은 주장만 반복하고 proof anchor를 늘리지 않으면 멈춰야 합니다. 작업이 탐색에서 구현으로 바뀌면 ultracode를 끄고 하나의 세션으로 접어 조심스럽게 끝내는 편이 낫습니다. effort 수준만 낮추는 것으로는 워크플로우가 멈추지 않는다는 점도 기억하세요.

usage limit이나 billing도 분리해서 해석해야 합니다. 구독 플랜에서는 ultracode가 쓰는 토큰이 사용 한도에서 차감되지만, Ultracode 이후 제한에 걸렸다고 해서 모드가 고장났다는 뜻은 아닙니다. 모드 선택, subscription, API key, provider, enterprise route, quota는 서로 다른 층입니다. 계정 층은 Claude Code API key vs subscription billing, Claude Code pricing guide, Claude Code usage limit issues를 따로 확인하는 것이 안전합니다.

문제 해결

증상별로 가장 가능성이 높은 원인과 먼저 확인할 것을 정리하면 다음과 같습니다. 사용 불가 메시지가 나왔다면 위 점검 목록의 원문 두 가지와 먼저 대조하세요.

증상가능성이 높은 원인첫 확인
/effort ultracode를 사용할 수 없음동적 워크플로우가 꺼져 있거나 모델이 xhigh를 지원하지 않음.needs dynamic workflows enabled면 /config, isn't available on이면 모델 변경.
/effort ultracode off가 Invalid argument로 실패v2.1.284 이전 CLI.claude --version 확인 후 업데이트.
Ultracode를 켰는데 effort가 xhigh가 아님v2.1.284부터의 정상 동작. 토글은 수준을 바꾸지 않음.필요하면 /effort xhigh로 수준을 따로 고르기.
설정은 있는데 workflow가 안 보임작업이 너무 작거나 순차적임.복잡한 감사나 검증 task로 확인.
--effort 또는 env effort가 안 맞음CLAUDE_CODE_EFFORT_LEVEL과 effortLevel은 ultracode를 받지 않음. v2.1.203 이전 CLI는 --effort ultracode에 Unknown --effort value 'ultracode'를 출력./effort ultracode, "ultracode": true, 또는 최신 CLI의 --effort ultracode.
껐는데 백그라운드나 클라우드 세션에서 다시 켜짐Ultracode로 시작한 세션이 다음 시작 때 다시 켜지던 버그. v2.1.316에서 수정.v2.1.316 이상으로 업데이트.
VS Code에서 Effort 슬라이더나 Ultracode 스위치가 안 보임모델 설정에 opus[1m]처럼 [1m] 태그가 붙어 있을 때의 버그. v2.1.316에서 수정.확장과 CLI 업데이트.
workflow가 너무 시끄러움task ownership이 너무 넓음.lane 분리, read-only 시작, stop condition 추가.
token 사용량이 빠르게 증가오케스트레이션이 작업량을 곱하고 있음.pilot, plan 검토, 반복 탐색 중단, /effort ultracode off.
어느 account가 비용을 내는지 모름mode choice와 billing route가 섞임.subscription, API key, provider, enterprise route 확인.
context가 무거워짐effort보다 tool output이 문제일 수 있음.MCP/tool surface 축소.

복구 방법은 또 다른 모드로 바꾸는 것이 아닙니다. 유용한 findings를 저장하고, workflow를 좁히고, 다음 하나의 결정으로 돌아갑니다. 로컬 백그라운드 세션을 보는 문제가 핵심이라면 Claude Code Agent View가 더 가까운 주제입니다.

자주 묻는 질문

Claude Code Ultracode는 새 모델인가요?

아니요. 동적 워크플로우 자동 오케스트레이션을 켜고 끄는 Claude Code 설정입니다. 쓰던 모델이 그대로 쓰이고, v2.1.284 이상에서는 effort 수준도 그대로입니다.

Ultracode를 켜면 effort 수준이 바뀌나요?

v2.1.284 이상에서는 /effort ultracode, 슬라이더 토글, "ultracode": true 설정 모두 effort 수준을 바꾸지 않습니다. 예외는 claude --effort ultracode(또는 Agent SDK effortLevel: "ultracode")로 시작할 때로, 이때만 xhigh가 함께 설정됩니다. v2.1.284 이전 버전에서는 켜면 항상 xhigh로 바뀌었습니다.

Ultracode 명령은 무엇인가요?

Claude Code 안에서 /effort ultracode로 켜고 /effort ultracode off로 끕니다. 시작할 때부터 켜려면 claude --effort ultracode를 쓰며, 이 경우 effort는 xhigh가 됩니다. 한 작업만 workflow로 처리하려면 직접 입력하는 prompt에 ultracode라는 단어를 넣고 세션 전체는 그대로 둘 수 있습니다.

어떤 버전이 필요한가요?

동작마다 다릅니다. 켜도 effort가 바뀌지 않는 토글 동작과 /effort ultracode off는 Claude Code v2.1.284 이상, --effort ultracode 플래그는 v2.1.203 이상이 필요합니다. 2026년 11월 3일 기준 npm stable은 2.1.309, latest는 2.1.316입니다. claude --version으로 로컬 CLI를 확인하세요.

Ultracode와 xhigh의 차이는 무엇인가요?

xhigh는 effort 수준이고, Ultracode는 동적 워크플로우 자동 오케스트레이션을 켜는 스위치입니다. v2.1.284 이전에는 Ultracode를 켜면 xhigh가 함께 설정되었지만 지금은 그렇지 않습니다. 한 줄기의 어려운 문제는 xhigh, 여러 lane이 필요한 문제는 Ultracode이고, 둘 다 필요하면 둘 다 켭니다.

Ultracode와 max는 어떻게 다른가요?

max는 가장 높은 effort 수준이고, Ultracode는 effort와 별개인 워크플로우 스위치라서 어느 쪽이 위인 관계가 아닙니다. /effort max와 /effort ultracode를 함께 켤 수 있으며, 그러면 요청마다 추론이 길어지는 비용과 워크플로우로 요청 수가 늘어나는 비용이 겹칩니다.

Ultracode는 비용이 더 드나요?

그럴 수 있습니다. 공식 workflows 문서는 ultracode를 켜면 각 요청이 더 많은 토큰을 쓰고 더 오래 걸리며, 구독 플랜에서는 그 토큰이 사용 한도에서 차감된다고 설명합니다. 작은 pilot, plan 검토, 반복 탐색 중단, 작업 후 /effort ultracode off를 사용하세요.

Ultracode가 보이지 않는 이유는 무엇인가요?

동적 워크플로우가 꺼져 있거나(Pro는 /config에서 켬), 모델이 xhigh를 지원하지 않는 경우가 대부분입니다. CLI 버전, plan/provider/admin 설정, 오래된 세션 상태도 확인하세요. CLAUDE_CODE_EFFORT_LEVEL과 저장되는 effortLevel은 ultracode 값을 받지 않습니다.

항상 Ultracode를 켜두어도 되나요?

설정 파일에 "ultracode": true를 넣으면 모든 세션이 켜진 채로 시작하지만, 대부분은 권하지 않습니다. 감사, migration pilot, verification pass, multi-route research처럼 오케스트레이션이 비용을 정당화하는 동안만 켜고, 끝나면 /effort ultracode off로 끕니다.

Ultracode와 dynamic workflows는 같은 건가요?

같지 않습니다. Dynamic workflows는 오케스트레이션 runtime입니다. Ultracode는 그 runtime을 실질적인 작업마다 자동으로 사용하게 하는 Claude Code 설정이며, effort 수준은 바꾸지 않습니다.

결론

Claude Code Ultracode의 가치는 단순히 더 오래 생각하는 데 있지 않습니다. 더 오래 생각하게 하는 것은 effort 수준이고, Ultracode는 여러 lane의 작업을 증거 중심으로 조정해야 할 때 켜는 스위치입니다. 감사, 마이그레이션, 리서치, 반증, 검증에는 유용하지만, 일상적인 작은 편집에 계속 켜둘 설정은 아닙니다.

순서는 명확합니다. CLI 버전과 동적 워크플로우 활성 여부를 확인하고, 오케스트레이션이 비용을 정당화하는 작업에서만 /effort ultracode를 켜고, 작은 pilot부터 시작하고, workflow plan을 검토하고, 넓은 편집은 직접 승인하고, 무거운 단계가 끝나면 /effort ultracode off로 끄세요. effort 수준은 이와 별개로 작업에 맞게 고릅니다.

참고 자료2

이 글이 링크한 외부 페이지를 본문에 나온 순서대로 정리했습니다. 마지막 업데이트: 2026년 11월 3일.

  1. 1.Claude Code 공식 workflows 문서code.claude.com/docs/en/workflows
  2. 2.Claude Code 모델 설정 문서code.claude.com/docs/en/model-config