Claude Code의 절차서 작성 과정에서 3주 전 버전이 이미 구식이 되어있었습니다

3주 전에 Claude Code 2.1.278에 맞춰 작성한 절차서를 2.1.295로 검토했더니, 확인용 명령어까지 구식으로 바뀌어 있었습니다. 그래서 상시 컨텍스트(context)와 CLAUDE.md를 정리하는 자체 스킬을 수정하고 /doctor prompt-audit를 추가하여 1.2.0 버전으로 배포한 기록입니다.

저는 claude-code-context-diet라는 Claude Code의 상시 컨텍스트를 정리하는 절차 스킬을 직접 만들었습니다. 이 스킬은 Claude Code의 상시 컨텍스트를 측정하고, 줄일 가치가 있는지 판단한 후 감소시키는 일련의 과정과 간편 스킬입니다. 효과적인 키워드를 실제 측정으로 파악한 실전 지식입니다.

어떤 기능을 할 수 있는지 소개 페이지:

저장소(Star를 해주시면 큰 힘이 됩니다):

사용하려면 Claude Code에서 다음 두 줄을 실행합니다.

/plugin marketplace add ishizakahiroshi/claude-code-context-diet
/plugin install context-diet@ishizakahiroshi

재시작한 후 "컨텍스트 정리해줘"라고 요청하면 사용할 수 있습니다. 직접 호출하려면 /context-diet:context-diet입니다. 이미 설치된 사용자는 다음 두 줄로 업데이트합니다.

/plugin marketplace update ishizakahiroshi
/plugin update context-diet@ishizakahiroshi

도입 및 업데이트의 근거는 1.2.0의 README에 있습니다.

이전 기사: 2026-06-22 "Claude Code의 상시 컨텍스트를 14% 줄인 이야기. disabledTools는 존재하지 않았습니다".

저는 2.1.278부터 2.1.295까지의 변화를 CHANGELOG와 대조하며 설명과 확인 절차를 수정하여 1.2.0으로 배포했습니다. 감소량의 실측값은 2.1.278에서 측정한 그대로이며, 이번에는 다시 측정하지 않았습니다.

2026-10-10, Claude Code에게 "최근에 새로 했으니 출시하려고 해. 전체적으로 점검해줘"라고 요청했습니다. 그런데 1.1.0은 이미 9월 21일에 버전 정보와 함께 push되었고, 사용자들에게는 이미 도착한 상태였습니다.

기계적인 검사는 통과했지만, 배포물은 2.1.278이고 제 손에 있는 것은 2.1.295였습니다. 공개된 CHANGELOG, 공식 docs, 실행 파일의 설정 설명을 대조했습니다.

자료 조사는 다른 AI 에이전트에게 맡기고, 주요 항목은 원문과 실행 파일의 문자열로 재확인했습니다.

1.1.0의 rg 명령어는 실행 파일에서 설정 설명문을 추출합니다. 2.1.295에서는 단축 변수명이 바뀌어 첫 번째 항목에서 skillOverrides가 0건이 되었습니다. 두 번째 항목에서는 disableWorkflows에 대한 설명이 635자로 늘어나 검색의 400자 제한을 초과했습니다.

둘 다 실제로 존재하는 키입니다. 빈 검색 결과를 그대로 "존재하지 않는다"고 해석할 수 있는 절차를 제가 배포하고 있었습니다.

1.2.0 수정 버전에서는 PowerShell과 ripgrep을 사용하여 $rg에 실제 경로를 넣습니다. 단축 변수명에 의존하지 않고, 따옴표는 모두 가져옵니다.

$rg = '<rg.exe의 전체 경로>'
$exe = "$env:USERPROFILE\.local\bin\claude.exe"
$pat = '(skillOverrides|enableWorkflows|disableWorkflows|enableArtifact|disableArtifact|disableBundledSkills|disableClaudeAiConnectors):.{0,160}?describe\((?:":[""^{0,1200}"]|"''[^'']{0,1200}''"))'
...

설명문이 반환되지 않는 것만으로는 부재한다고 판단하지 않습니다. 마지막 줄의 검색어를 확인하고 싶은 키 이름으로 바꿔서 개수를 세어 0건일 때만 "존재하지 않는다"고 작성하고, 확인한 버전을 첨부합니다.

1.1.0에 기재된 내용은 2.1.281, 2.1.283, 2.1.285, 2.1.287의 네 가지 버전에서 각각 구식이 되어 있었습니다. 버전에 종속되지 않는 재현 명령어와 docs URL 수정도 별도로 있습니다. 먼저 /context의 분모로 줄일 가치를 판단하기 위해, 1M 컨텍스트를 기본으로 사용하는 조건 변화가 중요했습니다.

• 2.1.281: claude.ai 동기(同期) 스킬은 이름 충돌이 없다면 짧은 이름으로 표시됩니다.
  anthropic-skills:
  접두사로 검색하는 설명을 수정했습니다.

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md#21281 - 2.1.283: MCP server instructions가
/context
독립 줄과 합산됩니다. claude.ai 커넥터를 비활성화하는 disableClaudeAiConnectors
의 효과는 대화의 /context
에서 이 줄의 차이를 통해 추정할 수 있습니다.

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md#21283 - 2.1.285: 자체(ANTHROPIC_BASE_URL)를 통해서도 지원 모델은 1M 창(window)을 사용합니다. disableWorkflows
이 유효하더라도 Code Review와 /ultrareview는 작동하지만, 실행 머신 관리자 설정은 예외입니다.

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md#21285 - 2.1.287: Opus 4.7 이후 버전과 Fable은 Bedrock・Vertex・Foundry・Claude apps gateway에서도
[1m]
없이 1M 창이 기본값이 되었습니다.

200k가 남는 경우는, Opus 4.6 / Sonnet 4.6을 [1m]
없이 사용할 경우, 1M 미지원 모델, CLAUDE_CODE_DISABLE_1M_CONTEXT=1
인 경우입니다. 게이트웨이가 200K에서 제한한다면, 표시가 1m여도 실제 상한은 200K입니다.

disableWorkflows는 비권장(deprecated)이 아니라, 모두에게 적용하기 위한 키입니다. 자신만 사용할 때는 enableWorkflows를 사용합니다.

환경 변수 공식 페이지 링크도 404가 된 구 URL에서 수정했습니다.

2.1.283에 추가된 /doctor prompt-audit를 내용 감사(content audit)의 맨 앞에 배치했습니다. 세션 내에서 실행합니다.

/doctor prompt-audit

대상은 CLAUDE.md・CLAUDE.local.md・AGENTS.md와, .claude/・~/.claude/
의 rules・skills・commands・subagents・output styles입니다. 범위를 좁히는 예시는 /doctor prompt-audit .claude/skills/deploy입니다. 오래된 지침이나 모순에 대한 수정안을 제시하고 적용을 요청할 때까지 파일은 변경되지 않습니다.

prompt-audit는 포함된 claude-api skill을 통해 작동하므로, claude-api를 skillOverrides에서 off로 설정하거나, disableBundledSkills로 비활성화하면 사용할 수 없습니다. 이 스킬은 사용하지 않는 skill을 off로 하는 절차를 가지고 있기 때문에, 사용 실적이 0회여도 claude-api를 off로 하면 prompt-audit가 사용할 수 없게 된다는 주의사항을 추가했습니다.

공식 설명에 중복과 모호함이 언급되지 않았으므로, 모순・중복・진부화(陳腐化)・모호의 4가지 관점 표는 유지했습니다.

수정 및 추가를 승인하고 10월 10일에 1.2.0을 푸시했습니다. 감소량은 2.1.295에서 재측정하지 않았으므로, 이번 업데이트로 증감했다고 말할 수 없습니다.

도움이 되었다면 Star를 부탁드립니다. 발견한 점은 Issue 또는 X의 DM으로 알려주세요.

부정형 사실에는 버전을 첨부한다고 적혀 있었는데, 그 판정에 사용하는 명령어가 구식이 되어 있었습니다. 다음에 본체 버전이 올라오면, 설명과 함께 확인 절차도 처음부터 다시 시작할 예정입니다.

📎 다이어그램 버전 및 관련 링크를 모아둔 페이지가 있습니다:

※ 헤더 이미지와 인포그래픽 그림은 AI(이미지 생성)로 제작했습니다.

※ 본문의 삽화 역시 AI(이미지 생성)로 제작했습니다.

작성자: ishizakahiroshi

군마 북부에서 보호묘 2마리와 함께 사는 재택 엔지니어(만능 해결사)

X (업무 위탁/각종 상담은 여기로):

백엔드・인프라・AI 연계 분야에서 업무 위탁 상담을 받고 있습니다. 풀 리모트입니다. 스팟이나 주 2~3시간부터도 환영하며, 여러 프로젝트에 참여할 수 있다면 좋겠습니다. 이런 상담도 환영합니다.