docs: '감사자가 opus' 관측은 뷰잉 이슈로 해소 — 최상단 배너는 세션 헤더

서브에이전트 뷰 최상단의 'Opus 5 · Claude Max'는 Claude Code 세션 헤더(메인
모델)이지 서브에이전트 모델이 아님(사용자가 화면 직접 확인). 감사자는 다섯
실행 전부 message.model=claude-sonnet-5이고 frontmatter model: sonnet은 정상
동작. 모델을 잘못 읽을 자리 셋(문자열 grep이 usage.iterations에 낚임 / 세션
헤더 / 폐기된 워크플로의 픽스 에이전트는 실제 opus였음)과 신뢰할 소스
하나(트랜스크립트 최상위 message.model)를 세션 로그에 기록.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
qwreey 2026-08-16 03:48:49 +09:00
parent 1935dd4670
commit e0b6c992fa
Signed by: qwreey
GPG key ID: D28DB79297A214BD
2 changed files with 42 additions and 0 deletions

View file

@ -1368,3 +1368,12 @@ blob과 바이트 단위로 동일, 메인이 `git rev-parse`로 독립 확인).
`tools:` 미반영뿐. 감사자 모델은 다섯 실행 전부 sonnet으로 재확인했고,
실행마다 `message.usage.iterations[]`에 opus 항목이 딱 1개씩 붙는 게
"감사자가 opus"로 보이는 원인.
**[같은 세션, 해소]** "감사자가 opus로 돈다"는 반복 관측은 **뷰잉 이슈**로
판명 — 서브에이전트 뷰 최상단에 보이는 `Opus 5 · Claude Max`는 Claude Code
**세션 헤더**(메인 모델)이지 서브에이전트 모델이 아니다(사용자가 화면 직접
확인). 감사자는 다섯 실행 전부 sonnet이고 frontmatter `model: sonnet`
정상 동작. 모델을 잘못 읽을 자리가 셋이었음 — (1) `"model"` 문자열 grep이
`message.usage.iterations[]`의 opus 항목에 낚임, (2) 화면 최상단 세션 헤더,
(3) 폐기된 워크플로의 픽스 에이전트 49개는 실제로 opus였던 것. 신뢰할
소스는 트랜스크립트 최상위 `message.model` 하나.

View file

@ -335,3 +335,36 @@ frontmatter `name`/`description`을 바꿈). 이 대응 자체가 README가 경
캐싱으로는 설명이 안 된다 — `model: sonnet`은 이 파일 **최초 커밋(`a1c0e44`)
부터** 있었으므로, 아무리 낡은 버전이 실려도 sonnet이다.
## 14. [해소] "감사자가 opus로 돈다"는 관측은 **뷰잉 이슈**였다
사용자가 서브에이전트 뷰에서 위로 스크롤하면 모델명이 opus로 보인다고
두 번 지적했고, 트랜스크립트 실측(다섯 실행 전부 sonnet)과 계속 어긋났다.
사용자가 직접 그 화면을 확인해 원인을 특정함 — **맨 위에 보이는 건
Claude Code 세션 헤더**다:
```
▐▛███▜▌ Claude Code v2.1.233
▝▜█████▛▘ Opus 5 · Claude Max
▘▘ ▝▝ ~/Desktop/quad
```
이건 **메인 세션의 모델**이지 서브에이전트의 모델이 아니다. 서브에이전트
뷰에서도 최상단엔 같은 세션 헤더가 나오므로, 위로 스크롤하면 무조건
상위 모델이 보인다. 사용자 표현대로 "이건 상위 네 모델을 의미".
이제 세 소스가 전부 일치한다 — 트랜스크립트 `message.model`(sonnet),
결과 출력 필드(sonnet), 세션 헤더(메인 모델, 서브에이전트와 무관).
**frontmatter `model: sonnet`은 정상 동작하며, 감사자는 sonnet으로 돈다.**
**교훈 — 이 조사에서 모델을 잘못 읽을 자리가 세 군데였다**:
1. `"model"` 문자열 grep → `message.usage.iterations[]`의 opus 항목에 낚임
(감사자 실행마다 1개씩 붙음, 그 메시지 자신은 sonnet, 정체는 미상)
2. 화면 최상단 배너 → 세션 헤더(메인 모델)라 서브에이전트와 무관
3. 폐기된 워크플로의 `general-purpose` 픽스 에이전트 49개는 **진짜로
opus**였음 — 같은 실행 안에 opus/sonnet이 섞여 있어 "어떤 건 sonnet으로
나온다"는 관측과 헷갈리기 쉬움
**신뢰할 소스는 하나**: 트랜스크립트의 최상위 `message.model`(원하면
`attributionAgent`로 어느 에이전트 몫인지까지 확인).