Claude Code v2.1.187이 출시되었습니다. 이번 릴리스에서 가장 주목해야 할 점은 sandbox.credentials 설정의 추가입니다. 샌드박스화된 명령어가 인증 정보 파일이나 비밀 환경 변수를 읽을 수 없도록 하는 보안 강화 기능으로, CI/CD 환경이나 다수 인원 개발 팀에서 Claude Code를 운용하고 있는 경우 특히 중요합니다.

또한, 구조화된 출력 (--json-schema / agent({schema}))의 무한 루프 버그나, 원격 MCP 도구의 무응답 행(hang) 등 자동화 파이프라인에 영향을 미쳤던 중간 단계의 결함들도 여러 건 수정되었습니다.

📌 영향을 받는 사람

• Claude Code를 보안이 요구되는 환경(CI/CD, 팀 개발)에서 이용하고 있는 분
• 워크플로우에서 --json-schema나 agent({schema})를 사용하고 있는 분
• 원격 MCP 도구를 통합하고 있는 분
• VSCode 확장 기능에서 대규모 세션을 다루고 있는 분

샌드박스화된 명령어가 인증 정보 파일이나 비밀 환경 변수를 읽을 수 없도록 차단하는 설정입니다. .env 파일이나 AWS 자격 증명(credentials) 등을 Claude Code의 서브 프로세스에 노출하고 싶지 않은 상황에서 유효합니다.

관리자가 설정한 모델 제한이 --model 플래그, /model 명령어, ANTHROPIC_MODEL 환경 변수 모두에 반영됩니다. 제한된 모델을 선택하면 restricted by your organization's settings라는 메시지가 표시됩니다.

• 한국어/CJK 글자 깨짐 수정 (change-008): 바이트 단위의 extended-key 이벤트로 전달되는 터미널에서의 글자 깨짐 현상 해소
• Remote Control을 통한 (change-009) /update 행(hang) 수정
• (change-017) /share 업로드 중 Esc/Ctrl-C/Ctrl-D 무효화 수정
• macOS Ghostty 전체 화면에서 Cmd+click이 URL을 열지 못하는 문제 수정 (change-015)
• 서브 에이전트의 깊이 추적(depth tracking) 수정 (change-013): resume 후의 깊이 복원 및 포크(fork) 시의 깊이 카운트 수정
• 누수된 worktree 등록의 자동 정리 (change-014): 종료(kill)된 에이전트가 남긴 .git/worktrees/ 엔트리를 자동 삭제
• Claude Code Remote 세션 기동 시 약 2.7초 지연 수정 (change-007)
• 채널 연결 끊김 문제 수정 (change-011): 에이전트 뷰 이동 후나 /bg · /tui · /update 이후의 연결 드롭을 수정
• (change-016) claude --help에 --bg/--background 추가

표시되지 않는 문제 수정 -
에이전트 정지 알림 문구 개선 (change-012): came to rest

→ finished 또는 stopped로 변경 -
VSCode 확장 기능의 대규모 세션 재개 시 프리징(Freeze) 현상 수정 (change-021)

풀스크린 모드에서의 마우스 클릭 대응 (change-003): 권한 프롬프트, /model, /config 등을 마우스로 선택 가능하게 개선 -
(change-018): GitHub Actions 워크플로 설정이 선택 사항으로 변경. App만 설치가 가능하도록 /install-github-app 개선 -
(change-019): ←/→ 키로 과거 답변을 탐색할 수 있도록 /btw에 화살표 키 내비게이션 추가 -
(change-020): 불필요한 플러그인 정리가 용이하도록 /plugin에서 미사용 플러그인 표시

보안 강화를 원할 경우 sandbox.credentials를 설정합니다. 이를 통해 인증 정보 파일이나 비밀 환경 변수에 대한 샌드박스(Sandbox)의 접근을 차단할 수 있습니다.

💡 Tips

원격 MCP 도구의 타임아웃 시간을 변경하고 싶다면 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 환경 변수로 덮어쓸 수 있습니다. 기본값인 5분보다 긴 타임아웃이 필요한 도구(무거운 처리 등)가 있는 경우 활용하십시오.

Before (v2.1.186 이전)

// .claude/settings.json
{
"sandbox": {
...

샌드박스 내의 명령어가 .env나 AWS 자격 증명(Credentials)과 같은 인증 정보 파일 또는 비밀 환경 변수에 접근할 수 있는 상태였습니다.

After (v2.1.187 이후)

// .claude/settings.json
{
"sandbox": {
...

sandbox.credentials를 설정함으로써, 샌드박스화된 명령어로부터 인증 정보 파일이나 비밀 환경 변수에 대한 접근을 차단할 수 있습니다.

Before (v2.1.186 이전)

// agent({schema})가 성공한 후에도 StructuredOutput을 계속 재호출하는 버그가 있었음
const result = await agent("태스크를 실행해 주세요", {
schema: MY_SCHEMA
...

After (v2.1.187 이후)

// 정상적으로 1회에 구조화된 출력(Structured Output)이 반환됨
const result = await agent("태스크를 실행해 주세요", {
schema: MY_SCHEMA
...

# 기본값(5분)보다 긴 타임아웃이 필요한 경우
export CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=600000 # 10분 (밀리초)
# 또는 .env에 추가
...

Claude Code v2.1.187의 요점을 정리합니다.

가장 수동 대응이 필요한 부분은 sandbox.credentials 설정입니다. 팀 개발이나 CI/CD 파이프라인에서 Claude Code를 활용하고 있다면 설정을 검토해 보시기 바랍니다. 구조화된 출력 (Structured Output)이나 MCP 관련 버그는 자동으로 수정되었으므로, v2.1.187로 업데이트하는 것만으로도 혜택을 받을 수 있습니다.