Claude Code, 아직 기본 상태 그대로 사용하고 계신가요?

2026년 6월, Anthropic은 폭풍 같은 출시 랠리를 감행했습니다. v2.1.160 ~ v2.1.169까지 불과 1주일 만에, **수수하지만 효과적인 「숨겨진 기능」**이 대량으로 추가되었습니다.

게다가 이 기능들 중 상당수는 공식 블로그의 메인에서 크게 다뤄지지 않고, Changelog의 구석에 조용히 적혀 있을 뿐입니다. 아는 사람만이 이득을 보는 상태입니다.

--safe-mode로 커스터마이징을 전부 무효화한 안전 모드 실행 가능 (트러블슈팅이 순식간에 해결) -
/cd로 프롬프트 캐시 (Prompt Cache)를 깨뜨리지 않고 작업 디렉토리 이동 가능 -
fallbackModel로 모델 과부하 시 자동 페일오버 (Failover) 가능 (중단 방지) -
MAX_THINKING_TOKENS=0으로 thinking을 완전히 OFF 하여 응답 속도 폭발적 향상 - 다이내믹 워크플로우의 트리거가 workflow →로 변경됨 (주의 필요) ultracode

본 기사는 2026년 5월 말 ~ 6월 초의 Changelog (v2.1.160 ~ v2.1.169)를 바탕으로 합니다. Claude Code는 터미널, VS Code, JetBrains, 데스크톱 앱, Web에서 동작하며, 모든 환경이 대상입니다.

v2.1.169 (6월 9일)에서 추가된, 트러블슈팅 전용 실행 플래그입니다.

--safe-mode를 붙여 실행하면, 설정 파일, 커스텀 스킬, 훅 (Hook), MCP 서버, 커스텀 슬래시 명령어 등 모든 커스터마이징을 무효화한 '순수 상태'로 Claude Code가 실행됩니다.

"갑자기 Claude Code가 이상하게 동작한다", "훅이 원인인지, MCP가 원인인지 모르겠다" —— 이런 경우, 기존에는 설정 파일을 하나씩 주석 처리하며 제거해 나가는 지옥 같은 원인 파악 작업이 필요했습니다.

--safe-mode라면, 순수 상태에서 재현되는지 확인하는 것만으로 "커스터마이징에 의한 문제인지"를 단 한 번의 명령어로 판정할 수 있습니다. 재현되지 않는다면, 범인은 당신의 설정 안에 있습니다.

# 모든 커스터마이징을 무효화하여 실행
claude --safe-mode
# 「safe-mode에서는 정상」이라면, 원인은 자신의 설정 파일 쪽에 있음

원인 파악의 철칙: "순수 상태에서 재현되지 않는다면, 자신의 설정을 의심하라". --safe-mode는 이 철칙을 단 하나의 명령어로 만들어 줍니다.

마찬가지로 v2.1.169에서 추가된, 수수하지만 매우 실용적인 세션 내 명령어입니다.

/cd <path>를 통해, 세션을 종료하지 않고 작업 디렉토리를 전환할 수 있습니다. 포인트는 "프롬프트 캐시 (Prompt Cache)를 깨뜨리지 않는다"는 것입니다.

지금까지 작업 디렉토리를 바꾸고 싶을 때는, 일단 Claude Code를 종료하고 다른 디렉토리에서 다시 실행해야 했습니다. 그러면 그때까지 쌓아온 프롬프트 캐시가 전부 날아갑니다. 긴 세션에서는 이것이 비용과 레이턴시 (Latency) 양면에서 무시할 수 없는 손실이었습니다.

/cd를 사용하면, 모노레포 (Monorepo) 내의 서브 프로젝트 간을 오가거나, 메인 작업 도중에 옆의 리포지토리를 살짝 들여다보는 등의 조작을 캐시를 보존한 채로 할 수 있습니다.

# 세션 중에 그대로 입력
/cd ../another-service
# 모노레포의 패키지 간 이동도 순식간
...

v2.1.166 (6월 6일)에서 추가된 설정입니다. 가용성을 높이는 중요한 기능입니다.

settings.json에 fallbackModel을 지정해 두면, 프라이머리 모델 (Primary Model)이 과부하 (Overloaded) 상태일 때, 자동으로 다른 모델로 전환하여 처리를 계속해 줍니다.

Opus 4.8은 기본적으로 high effort (고부하 사고)로 동작하기 때문에, 피크 시간대에는 과부하 에러가 발생할 수 있습니다. 장시간의 에이전트 작업 도중에 overloaded로 멈추면, 그때까지의 문맥이 낭비될 수 있습니다.

fallbackModel을 설정해 두면, **"메인은 Opus, 혼잡할 때는 Sonnet으로 계속"**과 같은 구성을 자동화할 수 있어, 작업이 도중에 중단되는 것을 방지할 수 있습니다.

{
"model": "claude-opus-4-8",
"fallbackModel": "claude-sonnet-4-6"
...
}

무인으로 실행하는 스케줄 실행이나 CI 파이프라인에서는 fallbackModel의 유무가 '완주율'에 직결됩니다. 자동화 사용자라면 반드시 설정하세요.

이것 또한 v2.1.166에서 추가되었습니다. 속도와 비용을 컨트롤하기 위한 노브(knob)입니다.

환경 변수 MAX_THINKING_TOKENS=0을 지정하면, 확장 사고 (extended thinking)를 완전히 무효화할 수 있습니다. 나아가, 모델마다 thinking의 온/오프를 전환하는 설정도 지원됩니다.

thinking은 난제에서는 강력하지만, **정형화된 작업·짧은 편집·정리 태스크에서는 오버킬 (overkill)**입니다. 사고 토큰을 소비하는 만큼 느려지고 비용도 높아집니다.

"간단한 리팩토링을 대량으로 돌리고 싶다"거나 "어쨌든 응답 속도를 빠르게 하고 싶다"는 상황에서는, thinking을 끔으로써 체감 속도를 크게 높일 수 있습니다.

# thinking을 완전히 끄고 실행
MAX_THINKING_TOKENS=0 claude

// settings.json에서 모델별로 제어하는 예시
{
"env": {
...

어려운 설계·디버깅·대규모 리팩토링의 '계획' 단계에서는 thinking이 효과적입니다. 항상 꺼두는 것이 아니라, 태스크의 성격에 따라 구분해서 사용하는 것이 정답입니다.

v2.1.160 (6월 4일)에서의 변경 사항입니다. 모르면 "작동 안 해!"라며 혼란을 겪게 될 지뢰 포인트입니다.

수십~수백 개의 에이전트를 오케스트레이션하는 **다이내믹 워크플로우 (dynamic workflow)**의 실행 키워드가 workflow에서 ultracode로 변경되었습니다.

기존의 기사나 메모를 보고 workflow라고 입력해도 더 이상 작동하지 않습니다. "전에는 됐는데 왜 안 되지?"라며 헤매는 사람이 속출할 변경입니다. 대규모 코드베이스 마이그레이션이나 일괄 처리를 실행할 때는 새로운 키워드를 사용하세요.

# 구 버전: workflow ...
# 신 버전: ultracode로 실행
ultracode 이 모노레포 전체를 TypeScript로 변환하고, 테스트도 통과시켜줘

5가지 기능 외에도 놓칠 수 없는 개선 사항들이 포함되어 있습니다.

번들로 제공되는 표준 스킬을 모델의 선택지에서 제외할 수 있는 설정입니다. 자체 스킬만 사용하게 하고 싶을 때 노이즈를 줄일 수 있습니다.

{
"disableBundledSkills": true
}

쉘 실행 파일 (.zshrc 등)이나 설정 디렉토리에 쓰기 전에 확인 프롬프트를 띄우도록 변경되었습니다. 의도치 않은 환경 변경을 방지하는 안전장치입니다.

deny 규칙에서 더 넓은 glob 패턴을 사용할 수 있게 되어 권한 제어가 유연해졌습니다. 더불어 세션 간 메시징 보안도 강화되었습니다.

{
"permissions": {
"deny": ["Read(./secrets/**)", "Read(**/.env*)"]
...

사소하지만, 스트리밍 렌더링이나 애니메이션 시의 CPU 사용률이 감소했습니다. 노트북 팬이 세게 도는 문제가 완화됩니다.

• --safe-mode: 트러블슈팅 시의 첫 번째 수단. "순정 상태에서도 재현되는가"를 명령어 하나로 판별.

• /cd: 캐시를 보존한 채 디렉토리 이동. 모노레포 사용자에게 필수.

• fallbackModel: 무인 실행·CI의 완주율을 높임. Opus×Sonnet의 이중 구조가 정석.

• MAX_THINKING_TOKENS=0은 정형 작업을 초고속화합니다. 태스크의 성격에 따라 구분하여 사용하세요.

트리거는 ultracode입니다.

workflow는 더 이상 발화(trigger)되지 않으므로 주의가 필요합니다.

단 일주일간의 업데이트만으로도 사용 편의성이 이만큼 달라집니다. 있는 그대로만 사용하는 것은 아까운 일입니다. 우선 settings.json에 fallbackModel을 한 줄 추가하는 것부터 시작해 보세요.

당신이 가장 "이건 몰랐다!"라고 생각한 것은 무엇인가요? 댓글로 알려주세요👇

도움이 되었다면 좋아요👍와 저장📌를 부탁드립니다! 다음에도 Claude Code의 실전 팁을 전달해 드리겠습니다.

Claude Code Updates by Anthropic - June 2026 - Releasebot

What's new - Claude Code Docs

Claude Code Changelog: All Release Notes (2026)