Documentation 2026-10-04 23:58 UTC to 2026-10-05 01:58 UTC

357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 약식 소스를 SSH 대신 HTTPS로 복제하려면 `1`로 설정합니다. 플러그인 설치 및 업데이트, 그리고 `/plugin marketplace add` 및 `update`에 적용됩니다. CI 러너, 컨테이너 또는 `github.com`용 SSH 키가 구성되지 않은 환경에서 유용합니다 |357| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 약식 소스를 SSH 대신 HTTPS로 복제하려면 `1`로 설정합니다. 플러그인 설치 및 업데이트, 그리고 `/plugin marketplace add` 및 `update`에 적용됩니다. CI 러너, 컨테이너 또는 `github.com`용 SSH 키가 구성되지 않은 환경에서 유용합니다 |

358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 하나 이상의 읽기 전용 플러그인 시드 디렉터리 경로로, Unix에서는 `:`, Windows에서는 `;`로 구분합니다. 미리 채워진 플러그인 디렉터리를 컨테이너 이미지에 번들로 포함할 때 사용합니다. Claude Code는 시작 시 이 디렉터리에서 마켓플레이스를 등록하고 다시 복제하지 않고 미리 캐시된 플러그인을 사용합니다. [컨테이너용 플러그인 미리 채우기](/docs/ko/plugins/org#seed-containers-and-ci)를 참조하십시오 |358| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 하나 이상의 읽기 전용 플러그인 시드 디렉터리 경로로, Unix에서는 `:`, Windows에서는 `;`로 구분합니다. 미리 채워진 플러그인 디렉터리를 컨테이너 이미지에 번들로 포함할 때 사용합니다. Claude Code는 시작 시 이 디렉터리에서 마켓플레이스를 등록하고 다시 복제하지 않고 미리 캐시된 플러그인을 사용합니다. [컨테이너용 플러그인 미리 채우기](/docs/ko/plugins/org#seed-containers-and-ci)를 참조하십시오 |

359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 도구 호출, 훅, 상태줄 명령을 위해 PowerShell을 생성할 때 Claude Code가 `-ExecutionPolicy Bypass`를 전달하지 않고 대신 머신의 유효 실행 정책을 따르도록 하려면 `1`로 설정합니다. 기본적으로 Claude Code는 기본값이 Restricted인 Windows 설치에서도 `.ps1` 스크립트와 모듈 가져오기가 작동하도록 프로세스 범위에서 실행 정책을 우회합니다. 이 설정과 관계없이 프로세스 범위 우회는 그룹 정책 `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다 |359| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | 도구 호출, 훅, 상태줄 명령을 위해 PowerShell을 생성할 때 Claude Code가 `-ExecutionPolicy Bypass`를 전달하지 않고 대신 머신의 유효 실행 정책을 따르도록 하려면 `1`로 설정합니다. 기본적으로 Claude Code는 기본값이 Restricted인 Windows 설치에서도 `.ps1` 스크립트와 모듈 가져오기가 작동하도록 프로세스 범위에서 실행 정책을 우회합니다. 이 설정과 관계없이 프로세스 범위 우회는 그룹 정책 `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다 |

360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` 플래그를 사용하는 [비대화형 모드](/docs/ko/headless#background-tasks-at-exit)에서 마지막 턴 이후 백그라운드 서브에이전트와 워크플로를 유휴 상태로 기다리는 시간의 상한(밀리초)입니다. Claude가 백그라운드 결과를 처리하기 위해 턴을 수행할 때마다 유휴 대기가 다시 시작됩니다. 기본값: `600000`, 즉 10분. 유휴 대기가 상한에 도달하면 Claude Code는 남은 백그라운드 작업을 더 이상 기다리지 않고 종료합니다. 무기한 기다리려면 `0`으로 설정합니다. 이 상한은 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. Claude Code v2.1.182 이상이 필요합니다 |360| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | `-p` 플래그를 사용하는 [비대화형 모드](/docs/ko/headless#background-tasks-at-exit)에서 마지막 턴 이후 서브에이전트나 워크플로와 같은 백그라운드 작업을 유휴 상태로 기다리는 시간의 상한(밀리초)입니다. Claude가 백그라운드 결과를 처리하기 위해 턴을 진행할 때마다 유휴 대기가 다시 시작됩니다. 기본값은 `600000`, 즉 10분입니다. 유휴 대기가 상한에 도달하면 Claude Code는 남은 백그라운드 작업을 기다리지 않고 종료합니다. 무기한 대기하려면 `0`으로 설정합니다. 이 상한은 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. Claude Code v2.1.182 이상이 필요합니다 |

361| `CLAUDE_CODE_PROCESS_WRAPPER` | [에이전트 뷰](/docs/ko/agent-view) 세션을 호스팅하는 백그라운드 서비스와 같이 Claude Code가 자체 바이너리에서 시작하는 프로세스를 `/opt/corp/launcher`와 같은 argv 접두사로 지정한 기업용 런처를 통해 실행합니다. 분리된 백그라운드 서비스가 상속할 수 있도록 셸 export가 아닌 사용자 설정 또는 [관리형 설정](/docs/ko/managed-settings)의 `env` 블록에서 설정하십시오. 프로젝트 및 로컬 설정에서는 설정할 수 없습니다. Claude Code v2.1.210 이상이 필요한 [`processWrapper` 설정](/docs/ko/settings-reference#processwrapper)과 동일하며, 둘 다 설정된 경우 이 변수가 우선합니다. VS Code 확장은 자체 `claudeProcessWrapper` 설정을 통해 런처를 별도로 구성합니다. Windows에서는 무시됩니다. 값 형식, 런처가 적용되는 범위, 런처가 충족해야 하는 규약에 대해서는 [기업용 런처 뒤에서 Claude Code 실행](/docs/ko/corporate-launcher)을 참조하십시오. Claude Code v2.1.208 이상이 필요합니다 |361| `CLAUDE_CODE_PROCESS_WRAPPER` | [에이전트 뷰](/docs/ko/agent-view) 세션을 호스팅하는 백그라운드 서비스와 같이 Claude Code가 자체 바이너리에서 시작하는 프로세스를 `/opt/corp/launcher`와 같은 argv 접두사로 지정한 기업용 런처를 통해 실행합니다. 분리된 백그라운드 서비스가 상속할 수 있도록 셸 export가 아닌 사용자 설정 또는 [관리형 설정](/docs/ko/managed-settings)의 `env` 블록에서 설정하십시오. 프로젝트 및 로컬 설정에서는 설정할 수 없습니다. Claude Code v2.1.210 이상이 필요한 [`processWrapper` 설정](/docs/ko/settings-reference#processwrapper)과 동일하며, 둘 다 설정된 경우 이 변수가 우선합니다. VS Code 확장은 자체 `claudeProcessWrapper` 설정을 통해 런처를 별도로 구성합니다. Windows에서는 무시됩니다. 값 형식, 런처가 적용되는 범위, 런처가 충족해야 하는 규약에 대해서는 [기업용 런처 뒤에서 Claude Code 실행](/docs/ko/corporate-launcher)을 참조하십시오. Claude Code v2.1.208 이상이 필요합니다 |

362| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR`와 함께 설정하여, Claude Code가 해당 세션의 트랜스크립트와 자동 메모리를 저장하는 `projects/` 디렉터리 이름을 작업 디렉터리 경로에서 파생된 이름 대신 직접 선택합니다. 예를 들어 `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude`로 Claude Code를 시작하면 `/srv/tenant-a/projects/work/` 아래에 저장됩니다. `CLAUDE_CONFIG_DIR`가 설정되지 않으면 Claude Code는 이 변수를 무시하며, `claude`를 시작하는 환경에서만 읽고 [설정 파일 `env` 블록](#in-settings-files)에서는 절대 읽지 않습니다. [프로젝트 디렉터리 이름 직접 지정](/docs/ko/sessions#name-the-project-directory-yourself)을 참조하십시오. Claude Code v2.1.234 이상이 필요합니다 |362| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR`와 함께 설정하여, Claude Code가 해당 세션의 트랜스크립트와 자동 메모리를 저장하는 `projects/` 디렉터리 이름을 작업 디렉터리 경로에서 파생된 이름 대신 직접 선택합니다. 예를 들어 `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude`로 Claude Code를 시작하면 `/srv/tenant-a/projects/work/` 아래에 저장됩니다. `CLAUDE_CONFIG_DIR`가 설정되지 않으면 Claude Code는 이 변수를 무시하며, `claude`를 시작하는 환경에서만 읽고 [설정 파일 `env` 블록](#in-settings-files)에서는 절대 읽지 않습니다. [프로젝트 디렉터리 이름 직접 지정](/docs/ko/sessions#name-the-project-directory-yourself)을 참조하십시오. Claude Code v2.1.234 이상이 필요합니다 |

363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Claude Code가 허용하는 유일한 값인 `5m` 또는 `1h`로 설정하여 메인 대화의 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 선택합니다. 메인 대화에는 대화형, `-p`, SDK 턴과 이와 함께 인라인으로 실행되는 헬퍼가 포함됩니다. `promptCacheTtl` 설정과 `ENABLE_PROMPT_CACHING_1H`보다 우선하며, `FORCE_PROMPT_CACHING_5M`이 이 변수를 재정의합니다. API는 1시간 캐시 쓰기에 더 높은 요금을 청구합니다. Claude Code v2.1.242 이상이 필요합니다 |363| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Claude Code가 허용하는 유일한 값인 `5m` 또는 `1h`로 설정하여 메인 대화의 [프롬프트 캐시 TTL](/docs/ko/prompt-caching#cache-lifetime)을 선택합니다. 메인 대화에는 대화형, `-p`, SDK 턴과 이와 함께 인라인으로 실행되는 헬퍼가 포함됩니다. `promptCacheTtl` 설정과 `ENABLE_PROMPT_CACHING_1H`보다 우선하며, `FORCE_PROMPT_CACHING_5M`이 이 변수를 재정의합니다. API는 1시간 캐시 쓰기에 더 높은 요금을 청구합니다. Claude Code v2.1.242 이상이 필요합니다 |

2776 Stop input2776 Stop input

2777</h4>2777</h4>

2778 2778 

2779[공통 입력 필드](#common-input-fields) 외에도, Stop 훅은 `stop_hook_active`, `last_assistant_message`, `background_tasks`, `session_crons`를 전달받습니다. `stop_hook_active` 필드는 Claude Code가 이미 stop 훅의 결과로 계속 진행 중일 때 `true`입니다. 절대 해결되지 않을 조건으로 차단하지 않도록 이 값을 확인하거나 트랜스크립트를 처리합니다. Claude Code는 연속 8회 계속 진행 한도를 적용합니다. stop 훅이 턴을 연속으로 8번 계속 진행시킨 후에는 Claude Code가 다음 차단을 재정의하고 턴을 종료합니다. 한도를 높이려면 [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/ko/env-vars)을 설정합니다.2779[공통 입력 필드](#common-input-fields) 외에도 Stop 훅은 `stop_hook_active`, `last_assistant_message`, `background_tasks`, `session_crons`를 전달받습니다. `stop_hook_active` 필드는 Claude Code가 이미 stop 훅의 결과로 계속 진행 중일 때 `true`입니다. 결코 해결되지 않을 조건에서 차단하지 않도록 이 값을 확인하거나 트랜스크립트를 처리하세요.

2780 

2781Claude Code는 연속 8회 계속 제한을 적용합니다. stop 훅이 턴을 연속으로 8회 계속시킨 후에는 Claude Code가 다음 차단을 재정의하고 턴을 종료합니다. 연속 계속 횟수는 Claude가 도구를 호출할 때마다 초기화됩니다. 제한을 늘리려면 [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/docs/ko/env-vars)을 설정합니다.

2780 2782 

2781`last_assistant_message` 필드에는 Claude의 최종 응답 텍스트 내용이 포함되므로, 훅은 트랜스크립트 파일을 파싱하지 않고도 이에 접근할 수 있습니다. 소리 내어 읽기나 알림 훅처럼 방금 완료된 턴에 대해 동작하는 훅은 `transcript_path`를 읽는 대신 이 필드를 사용합니다. 모든 버전에서 Stop 시점에 트랜스크립트 파일에 최종 메시지가 포함된다는 보장이 없기 때문입니다.2783`last_assistant_message` 필드에는 Claude의 최종 응답 텍스트 내용이 포함되므로, 훅은 트랜스크립트 파일을 파싱하지 않고도 이에 접근할 수 있습니다. 소리 내어 읽기나 알림 훅처럼 방금 완료된 턴에 대해 동작하는 훅은 `transcript_path`를 읽는 대신 이 필드를 사용합니다. 모든 버전에서 Stop 시점에 트랜스크립트 파일에 최종 메시지가 포함된다는 보장이 없기 때문입니다.

2782 2784 

1061 1061 

1062Claude가 중지하는 대신 계속 작업하다가 Stop hook이 너무 많은 횟수를 연속으로 차단했다는 경고로 턴을 종료합니다.1062Claude가 중지하는 대신 계속 작업하다가 Stop hook이 너무 많은 횟수를 연속으로 차단했다는 경고로 턴을 종료합니다.

1063 1063 

1064Claude Code는 Stop hook이 진행 없이 8번 연속으로 차단한 후 재정의합니다. Hook 스크립트는 이미 트리거되었는지 확인해야 합니다. JSON 입력에서 `stop_hook_active` 필드를 구문 분석하고 `true`인 경우 조기에 종료합니다:1064Claude Code는 Stop hook이 그 사이에 Claude의 도구 호출 없이 8번 연속으로 차단하면 해당 Stop hook을 재정의합니다. Hook 스크립트는 이미 계속 진행을 트리거했는지 확인해야 합니다. JSON 입력에서 `stop_hook_active` 필드를 구문 분석하고 `true`인 경우 조기에 종료합니다:

1065 1065 

1066```bash theme={null}1066```bash theme={null}

1067#!/bin/bash1067#!/bin/bash

71 스트리밍71 스트리밍

72</h3>72</h3>

73 73 

74추론 응답을 스트리밍합니다. Claude Code는 도착하는 대로 스트림을 읽으므로, 게이트웨이가 완전한 응답을 버퍼링한 후 릴레이하면 Claude Code가 정지됩니다.74Claude Code는 각 스트리밍 추론 응답을 도착하는 대로 이벤트 단위로 읽으므로, 게이트웨이가 스트림을 릴레이하는 방식은 사용자가 보는 내용에 영향을 줍니다:

75 75 

76각 응답의 전체 이벤트 시퀀스를 이벤트를 드롭하거나 중복하거나 재정렬하지 않고 전달합니다. Amazon Bedrock 가드레일이 응답을 차단하면, 가드레일이 보내는 이벤트가 `content_block_stop`이 이미 도착한 콘텐츠 블록을 참조하더라도 해당 이벤트를 변경 없이 전달합니다. [AWS Guardrails](/docs/ko/amazon-bedrock#aws-guardrails)는 해당 응답이 어떻게 끝나는지 설명합니다. 그 밖의 이벤트가 `content_block_start`가 도착하지 않은 콘텐츠 블록을 참조하거나, `content_block_stop`이 이미 도착한 블록을 참조할 때, Claude Code는 이를 적용하는 대신 해당 이벤트에서 스트림 읽기를 중지하므로, 중복된 `content_block_stop`은 동일한 도구 호출을 두 번 실행할 수 없습니다. [위의 응답이 불완전할 수 있습니다](/docs/ko/errors#the-response-above-may-be-incomplete)는 사용자가 보는 것을 설명하며, `Part of the response never arrived` 및 `The response stream was malformed` 변형 아래에 있습니다.76* 게이트웨이가 응답이 완료될 때까지 버퍼링하면 Claude Code가 정지됩니다.

77 77* Claude Code는 최종 `message_delta` 및 `message_stop` 이벤트까지 각 응답의 전체 이벤트 시퀀스를 순서대로 받기를 기대합니다. 콘텐츠 블록이 시작된 후 최종 `message_delta` 전에 본문이 깔끔하게 끝나면, Claude Code는 해당 응답을 끊어진 연결로 처리합니다. [위의 응답이 불완전할 수 있습니다](/docs/ko/errors#the-response-above-may-be-incomplete)는 이때 사용자가 보는 내용을 설명하며, [자동 재시도](/docs/ko/errors#automatic-retries)는 Claude Code가 대신 요청을 다시 발행하는 경우를 설명합니다.

78각 응답을 최종 `message_delta` 및 `message_stop` 이벤트를 통해 본문을 끝내기 전에 릴레이합니다. `message_delta`를 전달하는 본문이 `stop_reason`을 가지고 있고, 열린 콘텐츠 블록이 없으며, 해당 프레임 이후에 콘텐츠 블록 이벤트가 없을 때, `message_stop`이 없어도 완전한 것으로 간주됩니다. 게이트웨이가 콘텐츠 블록이 시작된 후 더 일찍 깔끔하게 끝내는 본문은 끊어진 연결과 동일하게 처리됩니다: [자동 재시도](/docs/ko/errors#automatic-retries)는 Claude Code가 요청을 다시 발행할 때를 말하며, [위의 응답이 불완전할 수 있습니다](/docs/ko/errors#the-response-above-may-be-incomplete)는 보이는 콘텐츠가 도착한 후 유지하는 것을 다룹니다. Claude Code는 `message_delta`가 전달하는 `stop_reason`을 유지하므로, 나중의 사용량 전용 `message_delta`의 `delta`가 `stop_reason: null`을 가지거나 `stop_reason` 키가 없을 때 이를 지우지 않습니다.78* Amazon Bedrock 가드레일이 응답을 차단하면, Bedrock이 보내는 이벤트가 `content_block_stop`이 이미 도착한 콘텐츠 블록을 참조할 수 있으며, Claude Code는 이 이벤트를 보낸 그대로 수신하는 것에 의존합니다. [AWS Guardrails](/docs/ko/amazon-bedrock#aws-guardrails)는 해당 응답이 어떻게 끝나는지 설명합니다.

79 79* Claude Code는 [스트리밍 유휴 타임아웃](/docs/ko/network-config#streaming-idle-watchdogs)보다 오래 바이트가 도달하지 않으면 스트리밍 응답을 중단합니다. 긴 사고 일시 중지 중에는 업스트림의 SSE `ping` 이벤트가 스트림의 유일한 바이트일 수 있으므로, 이를 제거하거나 버퍼링하는 게이트웨이는 응답 도중에 이 타임아웃을 유발할 수 있습니다. Amazon Bedrock의 이진 이벤트 스트림처럼 핑이 없는 업스트림에서 변환하는 게이트웨이도 자체 `ping` 이벤트를 내보내지 않는 한 동일한 공백이 생깁니다.

80클라이언트가 Amazon Bedrock 형식을 사용할 때, `InvokeModelWithResponseStream` 응답 본문과 `Content-Type: application/vnd.amazon.eventstream` 헤더를 수정하지 않고 릴레이하고, 스트림을 서버 전송 이벤트로 변환하지 마십시오. [게이트웨이 또는 프록시 뒤의 스트리밍 오류](/docs/ko/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)를 참조하십시오.80* [Amazon Bedrock InvokeModel 형식](#api-formats)에서 Claude Code는 `/model/{model}/invoke-with-response-stream` 응답을 Bedrock이 반환하는 이진 `application/vnd.amazon.eventstream` 본문으로 읽으며, 게이트웨이가 이를 서버 전송 이벤트로 변환하거나 해당 `Content-Type` 헤더를 다시 작성하면 파싱할 수 없습니다. [게이트웨이 또는 프록시 뒤의 스트리밍 오류](/docs/ko/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)는 이때 사용자가 보는 내용을 설명합니다.

81 

82keep-alive 핑도 전달합니다. Claude Code는 [기본적으로 5분 동안](/docs/ko/network-config#streaming-idle-watchdogs) 스트림에 바이트가 도달하지 않으면 스트리밍 응답을 중단합니다. 긴 사고 일시 중지 중에 업스트림의 SSE `ping` 이벤트는 스트림의 유일한 바이트일 수 있습니다. 게이트웨이가 이를 제거하거나 버퍼링하면 Claude Code는 일시 중지 중간에 응답을 중단합니다. Amazon Bedrock의 이진 이벤트 스트림과 같이 핑을 전혀 보내지 않는 업스트림에서 변환할 때, 침묵한 간격 동안 자신의 `ping` 이벤트를 내보냅니다.

83 81 

84<h3 id="format-mismatch-with-the-upstream">82<h3 id="format-mismatch-with-the-upstream">

85 업스트림과의 형식 불일치83 업스트림과의 형식 불일치

171 관리되는 집합과 함께 Claude in Chrome 허용171 관리되는 집합과 함께 Claude in Chrome 허용

172</h3>172</h3>

173 173 

174기본적으로 `managed-mcp.json`을 배포하면 Claude Code는 터미널 세션에서 내장 [Claude in Chrome](/docs/ko/chrome) 서버를 차단합니다. 사용자는 [확장 프로그램 설치 프롬프트](/docs/ko/chrome#install-the-extension-when-claude-asks)를 받지 않으며, 사용자가 [Chrome을 기본적으로 활성화](/docs/ko/chrome#enable-chrome-by-default)한 세션은 Chrome 없이 시작되고 경고를 출력하지 않습니다. Chrome을 실행할 수 있는 사용자가 `claude --chrome` 또는 `CLAUDE_CODE_ENABLE_CFC=1`로 시작하면 Claude Code는 `allowClaudeInChromeWithManagedMcp` 설정의 이름을 지정하는 오류와 함께 시작 시 종료됩니다.174기본적으로 `managed-mcp.json`을 배포하면 Claude Code는 터미널 세션에서 내장 [Claude in Chrome](/docs/ko/chrome) 서버를 차단합니다. 사용자는 [확장 프로그램 설치 프롬프트](/docs/ko/chrome#install-the-extension-when-claude-asks)를 받지 않으며, 사용자가 [Chrome을 기본적으로 활성화](/docs/ko/chrome#enable-chrome-by-default)한 세션은 Chrome 없이 시작되고 경고를 출력하지 않습니다. 다른 조건에서는 Claude in Chrome을 실행할 수 있는 사용자가 `claude --chrome`으로 시작하면 Claude Code는 `allowClaudeInChromeWithManagedMcp` 설정의 이름을 지정하는 오류와 함께 시작 시 종료됩니다.

175 175 

176사용자가 `managed-mcp.json`의 서버와 함께 Claude in Chrome을 실행할 수 있도록 하려면 디바이스의 자체 관리되는 설정에서 `"allowClaudeInChromeWithManagedMcp": true`를 설정하세요. MDM 배포 plist 또는 HKLM 레지스트리 키, 또는 시스템 `managed-settings.json` 파일에 배치하세요. Claude Code가 해당 디바이스에서 [선택](/docs/ko/managed-settings#precedence-within-the-managed-tier)하는 것 중 하나입니다. Claude Code v2.1.282 이상이 필요합니다. v2.1.282 이전에는 Claude Code가 설정을 무시하고 시작 오류는 `You cannot dynamically configure MCP servers when an enterprise MCP config is present` 대신 읽습니다.176사용자가 관리되는 집합과 함께 Claude in Chrome을 실행할 수 있도록 하려면 디바이스의 자체 관리형 설정에서 `"allowClaudeInChromeWithManagedMcp": true`를 설정하세요. MDM 배포 plist, HKLM 레지스트리 키 또는 시스템 `managed-settings.json` 파일 중 Claude Code가 해당 디바이스에서 [선택](/docs/ko/managed-settings#precedence-within-the-managed-tier)하는 곳에 배치하세요. Claude Code v2.1.282 이상이 필요합니다. [서버 관리형 설정](/docs/ko/server-managed-settings)이 나머지 정책을 제공하는 경우에도 Claude Code는 해당 디바이스 소스에서만 설정을 읽습니다. 설정이 켜져 있어도 `claude-in-chrome`에 대한 [`deniedMcpServers`](#policy-based-control-with-allowlists-and-denylists) 항목은 여전히 서버를 차단합니다.

177 

178Claude Code는 [서버 관리 설정](/docs/ko/server-managed-settings)이 나머지 정책을 제공할 때도 해당 디바이스 소스에서 설정을 읽습니다. 서버 관리 설정 자체, 사용자 쓰기 가능 HKCU 레지스트리, 사용자 또는 프로젝트 설정에서는 설정을 무시합니다. 설정이 켜져 있어도 [`deniedMcpServers`](#policy-based-control-with-allowlists-and-denylists) `claude-in-chrome` 항목이 여전히 서버를 차단합니다.

179 177 

180<h2 id="provide-servers-through-managed-settings">178<h2 id="provide-servers-through-managed-settings">

181 관리되는 설정을 통해 서버 제공179 관리되는 설정을 통해 서버 제공

729| 명령 치환의 출력만인 대상, `rm`이 recursive일 때 | `rm -rf "$(pwd)"` | Claude Code는 명령이 실행되기 전에 대상을 확인할 수 없습니다 |729| 명령 치환의 출력만인 대상, `rm`이 recursive일 때 | `rm -rf "$(pwd)"` | Claude Code는 명령이 실행되기 전에 대상을 확인할 수 없습니다 |

730| critical path 다음의 후행 명령 치환 | `rm -rf ~/$(cmd)` | Claude Code는 치환이 비어 있으면 남아 있을 경로(여기서는 홈 디렉토리)를 확인합니다 |730| critical path 다음의 후행 명령 치환 | `rm -rf ~/$(cmd)` | Claude Code는 치환이 비어 있으면 남아 있을 경로(여기서는 홈 디렉토리)를 확인합니다 |

731| 백슬래시만 있는 대상 | `rm -rf "\\"` | Windows의 Git Bash는 단일 백슬래시를 현재 드라이브의 루트로 읽으므로 확인이 모든 플랫폼에 적용됩니다 |731| 백슬래시만 있는 대상 | `rm -rf "\\"` | Windows의 Git Bash는 단일 백슬래시를 현재 드라이브의 루트로 읽으므로 확인이 모든 플랫폼에 적용됩니다 |

732| `/*` 또는 `/*/`로 끝나는 일부 대상 | `rm -rf logs/*/*`, `rm -rf logs/*/`, `cd logs && rm -rf a/*` | Claude Code는 명령이 실행되기 전에 이러한 대상이 어떤 디렉터리에 도달하는지 알 수 없습니다 |

732 733 

733명령 치환 출력만인 대상에 대한 확인을 끄려면 Claude Code를 시작하는 환경에서 [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/ko/env-vars#variables)을 설정합니다.734명령 치환 출력만인 대상에 대한 확인을 끄려면 Claude Code를 시작하는 환경에서 [`CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1`](/docs/ko/env-vars#variables)을 설정합니다.

734 735