Claude Code v2.1.319는 2026년 11월 6일 공개됐습니다. 릴리스 노트에서 운영 중인 하네스에 영향을 줄 수 있는 변경은 세 가지입니다. 이 글은 릴리스 노트만 근거로 하며, 직접 실행해 검증한 것은 없습니다.

바뀐 것 세 가지

1. MCP 작업의 백그라운드 실행. MCP 서버가 도구 호출을 작업(task)으로 실행하면, Claude Code는 즉시 백그라운드로 보내고 끝났을 때 결과를 Claude에게 알립니다. 기다리게 하려면 환경 변수 CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND를 설정합니다.

2. permissions.denyInsteadOfPrompting. 권한 프롬프트에서 멈출 도구 호출을 거부하고 턴을 계속 진행합니다. 터미널 세션, 서브에이전트, 팀원에 적용된다고 노트에 적혀 있습니다.

3. auto mode의 서버 측 검사. 텔레메트리나 기능 플래그가 꺼져 있는 경우(LLM 게이트웨이 뒤 포함), 서버가 검사하지 못하는 호출은 묻거나 거부하며 내장 분류기로 돌아가지 않습니다. 이전 동작을 유지하려면 CLAUDE_CODE_AUTO_MODE_SERVER=0을 설정합니다. Bedrock, Vertex, Foundry는 그대로입니다. 게이트웨이 뒤에서 CLAUDE_CODE_AUTO_MODE_SERVER=1은 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS가 설정돼 있어도 서버 측 검사를 켭니다. 관리형 설정이 후자를 쓴다면 1도 함께 설정해야 한다고 합니다.

왜 하네스에서 중요한가

무인 실행(CI, 스케줄 작업, 서브에이전트)에서 승인 프롬프트는 사람이 없으면 영원히 대기하는 지점이었습니다. denyInsteadOfPrompting은 이 대기를 거부로 바꿔서 흐름이 멈추지 않게 합니다. 대신 이전에 사람이 승인하던 호출이 이제 조용히 실패할 수 있다는 뜻이기도 합니다. 거부된 호출을 에이전트가 어떻게 처리하는지(재시도, 우회, 포기)는 노트에 없으므로 직접 봐야 합니다.

MCP 백그라운드 실행은 오래 걸리는 도구가 대화를 막지 않게 해 주지만, 결과가 나중에 도착하기 때문에 "도구가 끝났다는 가정"으로 쓰인 순서 의존 작업이 있다면 확인해야 합니다. 이는 제 추정이며 노트가 말하는 부분은 아닙니다.

회귀 테스트 세 가지

각 항목은 제안이며 아직 실행하지 않았습니다.

케이스 확인할 것
승인이 필요한 호출 + 설정 off 기존처럼 프롬프트에서 대기하는가
같은 호출 + denyInsteadOfPrompting on 거부 메시지가 로그에 남고 에이전트가 범위를 넘는 우회를 하지 않는가
오래 걸리는 MCP 작업 백그라운드 전환 후 결과가 도착하는가, 환경 변수로 끄면 대기하는가

게이트웨이 뒤에서 auto mode를 쓴다면 업그레이드 전후로 같은 호출 세트를 돌려 "묻기/거부/허용" 분포가 어떻게 달라지는지 비교하세요.

한계

  • 이 글은 릴리스 노트의 문구만 근거로 합니다.
  • 게이트웨이 환경별 실제 동작은 확인하지 못했습니다.
  • 노트에는 성능이나 안전성 수치가 없습니다.

결론

권한과 백그라운드 실행은 에이전트 하네스에서 조용히 동작이 바뀌기 쉬운 영역입니다. 업그레이드 전에 승인 대기, 거부, 장시간 MCP 실행 세 경우를 회귀 테스트로 고정해 두세요. 이전 릴리스에서의 비슷한 점검은 Claude Code 2.1.291 permission 신뢰성과 MCP 재인증 권한에서 다뤘습니다.

참고