클로드 코드 플러그인 버그로 인해 스킬이 두 번 로드되어 컨텍스트 압축이 증가합니다

Claude Code의 버그로 인해 플러그인이 모든 스킬을 두 번씩 로드하게 되어 시스템 프롬프트 크기가 크게 증가하고 빈번한 컨텍스트 압축이 발생합니다. 이 문제는 자동 업데이트 중 오래된 플러그인 캐시 디렉터리가 정리되지 않고 스킬 디렉터리에 중복 심링크가 생성되기 때문입니다.

문제점

플러그인이 업데이트될 때(예: 버전 4.3.0에서 4.3.1로), 이전 버전 디렉터리가 ~/.claude/plugins/cache/에 남아 있습니다. Claude Code는 installed_plugins.json에 나열된 활성 버전뿐만 아니라 모든 캐시된 버전에서 스킬을 로드합니다. 이로 인해 모든 스킬이 시스템 프롬프트에 두 번씩 나타납니다.

한 사용자는 6개의 플러그인에 걸쳐 11개의 오래된 버전 디렉터리가 있어 약 30개의 스킬이 약 60개 항목으로 두 배가 되었다고 보고했습니다. 추가적인 중복 원인으로는 프롬프트 구성 자체의 버그(이슈 #29520에서 확인됨)와 플러그인 캐시를 가리키는 ~/.claude/skills/에 생성된 심링크(이슈 #23819)가 있으며, 한 보고자는 83개의 심링크가 일괄 생성된 경우를 보고했습니다.

영향 여부 확인

다음 스크립트를 실행하여 문제를 확인하세요:

확인 1: 오래된 플러그인 버전

for d in ~/.claude/plugins/cache/claude-plugins-official/*/; do
    name=$(basename "$d")
    count=$(ls -d "$d"*/ 2>/dev/null | wc -l)
    if [ "$count" -gt 1 ]; then
        echo "AFFECTED: $name has $count versions (should be 1)"
        ls -d "$d"*/
    fi
done

확인 2: 중복 심링크

ls -la ~/.claude/skills/ 2>/dev/null | grep -c "plugins/"

이 명령이 0보다 큰 숫자를 반환하면 심링크 중복이 있습니다.

확인 3: 세션 내부에서 — /context를 실행하고 Skills 테이블을 확인하세요. 모든 스킬이 두 번씩 나타나면 영향을 받은 것입니다.

문제 해결

오래된 버전 수정:

python3 << 'EOF'
import json, os, shutil

with open(os.path.expanduser("~/.claude/plugins/installed_plugins.json")) as f:
    data = json.load(f)
cache = os.path.expanduser("~/.claude/plugins/cache/claude-plugins-official")
for full_name, installs in data["plugins"].items():
    plugin = full_name.split("@")[0]
    active = installs[0]["version"]
    plugin_dir = os.path.join(cache, plugin)
    if os.path.isdir(plugin_dir):
        for ver in os.listdir(plugin_dir):
            path = os.path.join(plugin_dir, ver)
            if os.path.isdir(path) and ver != active:
                print(f"Removing stale: {plugin}/{ver}")
                shutil.rmtree(path)
EOF

중복 심링크 수정:

find ~/.claude/skills/ -type l -lname "*plugins/*" -delete 2>/dev/null

이 수정 사항을 실행한 후 Claude Code를 재시작하세요.

추가 컨텍스트 절약 방법

소스에서는 다음도 권장합니다:

• ~/.claude/settings.json → enabledPlugins에서 활성화된 플러그인을 검토하세요. 현재 프로젝트에 필요하지 않은 플러그인은 비활성화하세요.
• 사용하지 않는 MCP 커넥터(Gmail, GCal 등)를 연결 해제하세요.
• 다음 세션에서 /context를 실행하여 차이를 확인하세요.
• 이슈 #27721에 좋아요를 눌러 우선순위가 높아지도록 하세요 — 아직 응답이 없는 근본적인 문제입니다.