2026년 6월 3일 기준으로 Claude Code Ultracode는 새 모델이 아닙니다. Claude Code의 세션 설정이며, 모델에는 xhigh effort를 보내고, 실질적인 작업에서는 Claude Code가 dynamic workflows를 자동으로 오케스트레이션할 수 있게 합니다.
명령은 /effort ultracode입니다. 다만 이 설정은 모든 작업을 더 좋게 만드는 버튼이 아닙니다. 대규모 감사, 마이그레이션 pilot, 여러 가설 비교, 반례 검증, 넓은 리서치처럼 여러 lane이 독립적인 근거를 만들어야 할 때 쓸 가치가 있습니다. 한 파일 수정, 명확한 리팩터링, 이미 순서가 정해진 작은 작업에서는 high나 xhigh가 더 안전합니다.
| 지금 하려는 작업 | 먼저 쓸 경로 | 경계 |
|---|---|---|
| 대규모 감사, 마이그레이션, 다중 가설 검증 | /effort ultracode | 먼저 read-only 또는 작은 pilot을 돌리고, 넓은 편집은 plan 확인 후 승인합니다. |
| 일반 세션 안에서 한 번만 무거운 workflow가 필요함 | prompt에서 이번 작업만 ultracode workflow로 요청 | 세션 전체를 계속 고비용 모드로 두지 않습니다. |
| 한 파일 수정, 기계적 변경, 명확한 작은 리팩터링 | high 또는 xhigh | workflow 오케스트레이션은 오히려 소음과 비용이 될 수 있습니다. |
| Ultracode가 보이지 않거나 동작이 다름 | claude --version, workflows, xhigh 지원 모델, plan/provider/admin 설정 확인 | --effort, 환경 변수, effortLevel을 대체 스위치로 쓰지 않습니다. |
켜기 전에 중단 규칙을 정해야 합니다. 작은 범위에서 먼저 시험하고, workflow plan을 본 뒤 편집을 승인하고, 각 lane이 새 근거를 만드는지 확인하고, 반복 탐색이 시작되면 멈추고, 무거운 작업이 끝나면 high나 xhigh로 되돌립니다. 이 규칙이 없으면 Ultracode는 생산성 기능이 아니라 토큰과 리뷰 작업을 늘리는 설정이 됩니다.
빠른 답
Ultracode는 Claude Code의 어려운 작업용 세션 설정입니다. 핵심은 두 가지입니다. 첫째, 모델 effort를 xhigh로 보냅니다. 둘째, 작업이 충분히 크면 Claude Code가 dynamic workflows를 구성해 여러 lane으로 조사, 구현, 반증, 검증을 나눌 수 있습니다.
Claude Code 안에서 가장 짧은 명령은 다음입니다.
text/effort ultracode
이번 작업 하나만 workflow로 처리하고 싶다면 세션 전체를 바꾸지 않아도 됩니다.
textUse an ultracode workflow for this task. First create the workflow plan, keep edits scoped, and stop after verification.
버전 확인은 반드시 해야 합니다. Anthropic의 Claude Code dynamic workflows 문서는 dynamic workflows에 Claude Code v2.1.154 이상이 필요하다고 설명합니다. 이번 2026년 6월 3일 확인에서 npm view @anthropic-ai/claude-code version dist-tags --json은 latest와 next를 2.1.161로, stable을 2.1.150으로 반환했습니다. stable처럼 보이는 경로도 문서상 workflow 최소 버전보다 낮을 수 있다는 뜻입니다. 이름이 아니라 설치된 CLI를 확인하세요.
bashclaude --version npm view @anthropic-ai/claude-code version dist-tags --json
팀에서 사용할지 결정할 때는 먼저 작업의 모양을 봅니다. Ultracode는 여러 lane이 서로 다른 증거를 만드는 작업에서 강합니다. 예를 들어 한 lane은 후보 수정안을 만들고, 다른 lane은 반례를 찾고, 또 다른 lane은 테스트와 문서 경계를 검증할 수 있습니다. 반대로 작업이 작거나, 모든 판단이 하나의 추론 흐름에 묶여 있거나, 리뷰 예산이 빡빡하면 더 작은 모드가 낫습니다.
Ultracode가 실제로 바꾸는 것
가장 중요한 구분은 모델과 설정입니다. Claude Code Ultracode라는 이름 때문에 별도 모델을 고른다고 생각하기 쉽지만, 실제로는 Claude Code 설정입니다. 이 설정이 xhigh effort를 모델에 보내고, Claude Code가 실질적인 작업에서 dynamic workflows를 오케스트레이션할 수 있게 합니다.
xhigh는 모델의 추론 강도입니다. 어려운 문제에 더 많은 노력을 쓰게 합니다. Ultracode는 여기에 workflow 권한을 더합니다. Claude Code는 작업을 lane으로 나누고, 각 lane에서 조사, 비교, 구현, 반증, 검증, 종합을 수행할 수 있습니다. 그래서 “AI가 팀을 꾸린다”는 느낌을 줄 수 있지만, 실무적으로는 “비용이 큰 오케스트레이션 권한”이라고 보는 편이 안전합니다.
| 바뀌는 항목 | 실제 영향 | 독자가 할 일 |
|---|---|---|
xhigh effort | 모델이 어려운 추론에 더 많은 노력을 씁니다. | 품질 리스크가 비용을 정당화할 때만 사용합니다. |
| dynamic workflow orchestration | Claude가 작업 lane을 나누고 비교 또는 검증합니다. | 독립 검증이나 병렬 증거가 필요할 때 사용합니다. |
| 세션 범위 | /effort ultracode는 현재 세션에 적용됩니다. | 어려운 작업 후에는 낮춥니다. |
| workflow plan | Claude가 여러 단계의 계획을 제안하거나 실행할 수 있습니다. | 넓은 편집 전 plan을 검토합니다. |
안전한 기준은 단순합니다. 오케스트레이션이 비용을 벌어야 합니다. lane 분할, 독립 검증, 넓은 탐색이 필요하지 않다면 high나 xhigh가 더 깔끔합니다. 강한 이름 때문에 항상 켜두면, 파일 변경 범위, 리뷰 부담, 토큰 사용량, 대기 시간이 함께 커집니다.
켜는 방법
일반적인 Claude Code 사용자는 세션 안에서 이 명령을 사용합니다.
text/effort ultracode
설정 파일 경로나 Agent SDK control request도 있지만, 그것은 별도의 운영 방식입니다. 터미널에서 Claude Code를 쓰는 대부분의 경우에는 /effort ultracode가 시작점입니다. SDK로 세션을 제어하는 제품을 만들고 있다면 그때 SDK route를 고려하면 됩니다.
| 제어 방식 | Ultracode용으로 사용? | 이유 |
|---|---|---|
/effort ultracode | 예 | 직접적인 세션 설정입니다. |
| prompt에서 한 번만 ultracode workflow 요청 | 예 | 세션 전체를 고비용 모드로 바꾸지 않습니다. |
--settings '{"ultracode": true}' | 필요한 경우 예 | 의도적인 설정 경로로 다룹니다. |
| Agent SDK control request | SDK 세션이면 예 | 이미 SDK로 세션을 제어할 때만 필요합니다. |
--effort | 대체 스위치 아님 | Ultracode의 문서화된 제어 경로가 아닙니다. |
CLAUDE_CODE_EFFORT_LEVEL | 대체 스위치 아님 | effort 환경 변수는 Ultracode와 동일하지 않습니다. |
effortLevel | 대체 스위치 아님 | Ultracode는 단순한 모델 effort 필드가 아닙니다. |
한 번만 workflow가 필요하다면 prompt에서 명시적으로 요청하세요. 이렇게 하면 다음 작은 편집이나 확인까지 모두 Ultracode 경로에 들어가는 것을 피할 수 있습니다.
보이지 않을 때 점검 목록
Ultracode가 보이지 않거나 workflow 동작이 시작되지 않는다면 기본 항목부터 확인합니다.
claude --version을 실행합니다.- 현재 dynamic workflows 문서의 최소 CLI 버전 이상인지 확인합니다.
- 현재 Claude Code 경로에서 workflows가 활성화되어 있는지 봅니다. Pro 사용자는
/config, 관리형 환경은 admin 설정도 확인할 수 있습니다. - 선택한 모델 경로가
xhigh를 지원하는지 확인합니다. - plan, provider, enterprise 설정, feature availability를 확인합니다.
- 설정 변경 후 세션을 재시작합니다.
지원되지 않는 knob을 늘리면 문제가 더 흐려집니다. --effort, CLAUDE_CODE_EFFORT_LEVEL, effortLevel이 다른 행동을 바꾸는 것처럼 보여도, 그것이 Ultracode의 정식 스위치가 되지는 않습니다. 진단은 공식 설정과 버전 경계에 묶어야 합니다.
이번 package tag 차이는 좋은 예입니다. 확인 당시 stable은 2.1.150으로 workflow 최소 요구보다 낮았고, latest는 2.1.161이었습니다. 이것은 특정 tag를 영원히 믿으라는 뜻이 아닙니다. 기능이 빠르게 바뀌는 시기에는 설치된 CLI와 현재 문서를 같은 날 확인해야 한다는 뜻입니다.
비슷한 이름과의 차이
Ultracode, xhigh, ultrathink, dynamic workflows, Ultraplan은 이름만 보면 모두 “더 강한 모드”처럼 보입니다. 하지만 비교 기준은 무엇을 제어하느냐입니다.
| 표면 | 제어하는 것 | 사용할 때 | 피할 때 |
|---|---|---|---|
high | 일반적으로 높은 Claude Code 작업 품질. | workflow 없이 품질을 높이고 싶을 때. | 독립 lane 검증이 필요할 때. |
xhigh | 모델 effort. | 어렵지만 한 줄기의 추론으로 충분할 때. | 자동 workflow 오케스트레이션이 필요할 때. |
max | 지원되는 경로의 최대 effort 또는 모델 route. | 그 effort route를 명시적으로 선택할 때. | 실제로는 workflow가 필요한 경우. |
ultrathink | 더 깊게 생각하라는 prompt 표현. | 한 번만 더 깊은 추론이 필요할 때. | 세션 수준 workflow 행동이 필요할 때. |
| Ultracode | xhigh와 automatic workflow orchestration. | 감사, 마이그레이션, 리서치, 반증, 검증. | 작은 수정이나 낮은 위험 작업. |
| Dynamic workflows | 오케스트레이션 runtime. | workflow plan이나 lane 실행이 필요할 때. | effort만 올리고 싶을 때. |
| Ultraplan | 계획 중심 경로. | 구현 전 계획이 필요할 때. | 자동 실행과 검증 lane이 필요할 때. |
실제 문제가 context 과부하, 너무 많은 tool output, 정리되지 않은 MCP 설정이라면 Ultracode가 답이 아닐 수 있습니다. 그때는 Claude Code MCP context overload guide를 먼저 보세요. 반복 가능한 작업 규칙이 필요하면 Claude Code best skills, 외부 데이터와 실행 표면이 필요하면 Claude Code best MCP servers가 더 직접적인 해결책입니다.
안전한 prompt 예시
Ultracode prompt에는 자유와 경계를 함께 줘야 합니다. 목적, lane 구조, 편집 범위, 증거, 중단 조건이 있어야 합니다.
read-only 감사:
textUse 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:
textUse 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.
반례 검증:
textCreate 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 비교:
textUse 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이 흐리면 중간 결과만 늘어나고, 결정은 더 늦어집니다.
비용과 중단 규칙
Dynamic workflows는 더 많은 추론, 중간 결과, 검증, 종합을 만들 수 있기 때문에 token을 더 쓸 수 있습니다. 이것은 Ultracode가 나쁘다는 뜻이 아니라, 예산 규칙 없이 쓰면 위험하다는 뜻입니다.
권장 순서는 다음입니다.
- 가장 작은 대표 범위에서 시작합니다.
- 넓은 편집 전에 workflow plan을 요청합니다.
- lane이 목표에서 벗어나면 개입합니다.
- 공유 파일, 설정, migration, generated code 편집은 명시적으로 승인합니다.
- 새 증거가 없는 반복 탐색을 멈춥니다.
- 어려운 단계가 끝나면
high나xhigh로 돌아갑니다.
중단 규칙은 단순히 “토큰이 비싸다”는 말이 아닙니다. 엔지니어링 통제입니다. workflow가 결정보다 분기를 더 많이 만들면 멈춰야 합니다. 각 lane이 같은 주장만 반복하고 proof anchor를 늘리지 않으면 멈춰야 합니다. 작업이 탐색에서 구현으로 바뀌면 하나의 세션으로 접어 조심스럽게 끝내는 편이 낫습니다.
usage limit이나 billing도 분리해서 해석해야 합니다. 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를 사용할 수 없음 | CLI 또는 workflow feature가 필요한 경계보다 낮음. | claude --version, 현재 문서, package tag. |
| 설정은 있는데 workflow가 안 보임 | 작업이 너무 작거나 순차적임. | 복잡한 감사나 검증 task로 확인. |
--effort 또는 env effort가 안 맞음 | 그것들은 Ultracode control이 아님. | /effort ultracode 또는 문서화된 settings path로 돌아가기. |
| workflow가 너무 시끄러움 | task ownership이 너무 넓음. | lane 분리, read-only 시작, stop condition 추가. |
| token 사용량이 빠르게 증가 | 오케스트레이션이 작업량을 곱하고 있음. | pilot, plan 검토, 반복 탐색 중단. |
| 어느 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 설정입니다. 모델에는 xhigh effort가 전달되고, Claude Code는 실질적인 작업에서 dynamic workflows를 오케스트레이션할 수 있습니다.
Ultracode 명령은 무엇인가요?
Claude Code 안에서 /effort ultracode를 사용합니다. 한 작업만 workflow로 처리하려면 prompt에서 ultracode workflow를 요청하고 세션 전체는 그대로 둘 수 있습니다.
어떤 버전이 필요한가요?
공식 workflow 문서는 Claude Code v2.1.154 이상을 요구합니다. 2026년 6월 3일 확인에서는 npm latest가 2.1.161, stable이 2.1.150이었습니다. claude --version으로 로컬 CLI를 확인하세요.
Ultracode와 xhigh의 차이는 무엇인가요?
xhigh는 모델 effort입니다. Ultracode는 xhigh를 보내면서 Claude Code가 dynamic workflows를 자동 오케스트레이션할 수 있게 합니다. 한 줄기의 어려운 문제는 xhigh, 여러 lane이 필요한 문제는 Ultracode입니다.
Ultracode는 비용이 더 드나요?
그럴 수 있습니다. higher effort, workflow lane, 중간 추론, 검증 출력이 늘어나기 때문입니다. 작은 pilot, plan 검토, 반복 탐색 중단, 작업 후 downgrade를 사용하세요.
Ultracode가 보이지 않는 이유는 무엇인가요?
CLI version, workflow enablement, xhigh 지원, plan/provider/admin 설정, 오래된 세션 상태를 확인하세요. --effort, env effort, effortLevel을 대체 스위치로 쓰지 마세요.
항상 Ultracode를 켜두어도 되나요?
대부분은 아닙니다. 감사, migration pilot, verification pass, multi-route research처럼 오케스트레이션이 비용을 정당화하는 동안만 켜고, 끝나면 high나 xhigh로 낮춥니다.
Ultracode와 dynamic workflows는 같은 건가요?
같지 않습니다. Dynamic workflows는 오케스트레이션 runtime입니다. Ultracode는 그 runtime을 자동으로 사용할 수 있게 하는 Claude Code 설정이며, 동시에 xhigh effort를 사용합니다.
결론
Claude Code Ultracode의 가치는 단순히 더 오래 생각하는 데 있지 않습니다. 여러 lane의 작업을 증거 중심으로 조정해야 할 때 강합니다. 감사, 마이그레이션, 리서치, 반증, 검증에는 유용하지만, 일상적인 작은 편집에 계속 켜둘 모드는 아닙니다.
순서는 명확합니다. 버전과 workflow route를 확인하고, 오케스트레이션이 비용을 정당화하는 작업에서만 /effort ultracode를 켜고, 작은 pilot부터 시작하고, workflow plan을 검토하고, 넓은 편집은 직접 승인하고, 무거운 단계가 끝나면 더 작은 모드로 돌아가세요.