Claude Code v2.1.193의 OTel 어시스턴트 응답 로그 추가 및 전체 변경 사항 정리

Claude Code v2.1.193이 출시되었으며, 여러 가지 새로운 기능, 개선 사항 및 버그 수정이 포함되어 있습니다.

그중에서도 가장 주의가 필요한 것은 OpenTelemetry (OTel)로의 어시스턴트 응답 로그 추가입니다. 기존의 프롬프트 로그 설정을 계승하는 사양이기 때문에, 업그레이드하는 것만으로도 응답 내용이 의도치 않게 기록되기 시작할 가능성이 있습니다. 본 기사에서는 이러한 동작 변경의 상세 내용과 대응 방법을 중심으로 v2.1.193의 모든 변경 사항을 해설합니다.

📌 영향을 받는 사람

• Claude Code에 OpenTelemetry를 설정하여 OTEL_LOG_USER_PROMPTS=1로 프롬프트를 로그 수집하고 있는 개발자 및 운영 팀
• Claude Code를 기업 또는 팀 단위로 배포하고 있는 관리자
• MCP 서버를 이용하고 있는 사용자

ID	종별	중요도	타이틀	대응 필요 여부
change-001	개선	🔴 High	OTel에 어시스턴트 응답 로그를 추가	대응 필요
change-002	신기능	🟡 Medium	autoMode.classifyAllShell 설정 추가	선택 사항
change-012	개선	🟡 Medium	백그라운드 에이전트(Background Agent) 동작 개선	불필요
change-013	개선	🟡 Medium	MCP headersHelper가 401/403 발생 시 자동 재연결	불필요
change-003	개선	Low	auto-mode의 거부 이유 시각화	불필요

... | 이번에 가장 영향이 큰 변경 사항입니다.

새로운 claude_code.assistant_response

OpenTelemetry 로그 이벤트가 추가되었습니다. 이 이벤트는 기본적으로 리덕트(Redact, 비식별화) 처리되지만, 환경 변수 설정에 따라 의도치 않게 출력될 수 있습니다.

⚠️ Breaking Change

OTEL_LOG_USER_PROMPTS=1을 설정하고 있는 환경에서는, OTEL_LOG_ASSISTANT_RESPONSES를 명시적으로 설정하지 않을 경우 업그레이드 후부터 자동으로 응답 내용도 로그로 출력됩니다.

우선순위 판정 플로우:

취해야 할 액션:

운영 케이스	대응
프롬프트만 로그 수집, 응답은 로그 불필요	OTEL_LOG_ASSISTANT_RESPONSES=0을 명시적 설정
프롬프트와 응답 모두 로그 수집을 원하는 경우	OTEL_LOG_ASSISTANT_RESPONSES=1을 명시적 설정
OTel을 사용하지 않음 / 프롬프트 로그도 비활성화	대응 불필요

모든 Bash/PowerShell 명령을 auto-mode의 분류기(Classifier)를 통해 라우팅할 수 있게 되었습니다.

기존에는 임의 코드 실행(Arbitrary Code Execution) 패턴만이 대상이었으나, 이 설정을 활성화함으로써 모든 쉘 명령에 대해 권한 제어를 엄격화할 수 있습니다. 보안 정책이 엄격한 환경이나 명령 실행을 세밀하게 관리하고 싶은 팀에 유용합니다.

에이전트 기동 시의 결과가 "end your response(응답을 종료하라)"라고 Claude에게 지시하지 않게 되었습니다.

이를 통해 백그라운드 에이전트가 동작 중일 때도 Claude가 다른 태스크를 계속할 수 있습니다. 멀티 에이전트(Multi-agent)를 활용한 병행 작업이 더욱 자연스럽게 가능해집니다.

MCP의 headersHelper 인증이 개선되어, 도구 호출(Tool Call) 시 401/403이 반환될 경우 자동으로 재실행 및 재연결을 수행하게 되었습니다.

토큰 만료가 발생하더라도 수동 재인증이 필요하지 않게 되어, 장시간 세션에서의 MCP 이용이 안정화됩니다.

Before (v2.1.192 이전):

# 프롬프트를 로그 출력하는 설정 (응답 로그는 존재하지 않았음)
export OTEL_LOG_USER_PROMPTS=1

After (v2.1.193 이후):

# 프롬프트만 로그 출력하고, 응답은 로그하지 않을 경우 (명시적인 설정이 필요)
export OTEL_LOG_USER_PROMPTS=1
export OTEL_LOG_ASSISTANT_RESPONSES=0 # ← 새롭게 추가가 필요함
...

💡 Tips

Docker나 CI 환경에서는 환경 변수 변경을 잊기 쉽습니다. docker-compose.yml이나 .env 파일을 확인하여, OTEL_LOG_ASSISTANT_RESPONSES=0를 명시적으로 설정하는 것을 잊지 마세요.

// .claude/settings.json 또는 settings.local.json
{
"autoMode": {
...

💡 Tips

이 설정은 권한 체크 (Permission Check)를 엄격하게 만들기 때문에, 기존에는 허용되었던 명령어가 확인을 요청받게 될 수 있습니다. 개발 환경에서 동작을 확인한 후 운영 환경에 적용하십시오.

# 메모리 압박 시 유휴 쉘 (Idle Shell) 자동 회수를 비활성화함
export CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1

Claude Code v2.1.193의 주요 변경 사항을 정리합니다.

우선순위	변경 사항	대응 방법
최우선	OTel 어시스턴트 응답 로그 추가	OTEL_LOG_ASSISTANT_RESPONSES=0를 명시적으로 설정 (프롬프트만 로그로 운영할 경우)
확인 권장	autoMode.classifyAllShell 설정	엄격한 권한 제어가 필요한 경우 활성화 검토
확인 권장	MCP headersHelper 자동 재연결	수동 대응이 불필요해지므로 혜택을 받을 수 있음
확인 권장	백그라운드 에이전트 (Background Agent) 개선	멀티 에이전트 사용자는 병렬 작업 효율이 향상됨

업그레이드 전 체크리스트:

• OTEL_LOG_USER_PROMPTS=1을 설정한 환경을 확인했는가
• 해당 환경에 OTEL_LOG_ASSISTANT_RESPONSES=0를 추가했는가 (또는 의도적으로 =1로 설정했는가)
• Docker / CI의 환경 변수 정의 파일을 업데이트했는가
• MCP 서버 이용 중인 경우, headersHelper 자동 재연결 동작을 확인했는가