저는 작업하는 내용에 따라 Claude Code에서 몇 가지 항목을 계속 변경합니다. 오랜 리팩토링 작업을 할 때는 저렴하고 조용하게 작동합니다. 실제로 문제가 어려울 때는 가장 유능한 모델과 최대 노력을 투입합니다. 다른 사람의 저장소에서 작업할 때는 모든 것에 먼저 질문하도록 합니다. 이들은 서로 다른 장소에 있는 다른 값들이었고, 저는 매번 수동으로 편집했습니다.
Ultra Config는 제가 만든 모드(Mod)로, 이를 한 번의 클릭만으로 처리할 수 있게 해줍니다.
// Detect dark theme var iframe = document.getElementById('tweet-2111558707033018828-99'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=2111558707033018828&theme=dark" }
다섯 가지 프로필, 한 번의 클릭으로 전환하기
각 프로필은 설정 목록과 그 이유가 첨부되어 있습니다. 이들이 설정하는 내용은 다음과 같습니다:
- Token saver: 모델
sonnet, 노력(effort) low, 서브 에이전트(subagents)는 haiku 사용, 간결한 출력(Concise output), 프롬프트 제안이나 요약 없음, 자동 압축(auto-compact) 켜기, 작은 워크플로우 분산(small workflow fan-outs), ultracode 키워드 끄기, MCP 출력을 10,000 토큰으로 제한 (기본값은 25,000).
- Fast flow: 모델
sonnet, 노력(effort) medium, 편집 자동 승인(edits auto-accepted), 간결한 출력(Concise output), 프롬프트 제안 켜기, 턴 지속 시간 및 진행 표시줄 켜기, 중간 워크플로우.
- Max quality: 사용 가능한 가장 유능한 모델, 노력(effort)
xhigh, 서브 에이전트는 요청하는 모든 모델 유지, 기본 출력 스타일, 큰 분산(large fan-outs)과 ultracode 키워드가 활성화된 워크플로우, 체크포인트 및 자동 압축 켜기.
- Guarded: 모든 편집 및 명령어에 먼저 질문함, 계획 모드(plan mode)는 스스로 행동하지 않음,
bypassPermissions 비활성화, .env, secrets/, ~/.ssh, ~/.aws에 대한 읽기 거부 규칙(Read deny rules), 체크포인트 켜기, 상세 출력(verbose output), ultracode 끄기.
- Autopilot: 계획 중에도 포함되는 자동 권한 모드(auto permission mode), 노력(effort)
high, 워크플로우 켜기, 요약(recap) 켜기, Claude가 무언가를 결정하거나 도움이 필요할 때 푸시 알림 전송, 자동 압축 켜기.
패널에는 현재 프로필이 얼마나 적용되었는지 분수(예: 3/11)로 표시하며, 모두 적용되면 활성화된 것으로 표시합니다. 프로필을 열면 모든 줄은 변경 사항(구 값에 취소선, 새 값 및 이유), 이미 설정된 항목 또는 건너뛴 항목 중 하나입니다.
Token saver는 제가 가장 많이 사용하는 기능이며, 이것이 무엇인지 알아두는 것이 가치가 있습니다. 바로 지난주에 게시했던 것과 동일한 모델 분할 방식이지만, 별도의 설정을 설치할 필요가 없습니다.
// Detect dark theme var iframe = document.getElementById('tweet-2108687263043575923-831'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=2108687263043575923&theme=dark" }
설치 및 패널 열기
npx claude-code-templates@latest --mod productivity/ultra-config
Claude Code 2.1.287 이상 버전이 필요하며, 이 버전부터는 Mods가 기본적으로 활성화되고 신뢰할 수 있는 프로젝트 폴더가 필요합니다.
Ultra Config
그다음 다음 명령어를 사용합니다:
/ultra-config를 입력하면 패널이 열립니다./ultra-config <프로필>을 입력하면 특정 프로필(saver, flow, quality, guarded, autopilot)로 열립니다./ultra-config apply <프로필>을 입력하면 해당 프로필을 활성화하고 변경된 내용과 건너뛴 내용을 출력합니다./ultra-config undo를 입력하면 마지막으로 활성화한 프로필을 역순(가장 최신 순)으로 되돌립니다./ultra-config close를 입력하면 패널이 닫힙니다.
패널의 모든 것은 메뉴가 아니라 누름(press)입니다. 탭이나 화살표 키 탐색 기능이 없다는 점이 중요한데, 이는 Claude Code가 이미 왼쪽 화살표를 자체 에이전트 보기용으로 사용하고 있기 때문입니다.
전체 화면 레이아웃에서는 패널이 스크립트 옆에 도킹되며, 이를 위해서는 /tui fullscreen과 최소 110열이 필요합니다. 클래식 레이아웃에서는 프롬프트 위에 위치합니다. Claude Desktop에서는 세션의 사이드 패널에 그려집니다.
// Detect dark theme var iframe = document.getElementById('tweet-2111624442413756446-753'); if (document.body.className.includes('dark-theme')) { iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=2111624442413756446&theme=dark" }
변경 사항이 실제로 적용되는 위치
무언가가 여러분의 설정을 덮어쓰게 하기 전에 이해할 가치가 있는 부분입니다.
Claude Code 자체 설정 메뉴에 존재하는 모델, 권한 모드, 출력 스타일 또는 자동 압축과 같은 행들은 메뉴가 사용하는 경로를 통해 설정됩니다. Claude Code는 마치 사용자가 직접 변경한 것처럼 어떤 파일에 해당 값들이 들어갈지 결정합니다.
/effort가 저장하는 방식처럼, 노력(effort)은 모델별로 저장되며 ~/.claude/settings.json의 modelSettings 아래에 있습니다. 이 키 지정이 중요합니다: Claude Code 2.1.251 버전 이후로는 최상위 레벨의 effortLevel이 Opus 5.5 및 그 이후 모델에서는 무시되므로, 모드(Mod)는 이를 절대로 작성하지 않습니다. Bedrock과 Vertex에서 얻을 수 있는 점(dot)을 포함하는 모델 ID는 이런 방식으로 저장될 수 없으며, 노력은 오직 해당 요청에만 적용됩니다.
네 개의 키는 메뉴 행이 없기 때문에 ~/.claude/settings.json에 직접 작성됩니다:
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
...
각각의 쓰기 작업 전에 파일은 settings.json.ultra-config.bak로 복사되고, 유효하지 않은 JSON인 settings.json은 절대 덮어쓰지 않습니다: 이러한 단계들은 건너뛰어지고 패널에 그 이유가 표시됩니다. 마지막 20개의 활성화 기록은 플러그인의 스토어에 보관되므로, 재시작 후에도 여전히 undo 기능이 작동하여 변경했던 값을 되돌리고, 이미 가지고 있던 거부 규칙(deny rule)은 그대로 유지합니다.
프로필을 신뢰하기 전에 확인할 사항
- Guarded가 쉘(shell)의 읽기 작업은 막지 못합니다. 이 규칙이 추가하는 것은
Read() 규칙이며, Read 거부 규칙은 Claude의 파일 도구는 차단하지만, 같은 파일을 읽는 쉘 명령어 자체를 막지는 못합니다. Mod 개발자의 README에 명확히 나와 있으며, 대부분의 컴포넌트보다 더 자세한 내용이지만, 사람들이 거부 규칙(deny rules)에 대해 잘못 이해하는 부분입니다.
- 서브 에이전트 모델은 Explore 및 Plan까지 도달하지 않습니다.
CLAUDE_CODE_SUBAGENT_MODEL 자체만으로는 내장된 Explore 및 Plan 서브 에이전트가 실행되는 모델을 변경하지 못합니다. 만약 Token saver의 haiku를 모든 서브 에이전트에 적용하고 싶다면, 2.1.257 이상 버전에서 필요한 CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1도 설정해야 합니다.
- 다음 세션에서만 효과가 있는 키가 두 가지 있습니다.
CLAUDE_CODE_SUBAGENT_MODEL과 MAX_MCP_OUTPUT_TOKENS는 Claude Code가 시작될 때 읽힙니다. 메뉴 행(menu rows)은 즉시 적용되고 노력(effort)은 다음 메시지부터 적용되지만, 이 두 가지는 그렇지 않습니다.
- disableBypassPermissionsMode도 사용자를 차단합니다. 이것은 문자열 `
• Twitter (영어): https://x.com/dani_avila7
• LinkedIn (스페인어): https://www.linkedin.com/in/daniel-avila-arias/
• Youtube (스페인어): https://www.youtube.com/@daniiielsan
• Instagram (스페인어): https://www.instagram.com/danielsan_avila/
