Claude Code 2.1.319 업그레이드: 게이트웨이·권한·MCP 운영 점검
LLM 게이트웨이와 텔레메트리 차단 환경에서 auto 모드 검사, 권한 거부 정책, MCP 태스크 실행 방식을 점검하고 업그레이드에 반영한다.
2026-11-15
텔레메트리를 차단했다면 auto 모드부터 확인한다
텔레메트리나 feature flag를 끈 환경에서는 auto 모드가 서버 검사를 받지 못한 호출을 기존 내장 분류기로 넘길 것이라고 가정하면 안 된다. **Claude Code 2.1.319 (2026-11-06)**에서는 서버가 검사할 수 없는 호출에 대해 사용자에게 묻거나 거부하며, 내장 분류기로 자동 전환하지 않는다.
공식 릴리스노트는 이 변경에 LLM 게이트웨이 뒤의 환경도 포함한다고 명시한다. Bedrock, Vertex, Foundry는 이 항목의 변경 대상이 아니다.
업그레이드 전에 정할 것은 서버 검사를 사용할지, 기존 내장 분류기를 유지할지다. 기존 분류기를 유지하려는 환경에는 다음 값을 명시한다.
CLAUDE_CODE_AUTO_MODE_SERVER=0
이 선택은 설정을 배포하는 위치와 함께 검토해야 한다. 이번 버전부터 프로젝트 밖에서 서버 검사를 꺼 두었다면 프로젝트 설정 파일이나 플러그인이 다시 켤 수 없다. 프로젝트별 설정으로 검사를 되살리는 운영 절차가 있었다면 바꿔야 한다.
아래 비교는 검사할 수 없는 호출의 처리 방식이 어떻게 달라졌고, 기존 분류기를 유지하려면 무엇을 명시해야 하는지 보여 준다.
게이트웨이에서는 검사 설정과 실제 도달 여부를 나눠 본다
LLM 게이트웨이 뒤에서 서버 검사를 사용하려면 다음 값을 확인한다.
CLAUDE_CODE_AUTO_MODE_SERVER=1
이 값은 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS가 설정되어 있어도 서버 검사를 켠다. 다만 관리 설정이 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS를 지정한다면, 같은 관리 설정에서 CLAUDE_CODE_AUTO_MODE_SERVER=1도 지정해야 한다. 사용자가 다른 위치에서 값을 넣는 것으로 충분하다고 가정하지 말고 관리 설정을 함께 점검한다.
관련 수정도 있다. 게이트웨이 URL이 관리 설정에만 있고 서버 관리 설정을 가져올 수 없는 경우, 관리 설정의 CLAUDE_CODE_AUTO_MODE_SERVER=1이 무시되던 문제가 수정됐다. 이런 구성을 쓰는 팀은 업그레이드 검증에 해당 조건을 포함할 만하다.
설정값 확인만으로 검증을 끝내지는 않는다. 이전에는 게이트웨이가 서버 측 검토를 떨어뜨려 실제 세션에 도달하지 않아도 /status에 Auto mode server: Enabled가 표시되는 문제가 있었다. 이번 버전은 이 표시를 수정했다. 업그레이드 후에는 /status를 열어 실제 세션 상태를 확인하고, 검사 불가 호출이 어떤 결과로 끝나는지도 확인한다.
feature flag 차단과 텔레메트리 차단도 별도로 다룰 수 있게 됐다.
| 설정 | 릴리스노트에 명시된 동작 | 운영 시 확인할 점 |
|---|---|---|
CLAUDE_CODE_AUTO_MODE_SERVER=0 |
기존 내장 분류기 사용 유지 | 프로젝트 밖에서 끈 서버 검사를 프로젝트나 플러그인이 다시 켜는 절차가 있는가 |
CLAUDE_CODE_AUTO_MODE_SERVER=1 |
게이트웨이 뒤에서도 서버 검사 활성화 | 관리 설정이 experimental beta를 끈다면 이 값도 관리 설정에 있는가 |
CLAUDE_CODE_DISABLE_FEATURE_FLAGS |
텔레메트리는 유지하면서 feature flag 가져오기 중단, 각 flag는 내장 기본값 사용 | flag 차단과 텔레메트리 차단을 구분해 설정했는가 |
CLAUDE_CODE_DISABLE_FEATURE_FLAGS를 쓰면 모든 기능이 꺼지는 것은 아니다. 각 flag가 내장 기본값을 사용한다. 따라서 이 변수를 “선택 기능 전체 비활성화”로 해석한 운영 문서가 생기지 않도록 동작을 정확히 적어 두는 편이 좋다.
권한 대기를 없애려면 거부 후 진행을 받아들여야 한다
permissions.denyInsteadOfPrompting은 권한 프롬프트를 기다릴 도구 호출을 거부하고 턴을 계속 진행하게 하는 신규 설정이다. 적용 범위는 터미널 세션, 서브에이전트, 팀원이다.
이 설정을 검토할 상황은 사람이 즉시 응답하기 어려운 실행에서 권한 대기가 생기는 경우다. 다만 프롬프트가 사라지는 이유는 호출이 허용돼서가 아니라 호출을 거부했기 때문이다. 후속 작업이 그 도구 결과에 의존한다면, 턴이 계속됐다는 사실만으로 필요한 작업이 수행됐다고 판단할 수 없다.
아래 흐름은 같은 권한 대기 대상 호출이 설정 적용 여부에 따라 어디에서 갈리는지 보여 준다.
도입 검증에서는 권한 프롬프트가 발생할 호출을 대상으로, 거부된 작업과 최종 결과를 함께 확인한다. 대기 시간이 없어졌는지만 확인하면 작업 누락을 놓칠 수 있다.
비대화형 실행에는 별도의 종료 코드 수정도 있다. claude -p가 auto 모드에서 안전성 검사를 사용할 수 없어 작업을 거부한 경우, 텍스트 및 JSON 출력 모두 이제 종료 코드 1을 반환한다. 이전에는 이 상황에서 0으로 종료하던 문제가 있었다.
배치나 스크립트가 종료 코드에 따라 성공을 집계한다면 이 변경을 검증 항목에 넣는다. 다만 이것은 auto 모드에서 검사 수단이 없어 거부된 경우의 수정이다. 릴리스노트는 모든 권한 거부가 동일한 종료 코드로 끝난다고 설명하지 않으므로, denyInsteadOfPrompting 전체의 종료 코드 계약으로 확대해서는 안 된다.
MCP 태스크는 백그라운드 이동과 기능 사용을 따로 제어한다
터미널에서 MCP 서버가 도구 호출을 태스크로 실행하면 Claude Code는 즉시 백그라운드로 옮기고, 완료됐을 때 결과를 Claude에게 전달한다. 모든 MCP 도구 호출이 태스크가 된다는 뜻은 아니다. 조건은 MCP 서버가 해당 호출을 태스크로 실행하는 경우다.
이 동작은 feature flag를 가져오지 않는 환경에서도 지원된다. 릴리스노트는 Bedrock, Vertex, Foundry, LLM 게이트웨이, DISABLE_TELEMETRY 환경을 명시한다. feature flag 수신을 막았다는 이유만으로 MCP 태스크도 동작하지 않을 것이라고 가정해서는 안 된다.
MCP 태스크의 기본 흐름에서는 호출의 백그라운드 이동과 완료 결과 전달이 분리된다.
운영 선택은 대기 방식 변경과 기능 비활성화로 나뉜다.
| 선택 | 제어 항목 | 동작 |
|---|---|---|
| 기본 태스크 실행 | 신규 기본 동작 | 즉시 백그라운드로 이동하고 완료 시 결과 전달 |
| 호출 안에서 대기 | CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND |
즉시 백그라운드로 옮기는 대신 도구 호출 안에서 태스크 대기 |
| MCP 태스크 비활성화 | CLAUDE_CODE_DISABLE_MCP_TASKS=1 |
MCP 태스크 기능 끄기 |
즉시 백그라운드로 넘어가는 실행 방식이 기존 절차와 맞지 않는다면 대기 방식을 바꾸는 변수를 검토한다. 태스크 기능 자체를 사용하지 않으려면 별도의 비활성화 설정을 사용한다.
CLAUDE_CODE_DISABLE_MCP_TASKS=1
재개 시나리오도 함께 확인한다. 이번 버전은 claude.ai 커넥터의 장시간 MCP 호출이 --resume 뒤에 결과를 보고하지 못하는 경우를 수정했다. 구형 핸드셰이크를 쓰는 MCP 서버가 연결에 실패하거나 빈 결과를 반환하던 문제도 수정했다. 해당 서버나 커넥터를 쓰는 팀이라면 정상 완료뿐 아니라 연결과 세션 재개까지 검증 범위에 넣는다.
권한 규칙은 Monitor와 넓은 deny까지 함께 점검한다
권한 규칙을 운영해 온 팀은 개별 도구의 허용 여부만 보지 말고, 해당 명령을 덮는 Bash 규칙까지 확인해야 한다.
Monitor의 WebSocket watch는 이제 모든 Bash 명령에 대해 규칙을 따른다. deny에 걸리면 거부하며, ask에 걸리면 Monitor에 대한 allow, bypass 모드, auto 모드가 있어도 프롬프트를 건너뛰지 않는다. Monitor를 허용해 뒀다는 이유로 그 안의 Bash 명령도 같은 방식으로 실행될 것이라고 가정하면 달라진 동작을 놓칠 수 있다.
세션에 지정한 정확한 Bash 또는 PowerShell ask 규칙도 달라진다. 더 넓은 deny 규칙이 그 명령을 포함하면 질문하지 않고 거부한다. 기존에 exact ask를 넓은 deny의 예외처럼 사용했다면 정책을 다시 검토해야 한다.
| 점검 대상 | 이번 버전의 동작 또는 수정 | 검증할 상황 |
|---|---|---|
| Monitor의 WebSocket watch | Bash deny는 거부, ask는 프롬프트 유지 | Monitor allow와 Bash ask가 함께 적용되는 명령 |
| 정확한 Bash·PowerShell ask 규칙 | 더 넓은 deny가 덮으면 거부 | 세션의 exact ask와 광범위한 deny가 겹치는 명령 |
| 따옴표가 포함된 Bash 명령 | deny·ask 규칙이 명령을 놓치던 문제 수정 | 기존 규칙 대상 명령을 따옴표로 작성한 경우 |
| 환경변수 접두사가 붙은 Bash 명령 | 조작된 접두사가 명령 일부를 숨기는 권한 우회 수정 | 환경변수 접두사를 쓰는 기존 실행 경로 |
추가로 sed가 accept-edits 및 auto 모드에서 권한 검사를 건너뛸 수 있던 문제도 수정됐다. 기존 테스트가 단순한 명령 표기만 다뤘다면, 실제 운영에서 쓰는 따옴표와 환경변수 접두사가 포함된 표기도 확인한다.
이 검증의 기준은 “업그레이드 전처럼 실행되는가”만이 아니다. 의도한 deny와 ask가 해당 명령에 실제로 적용되는지를 기준으로 삼아야 한다.
프록시 환경은 설정 위치와 TLS 복구 조건을 확인한다
게이트웨이와 프록시를 함께 쓰는 환경에는 설정 위치 변경도 있다. 호스트가 네트워크를 관리하는 경우 CLAUDE_CODE_PROXY_RESOLVES_HOSTS를 설정 파일에서 지정할 수 없게 됐으며, 프로세스 환경에 넣어야 한다.
이 변수를 사용하고 머신 자체에 DNS가 없는 프록시 환경에서는 Monitor의 WebSocket watch가 could not resolve로 실패하던 문제가 수정됐다. 해당 구성을 쓴다면 변수의 배치 위치와 Monitor 동작을 함께 확인한다.
TLS 검사 프록시의 자동 인증서 복구는 ALL_PROXY만 설정된 경우 더 이상 실행되지 않는다. 릴리스노트는 대신 HTTPS_PROXY에 프록시의 http:// URL을 설정하도록 안내한다. 배포 환경이 ALL_PROXY만 주입하고 있다면 이 조건을 점검한다.
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC를 켠 상태의 인증서 오류 처리도 바뀌었다. 인증서 실패 후 설정된 API 호스트에 TLS 핸드셰이크를 수행하며, http:// 프록시가 설정돼 있으면 이를 경유한다. 이때 API 요청은 보내지 않는다. 차단 환경의 네트워크 검증에서는 이 핸드셰이크와 API 요청을 구분해 확인한다.
업그레이드 검증은 완료 결과와 거부 결과를 함께 남긴다
운영 검증 기록에는 설정값만 적는 것보다, 그 설정 아래에서 호출이 어떻게 끝났는지를 남기는 편이 유용하다. 이번 변경은 서버 검사 불가, 권한 대기, 백그라운드 완료, 종료 코드처럼 실행 결과를 해석하는 지점에 걸쳐 있다.
다음 항목을 현재 환경에 맞춰 확인한다.
- 텔레메트리 또는 feature flag 차단 상태에서 auto 모드의 검사 불가 호출이 어떻게 처리되는지 확인한다.
- 서버 검사를 사용할 환경에서는 관리 설정의 값을 확인하고
/status로 세션 상태를 점검한다. permissions.denyInsteadOfPrompting을 적용한다면 거부된 호출과 계속 진행된 턴의 결과를 함께 확인한다.- MCP 태스크의 백그라운드 완료 결과가 전달되는지 확인하고, 필요하면 호출 안에서 기다리는 방식을 검토한다.
- Monitor와 Bash·PowerShell의 ask·deny가 겹치는 명령을 실행해 의도한 정책이 적용되는지 확인한다.
claude -p를 사용하는 자동화에서는 검사 수단 부재로 거부될 때의 종료 코드1을 확인한다.
검증 완료 기준은 프롬프트가 줄거나 실행이 계속되는 것만으로 잡지 않는다. 서버 검사가 필요한 호출은 검사 상태를 확인하고, 거부된 호출은 거부로 기록하며, 백그라운드 태스크는 완료 결과까지 확인해야 이번 버전의 실행 방식을 운영 절차에 반영할 수 있다.