Documentation 2026-10-03 23:57 UTC to 2026-10-04 14:02 UTC

347 347 

348필터를 결합하려면 `a:`, `s:`, `n:` 또는 `o:`로 시작하고 공백으로 구분하여 더 추가합니다. 목록은 모든 필터와 일치하는 세션을 표시합니다. 예를 들어 `s:blocked a:reviewer`는 입력을 기다리는 `reviewer` 세션을 나열합니다.348필터를 결합하려면 `a:`, `s:`, `n:` 또는 `o:`로 시작하고 공백으로 구분하여 더 추가합니다. 목록은 모든 필터와 일치하는 세션을 표시합니다. 예를 들어 `s:blocked a:reviewer`는 입력을 기다리는 `reviewer` 세션을 나열합니다.

349 349 

350필터가 활성화된 동안 축소한 그룹은 일치 항목을 표시하도록 펼쳐지고 첫 번째 일치 항목이 선택되므로 `Enter`를 누르면 이를 엽니다. 입력을 지우면 필터가 제거되고 해당 그룹은 다시 축소됩니다.350필터가 활성화된 동안 축소한 그룹은 일치 항목을 표시하도록 펼쳐지고 일치 항목이 선택되므로 `Enter`를 누르면 이를 엽니다. 입력을 지우면 필터가 제거되고 해당 그룹은 다시 축소됩니다.

351 351 

352<h3 id="keyboard-shortcuts">352<h3 id="keyboard-shortcuts">

353 키보드 단축키353 키보드 단축키

369| `Tab` | 빈 입력에서 모든 서브에이전트 검색. 그 외에는 강조된 제안 적용 |369| `Tab` | 빈 입력에서 모든 서브에이전트 검색. 그 외에는 강조된 제안 적용 |

370| `Ctrl+S` | 상태와 디렉토리 간 그룹화 전환 |370| `Ctrl+S` | 상태와 디렉토리 간 그룹화 전환 |

371| `Ctrl+T` | 선택된 세션 고정 또는 고정 해제 |371| `Ctrl+T` | 선택된 세션 고정 또는 고정 해제 |

372| `Ctrl+F` | [`n:` 필터](#filter-sessions)로 이름으로 세션 찾기 |

373| `Alt+↑` / `Alt+↓` | 이전 또는 다음 그룹 헤더로 이동 |

372| `Ctrl+R` | 선택된 세션 이름 바꾸기 |374| `Ctrl+R` | 선택된 세션 이름 바꾸기 |

373| `Ctrl+G` | `$VISUAL` 또는 `$EDITOR`에서 디스패치 프롬프트 열기 |375| `Ctrl+G` | `$VISUAL` 또는 `$EDITOR`에서 디스패치 프롬프트 열기 |

374| `Ctrl+J` | 디스패치 입력에 줄 바꿈 삽입 |376| `Ctrl+J` | 디스패치 입력에 줄 바꿈 삽입 |

378| `Ctrl+C` | 입력 지우기; 두 번 눌러 종료 |380| `Ctrl+C` | 입력 지우기; 두 번 눌러 종료 |

379| `?` | 모든 단축키 표시 |381| `?` | 모든 단축키 표시 |

380 382 

381`Ctrl+S`, `Ctrl+T` 및 `Ctrl+G`는 [`keybindings.json`](/docs/ko/keybindings)을 따릅니다. [`Agents` 컨텍스트](/docs/ko/keybindings#agents-actions)의 `agents:switchView` 및 `agents:togglePin` 작업으로 `Ctrl+S` 및 `Ctrl+T`를 다시 바인딩하거나 바인딩 해제하고, `Chat` 컨텍스트의 `chat:externalEditor` 바인딩을 통해 `Ctrl+G`를 다시 바인딩합니다. 표의 다른 단축키는 다시 바인딩할 수 없습니다.383[`Agents` 컨텍스트](/docs/ko/keybindings#agents-actions)에 작업이 있는 단축키는 [`keybindings.json`](/docs/ko/keybindings)을 따릅니다. `Ctrl+G`도 `Chat` 컨텍스트의 `chat:externalEditor` 바인딩을 통해 마찬가지로 따릅니다.

382 384 

383<h2 id="dispatch-new-agents">385<h2 id="dispatch-new-agents">

384 새로운 에이전트 디스패치386 새로운 에이전트 디스패치

1087 1089 

1088| 버전 | 변경 사항 |1090| 버전 | 변경 사항 |

1089| - | - |1091| - | - |

1092| v2.1.288 | `Ctrl+F`는 이름으로 세션을 찾고, `Alt+↑` / `Alt+↓`는 그룹 헤더 사이를 이동합니다. 이 두 가지와 `Ctrl+R`은 [다시 바인딩](/docs/ko/keybindings#agents-actions)할 수 있습니다. |

1090| v2.1.287 | [`n:<text>` 필터](#filter-sessions)는 이름이나 첫 프롬프트로 세션을 찾습니다. 필터가 활성화되어 있는 동안에는 접어 둔 그룹이 펼쳐져 일치 항목을 표시하고 첫 번째 일치 항목이 선택되므로 `Enter`로 바로 열 수 있습니다. |1093| v2.1.287 | [`n:<text>` 필터](#filter-sessions)는 이름이나 첫 프롬프트로 세션을 찾습니다. 필터가 활성화되어 있는 동안에는 접어 둔 그룹이 펼쳐져 일치 항목을 표시하고 첫 번째 일치 항목이 선택되므로 `Enter`로 바로 열 수 있습니다. |

1091| v2.1.287 | [엿보기 회신](#peek-and-reply)으로 보낸 명령은 세션의 현재 턴이 끝날 때 실행되며, 세션 자체 프롬프트에서 입력하는 즉시 실행되는 명령도 마찬가지입니다. 정확히 `/stop`인 회신은 세션을 즉시 중지합니다. |1094| v2.1.287 | [엿보기 회신](#peek-and-reply)으로 보낸 명령은 세션의 현재 턴이 끝날 때 실행되며, 세션 자체 프롬프트에서 입력하는 즉시 실행되는 명령도 마찬가지입니다. 정확히 `/stop`인 회신은 세션을 즉시 중지합니다. |

1092| v2.1.281 | [`--setting-sources`](/docs/ko/cli-reference#cli-flags) 제한이 `←` 또는 `/bg`로 백그라운드하는 세션과 에이전트 뷰에서 디스패치하는 세션으로 [이월](#what-carries-over-when-you-background)됩니다. 이 릴리스 이전에는 생성된 세션이 모든 설정 소스를 로드했습니다. |1095| v2.1.281 | [`--setting-sources`](/docs/ko/cli-reference#cli-flags) 제한이 `←` 또는 `/bg`로 백그라운드하는 세션과 에이전트 뷰에서 디스패치하는 세션으로 [이월](#what-carries-over-when-you-background)됩니다. 이 릴리스 이전에는 생성된 세션이 모든 설정 소스를 로드했습니다. |

156 Claude가 댓글에 자동으로 답변하도록 허용156 Claude가 댓글에 자동으로 답변하도록 허용

157</h3>157</h3>

158 158 

159세션이 아티팩트를 게시한 후 Claude Code는 세션이 실행되는 동안 해당 아티팩트의 댓글을 감시합니다. 아티팩트를 편집할 수 있는 사람이 Claude에게 댓글을 보내면 즉시 세션에 도달하고, Claude는 스레드를 읽고 당신이 요청하지 않아도 답변할 수 있습니다.159세션이 아티팩트를 게시한 후 Claude Code는 해당 아티팩트의 댓글을 감시합니다. 아티팩트를 편집할 수 있는 사람이 Claude에게 댓글을 보내면 즉시 세션에 도달하고, Claude는 사용자가 요청하지 않아도 스레드를 읽고 답변할 수 있습니다.

160 160 

161Claude Code v2.1.228 이상이 필요합니다. [기능 플래그 가져오기](/docs/ko/env-vars#features-that-need-feature-flag-fetching)를 끄면 Claude Code는 댓글을 감시하지 않습니다.161Claude Code v2.1.228 이상이 필요합니다. [기능 플래그 가져오기](/docs/ko/env-vars#features-that-need-feature-flag-fetching)를 끄면 Claude Code는 댓글을 감시하지 않습니다.

162 162 

174* **`/tasks`에서 작업을 중지합니다**: Claude는 당신이 해당 아티팩트에서 답변을 재개하도록 요청할 때까지 해당 아티팩트에 답변하는 것을 중지합니다. 아티팩트를 다시 게시해도 답변이 다시 시작되지 않으며, 세션을 재개할 때도 중지가 계속 적용됩니다.174* **`/tasks`에서 작업을 중지합니다**: Claude는 당신이 해당 아티팩트에서 답변을 재개하도록 요청할 때까지 해당 아티팩트에 답변하는 것을 중지합니다. 아티팩트를 다시 게시해도 답변이 다시 시작되지 않으며, 세션을 재개할 때도 중지가 계속 적용됩니다.

175* **3초 내에 `Ctrl+X Ctrl+K`를 두 번 누릅니다**: [모든 실행 중인 백그라운드 서브에이전트를 중지](/docs/ko/interactive-mode#general-controls)하는 코드는 또한 Claude가 세션의 나머지 기간 동안 모든 아티팩트에 답변하는 것을 중지합니다. Claude에게 답변을 재개하도록 요청해도 이 중지는 취소되지 않습니다.175* **3초 내에 `Ctrl+X Ctrl+K`를 두 번 누릅니다**: [모든 실행 중인 백그라운드 서브에이전트를 중지](/docs/ko/interactive-mode#general-controls)하는 코드는 또한 Claude가 세션의 나머지 기간 동안 모든 아티팩트에 답변하는 것을 중지합니다. Claude에게 답변을 재개하도록 요청해도 이 중지는 취소되지 않습니다.

176 176 

177Claude Code가 자동으로 시작한 감시는 아티팩트에 몇 시간 동안 활동이 없으면 종료될 수 있습니다. 감시를 다시 시작하려면 아티팩트를 다시 게시하거나 Claude에게 감시하도록 요청하십시오.

178 

177댓글을 전달하는 서비스를 사용할 수 없거나 응답을 중지하면 Claude Code는 한동안 다시 연결을 시도한 후 세션이 감시 중이던 각 아티팩트 감시를 중지합니다.179댓글을 전달하는 서비스를 사용할 수 없거나 응답을 중지하면 Claude Code는 한동안 다시 연결을 시도한 후 세션이 감시 중이던 각 아티팩트 감시를 중지합니다.

178 180 

179<h2 id="pull-live-data-with-mcp-connectors">181<h2 id="pull-live-data-with-mcp-connectors">

261 개발자 연결261 개발자 연결

262</h2>262</h2>

263 263 

264개발자는 자신의 노트북에서 한 번의 브라우저 로그인으로 회사 업무 계정을 사용하여 연결합니다. 요청이 조직의 업스트림 자격증명을 사용하여 게이트웨이를 통해 모델로 가기 때문에 claude.ai 계정, API 키 또는 구독이 필요하지 않습니다. 연결은 MDM을 통해 푸시하는 [클라이언트 측 관리 설정](/docs/ko/claude-apps-gateway-config#client-side-managed-settings)에 의해 구동되므로, 개발자 측에는 수동 설정이 없습니다; 이 섹션은 관리자가 구성하는 것을 다룹니다.264개발자는 자신의 노트북에서 한 번의 브라우저 로그인으로 회사 업무 계정을 사용하여 연결합니다. 모델에 대한 요청이 조직의 업스트림 자격 증명을 사용하여 게이트웨이를 거치기 때문에 claude.ai 계정, API 키 또는 구독이 필요하지 않습니다. 연결은 MDM을 통해 푸시하는 [클라이언트 측 관리형 설정](/docs/ko/claude-apps-gateway-config#client-side-managed-settings)에 의해 구동되므로 개발자 측에서 수동으로 설정할 것이 없습니다. 이 섹션에서는 관리자가 구성하는 내용을 다룹니다.

265 265 

266CLI는 첫 연결 시 게이트웨이의 TLS 리프 인증서를 지문 처리하고 호스트명별로 고정합니다. 로그인 중, 자동 세션 새로 고침 중, 관리 설정 가져오기 중에 해당 핀을 다시 확인하는 반면, 추론 요청은 핀 없이 표준 TLS 검증을 사용합니다. HTTPS 프록시를 통해 라우팅된 요청은 핀 검사를 건너뛰므로, 게이트웨이 호스트를 `NO_PROXY`에 추가하여 직접 연결을 유지하세요.266CLI는 첫 연결 시 게이트웨이의 TLS 리프 인증서 지문을 생성하고 호스트명별로 고정합니다. 로그인 중, 자동 세션 새로 고침 중, 관리형 설정 가져오기 중에 해당 핀을 다시 확인하며, 추론 요청은 핀 없이 표준 TLS 검증을 사용합니다. HTTPS 프록시를 통해 라우팅된 요청은 핀 검사를 건너뛰므로, 게이트웨이 호스트를 `NO_PROXY`에 추가하여 직접 연결을 유지하세요.

267 267 

268예상 SHA-256 지문을 게이트웨이 URL과 함께 게시하여 개발자가 비교할 것이 있도록 하세요. `/login` 프롬프트는 지문의 처음 16자를 소문자 16진수로 콜론 없이 표시합니다. 인증서 파일에서 해당 형식의 전체 지문을 인쇄하려면 다음을 실행하세요:268개발자가 비교할 수 있도록 예상 SHA-256 지문을 게이트웨이 URL과 함께 게시하세요. `/login` 프롬프트는 지문의 처음 16자를 콜론 없는 소문자 16진수로 표시합니다. 인증서 파일에서 해당 형식의 전체 지문을 출력하려면 다음을 실행하세요.

269 269 

270```bash theme={null}270```bash theme={null}

271openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'271openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'

272```272```

273 273 

274인증서가 회전하면 모든 개발자가 신뢰 프롬프트를 다시 보므로, 회전을 계획된 이벤트로 취급하고 지문을 다시 게시하세요. 게이트웨이 정책에 [승인이 필요한 설정](/docs/ko/server-managed-settings#security-approval-dialogs)이 포함되어 있으면, 개발자는 새 인증서를 수락한 후 승인 대화상자를 다시 보게 됩니다. Claude Code는 [승인 메모리](/docs/ko/server-managed-settings#approval-memory)를 고정된 인증서에 키 지정하기 때문입니다.274인증서가 교체되면 모든 개발자에게 신뢰 프롬프트가 다시 표시되므로, 교체를 계획된 이벤트로 취급하고 지문을 다시 게시하세요. 게이트웨이 정책에 [승인이 필요한 설정](/docs/ko/server-managed-settings#security-approval-dialogs)이 포함되어 있으면, 개발자는 새 인증서를 수락한 후 해당 승인 대화상자도 다시 보게 됩니다. Claude Code가 [승인 메모리](/docs/ko/server-managed-settings#approval-memory)를 고정된 인증서에 연결하기 때문입니다.

275 275 

276게이트웨이는 토큰 응답에서 선택적 `email` 필드를 반환하여 로그인이 사용한 계정의 이름을 지정할 수 있습니다. 이렇게 하면, 개발자는 Claude Code가 자격증명을 저장하기 전에 계정을 확인합니다. 확인된 로그인 후, `/status`는 계정을 표시합니다.276게이트웨이는 토큰 응답에서 선택적 `email` 필드를 반환하여 로그인에 사용된 계정을 지정할 수 있습니다. 이 경우 개발자는 Claude Code가 자격 증명을 저장하기 전에 계정을 확인합니다. 확인된 로그인 후에는 `/status`에 해당 계정이 표시됩니다.

277 277 

278확인은 개발자 머신의 Claude Code v2.1.275 이상이 필요합니다; 해당 버전 아래의 클라이언트는 필드를 무시합니다. `claude` 바이너리의 게이트웨이 서버는 필드를 반환하지 않으므로, 해당 로그인은 확인 없이 완료됩니다.278이 확인에는 개발자 머신에 Claude Code v2.1.275 이상이 필요하며, 그보다 낮은 버전의 클라이언트는 이 필드를 무시합니다. `claude` 바이너리의 게이트웨이 서버는 이 필드를 반환하지 않으므로, 해당 서버를 통한 로그인은 확인 없이 완료됩니다.

279 279 

280개발자가 로그인하면, [모델 선택기](/docs/ko/model-config)는 개발자의 `availableModels` 허용 목록의 모델을 표시합니다. 관리 설정은 시작 시 적용되고 매시간 새로 고쳐지며, 텔레메트리는 수집기로 라우팅됩니다.280개발자가 로그인하면 [모델 선택기](/docs/ko/model-config)에 개발자의 `availableModels` 허용 목록에 있는 모델이 표시됩니다. 관리형 설정은 시작 시 적용되고 매시간 새로 고쳐지며, 텔레메트리는 수집기로 라우팅됩니다.

281 281 

282세션은 `ttl_hours` 만료 전에 자동으로 새로 고쳐집니다. IdP 프로비저닝 해제 후 새로 고침이 실패하면, Claude Code는 개발자에게 다시 로그인하도록 프롬프트합니다.282세션은 `ttl_hours` 만료 전에 자동으로 새로 고쳐집니다. IdP 프로비저닝 해제 후 새로 고침이 실패하면 Claude Code는 개발자에게 다시 로그인하라고 요청합니다.

283 283 

284<h3 id="set-the-gateway-url">284<h3 id="set-the-gateway-url">

285 게이트웨이 URL 설정285 게이트웨이 URL 설정

286</h3>286</h3>

287 287 

288MDM을 통해 또는 디스크에 직접 배포하는 OS별 [관리 설정 파일](/docs/ko/managed-settings#delivery-mechanisms)에 세 개의 키가 들어갑니다. `forceLoginMethod`와 `forceLoginGatewayUrl`은 URL이 채워진 **Cloud gateway** 화면에서 직접 `/login`을 열고, `parentSettingsBehavior: "merge"`는 Claude Desktop이 게이트웨이의 송신 허용 목록을 시작하는 Claude Code 세션에 전달하도록 하며, 이는 [Claude Desktop 세션에 정책 전달](#deliver-policy-to-claude-desktop-sessions)에서 설명합니다:288MDM을 통해 또는 디스크에 직접 배포하는 OS별 [관리형 설정 파일](/docs/ko/managed-settings#delivery-mechanisms)에 세 개의 키가 들어갑니다. `forceLoginMethod`와 `forceLoginGatewayUrl`은 URL이 채워진 **Cloud gateway** 화면에서 `/login`을 바로 열고, `parentSettingsBehavior: "merge"`는 Claude Desktop이 게이트웨이의 송신 허용 목록을 자신이 시작하는 Claude Code 세션에 전달할 수 있게 합니다. 이는 [Claude Desktop 세션에 정책 전달](#deliver-policy-to-claude-desktop-sessions)에서 설명합니다.

289 289 

290```json theme={null}290```json theme={null}

291{291{

295}295}

296```296```

297 297 

298개발자는 Enter를 눌러 연결합니다. [첫 연결 TLS 지문 프롬프트](#connect-developers)는 여전히 나타납니다. 파일이 머신에 있으면, 게이트웨이 로그인을 완료하지 않은 개발자는 [Administrator policy requires a Cloud gateway sign-in](/docs/ko/errors#administrator-policy-requires-a-cloud-gateway-sign-in)에서 설명한 메시지 중 하나를 봅니다. `CLAUDE_CODE_USE_BEDROCK` 같은 환경 변수를 통해 클라우드 제공자를 선택하는 개발자는 게이트웨이 로그인이 필요하지 않습니다.298개발자는 Enter를 눌러 연결합니다. [첫 연결 TLS 지문 프롬프트](#connect-developers)는 여전히 나타납니다. 파일이 머신에 배포되면, 게이트웨이 로그인을 완료하지 않은 개발자는 [Administrator policy requires a Cloud gateway sign-in](/docs/ko/errors#administrator-policy-requires-a-cloud-gateway-sign-in)에 설명된 메시지 중 하나를 보게 됩니다. `CLAUDE_CODE_USE_BEDROCK` 같은 환경 변수를 통해 클라우드 제공자를 선택하는 개발자는 게이트웨이 로그인이 필요하지 않습니다.

299 299 

300개발자가 수동으로 이를 설정할 수 없습니다. 로그인 선택기에는 게이트웨이 옵션이 없으며, `forceLoginGatewayUrl`은 개발자의 자신의 설정 파일에서 무시됩니다. `forceLoginMethod`만, URL 없이, 개발자를 "IT 관리자에게 문의하세요" 메시지에 남깁니다. 로그인 키는 머신으로 푸시하는 파일에 속하며, 게이트웨이의 `managed.policies[].cli` 블록에는 속하지 않습니다. 이 블록은 이미 연결된 클라이언트에만 도달합니다.300개발자는 이를 수동으로 설정할 수 없습니다. 로그인 선택기에는 게이트웨이 옵션이 없으며, `forceLoginGatewayUrl`은 개발자 자신의 설정 파일에서는 무시됩니다. URL 없이 `forceLoginMethod`만 설정하면 개발자에게 "IT 관리자에게 문의하세요" 메시지만 표시됩니다. 로그인 키는 머신에 푸시하는 파일에 넣어야 하며, 이미 연결된 클라이언트에만 도달하는 게이트웨이의 `managed.policies[].cli` 블록에 넣으면 안 됩니다.

301 301 

302<h3 id="allow-a-gateway-on-public-address-space-you-own">302<h3 id="allow-a-gateway-on-public-address-space-you-own">

303 공개 주소 공간에서 소유한 게이트웨이 허용303 소유한 공인 주소 공간의 게이트웨이 허용

304</h3>304</h3>

305 305 

306일부 조직은 자신이 소유한 공개 IPv4 블록(예: 통신사의 자신의 주소 공간 또는 레거시 `/8`)에서 내부 네트워크를 번호 지정하므로, 게이트웨이는 개인 주소를 가질 수 없습니다. 이러한 블록을 `gatewayInternalNetworks` 관리 설정에 나열하세요. `/login`은 개발자의 머신이 동일한 블록 내의 주소에서 연결할 때 나열된 블록 내의 게이트웨이를 수락합니다. 이는 개발자 머신의 Claude Code v2.1.268 이상이 필요합니다; 이전 버전은 키를 무시하고 개인 주소 규칙을 적용합니다.306일부 조직은 통신사 자체 주소 공간이나 레거시 `/8`처럼 자신이 소유한 공인 IPv4 블록으로 내부 네트워크 주소를 할당하므로, 게이트웨이가 사설 주소를 가질 수 없습니다. 이러한 블록을 `gatewayInternalNetworks` 관리형 설정에 나열하세요. 그러면 `/login`은 개발자 머신이 나열된 블록 내의 주소에서 동일한 블록 내의 게이트웨이에 연결할 때 해당 게이트웨이를 수락합니다. 이를 위해서는 개발자 머신에 Claude Code v2.1.268 이상이 필요하며, 이전 버전은 이 키를 무시하고 사설 주소 규칙을 적용합니다.

307 307 

308<Warning>308<Warning>

309 `gatewayInternalNetworks`는 공개 주소 공간에서 번호 지정되는 내부 네트워크용입니다. 게이트웨이를 인터넷에 노출하는 것을 안전하게 만들지 않습니다: 신뢰할 수 있는 게이트웨이는 개발자 머신에서 명령을 실행하는 설정을 푸시할 수 있습니다.309 `gatewayInternalNetworks`는 공인 주소 공간으로 번호가 지정된 내부 네트워크를 위한 것입니다. 이 설정이 게이트웨이를 인터넷에 노출하는 것을 안전하게 만들지는 않습니다. 신뢰된 게이트웨이는 개발자 머신에서 명령을 실행하는 설정을 푸시할 수 있습니다.

310 310 

311 방화벽 또는 로드 밸런서 규칙으로 게이트웨이를 네트워크 외부에서 도달할 수 없게 유지하세요. 게이트웨이의 [`access_control.allow_cidrs`](/docs/ko/claude-apps-gateway-config#http-tuning)를 여기에서 선언한 동일한 블록으로 설정하여 게이트웨이 자체가 다른 곳의 클라이언트를 거부하도록 하세요. 로드 밸런서 또는 수신 뒤에서, 게이트웨이가 개발자의 주소가 아닌 프론트 엔드의 자신의 주소에 대해 `allow_cidrs`를 일치시키기 때문에 `listen.trusted_proxies`를 해당 프론트 엔드로 설정하세요.311 방화벽 또는 로드 밸런서 규칙으로 게이트웨이가 네트워크 외부에서 접근할 수 없도록 유지하세요. 게이트웨이의 [`access_control.allow_cidrs`](/docs/ko/claude-apps-gateway-config#http-tuning)를 여기에서 선언한 것과 동일한 블록으로 설정하여 게이트웨이 자체가 다른 곳의 클라이언트를 거부하도록 하세요. 로드 밸런서나 인그레스 뒤에서는 `listen.trusted_proxies`도 해당 프런트 엔드로 설정하세요. 그렇지 않으면 게이트웨이가 개발자의 주소가 아니라 프런트 엔드 자체의 주소를 `allow_cidrs`와 대조하기 때문입니다.

312</Warning>312</Warning>

313 313 

314키를 로그인 키와 동일한 관리 설정 소스에 추가하세요: 관리 설정 파일, MDM 프로필 또는 레지스트리 정책. Claude Code는 사용자, 프로젝트, 서버 관리 설정에서 이를 무시합니다.314이 키는 로그인 키와 동일한 관리형 설정 소스, 즉 관리형 설정 파일, MDM 프로필 또는 레지스트리 정책에 추가하세요. Claude Code는 사용자, 프로젝트, 서버 관리형 설정에 있는 이 키를 무시합니다.

315 315 

316이 예제는 하나의 블록을 선언합니다. `203.0.113.0/24`를 자신의 블록으로 바꾸세요. 이는 문서 범위이며, Claude Code는 이를 거부합니다.316이 예제는 하나의 블록을 선언합니다. `203.0.113.0/24`를 자신의 블록으로 바꾸세요. 이 주소는 문서용 범위이며, Claude Code는 문서용 범위를 거부합니다.

317 317 

318```json theme={null}318```json theme={null}

319{319{

321}321}

322```322```

323 323 

324Claude Code는 게이트웨이에 연결하기 전에 `/login`에서 목록을 검증합니다:324Claude Code는 게이트웨이에 연결하기 전에 `/login`에서 목록을 검증합니다.

325 325 

326* 각 항목은 첫 주소와 `/8`에서 `/32` 사이의 접두사로 작성된 IPv4 블록입니다.326* 각 항목은 첫 번째 주소와 `/8`에서 `/32` 사이의 접두사로 작성된 IPv4 블록입니다.

327* 목록은 최대 4개의 블록을 보유하며, 2개는 겹치지 않습니다.327* 목록에는 최대 4개의 블록을 넣을 수 있으며, 서로 겹치는 블록이 없어야 합니다.

328* 블록은 개인 주소 공간과 겹치지 않습니다: `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `127.0.0.0/8`, `169.254.0.0/16`, `100.64.0.0/10`. `/login`은 이미 이 키 없이 거기에서 게이트웨이를 수락합니다.328* 어떤 블록도 사설 주소 공간 `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `127.0.0.0/8`, `169.254.0.0/16`, `100.64.0.0/10`과 겹치지 않아야 합니다. `/login`은 이 키 없이도 해당 공간의 게이트웨이를 이미 수락합니다.

329* 블록은 조직의 네트워크가 될 수 없는 공간과 겹치지 않습니다: VPN 및 NAT64 클라이언트가 로컬 주소로 보유하는 `198.18.0.0/15` 및 `192.0.0.0/24`; 문서 범위 `192.0.2.0/24`, `198.51.100.0/24`, `203.0.113.0/24`; 예약된 범위 `0.0.0.0/8`, `192.88.99.0/24`, 멀티캐스트 `224.0.0.0/4`. `240.0.0.0/4` 내의 블록을 선언할 수 있으며, 일부 대규모 네트워크는 이를 내부 유니캐스트 공간으로 사용합니다.329* 어떤 블록도 조직의 네트워크가 될 수 없는 공간과 겹치지 않아야 합니다. 여기에는 VPN 및 NAT64 클라이언트가 로컬 주소로 사용하는 `198.18.0.0/15` 및 `192.0.0.0/24`, 문서용 범위 `192.0.2.0/24`, `198.51.100.0/24`, `203.0.113.0/24`, 예약 범위 `0.0.0.0/8`, `192.88.99.0/24`, 멀티캐스트 `224.0.0.0/4`가 포함됩니다. 일부 대규모 네트워크가 내부 유니캐스트 공간으로 사용하는 `240.0.0.0/4` 내의 블록은 선언할 수 있습니다.

330 330 

331`managed-settings.json` 및 해당 `managed-settings.d/` 드롭인 파일의 블록은 하나의 목록으로 결합되며, 이러한 제한은 결합된 목록에 적용됩니다. 블록을 좁히려면, 드롭인에서 두 번째 겹치는 항목을 추가하는 대신 항목을 바꾸세요; `/login`은 겹침을 거부합니다.331`managed-settings.json`과 해당 `managed-settings.d/` 드롭인 파일의 블록은 하나의 목록으로 결합되며, 이러한 제한은 결합된 목록에 적용됩니다. 블록을 좁히려면 드롭인에 겹치는 두 번째 항목을 추가하지 말고 기존 항목을 교체하세요. `/login`은 겹침을 거부합니다.

332 332 

333항목이 규칙을 위반하거나 값이 문자열 목록이 아니면, Claude Code는 해당 머신에서 모든 새 게이트웨이 로그인을 거부하고 메시지에서 문제를 지정합니다. 개인 주소의 게이트웨이로 로그인도 실패하며, 기존 로그인은 계속 작동합니다. 배포하기 전에 한 머신에서 값을 시도하세요. Claude Code는 또한 잘못 입력된 값을 [보고하는 잘못된 관리 설정](/docs/ko/managed-settings#keys-that-fail-closed) 중에 나열합니다.333항목이 규칙을 위반하거나 값이 문자열 목록이 아니면, Claude Code는 해당 머신에서 새로운 모든 게이트웨이 로그인을 거부하고 메시지에 문제를 명시합니다. 사설 주소에 있는 게이트웨이로의 로그인도 실패하며, 기존 로그인은 계속 작동합니다. 배포하기 전에 한 머신에서 값을 시험해 보세요. Claude Code는 잘못된 타입의 값도 [보고하는 잘못된 관리형 설정](/docs/ko/managed-settings#keys-that-fail-closed) 목록에 포함합니다.

334 334 

335유효한 목록으로, `/login`은 주소가 나열된 블록 내에 있는 게이트웨이에 3가지 검사를 적용합니다:335목록이 유효하면, `/login`은 주소가 나열된 블록 내에 있는 게이트웨이에 세 가지 검사를 적용합니다.

336 336 

337* 게이트웨이의 호스트명이 확인하는 모든 주소는 해당 하나의 블록 내에 있습니다. Claude Code는 개인 및 IPv6 주소를 포함하여 블록 외부에도 레코드가 있는 이름을 거부합니다.337* 게이트웨이의 호스트명이 확인되는 모든 주소가 해당 하나의 블록 내에 있어야 합니다. Claude Code는 사설 주소와 IPv6 주소를 포함하여 블록 외부에도 레코드가 있는 이름을 거부합니다.

338* 개발자의 머신은 동일한 블록 내의 주소에서 연결합니다. Claude Code는 NAT 뒤, 컨테이너 또는 WSL2 내, 주소 풀이 블록 외부에 있는 VPN의 머신을 거부하고, 머신이 연결한 주소를 지정합니다.338* 개발자 머신이 동일한 블록 내에서 연결해야 합니다. Claude Code는 NAT 뒤, 컨테이너 또는 WSL2 내부, 주소 풀이 블록 외부에 있는 VPN에 있는 머신을 거부하고, 머신이 연결한 주소를 명시합니다.

339* 연결은 직접입니다. `HTTPS_PROXY`가 게이트웨이 호스트에 적용되면, `/login`은 거부하고 추가할 `NO_PROXY` 항목을 지정합니다.339* 연결이 직접 연결이어야 합니다. `HTTPS_PROXY`가 게이트웨이 호스트에 적용되면 `/login`은 거부하고 추가해야 할 `NO_PROXY` 항목을 명시합니다.

340 340 

3413가지 모두 통과하면, [신뢰 프롬프트](#connect-developers)는 머신의 주소, 게이트웨이의 주소, 둘 다를 포함하는 선언된 블록을 지정하는 줄을 추가합니다.341세 가지를 모두 통과하면 [신뢰 프롬프트](#connect-developers)에 머신의 주소, 게이트웨이의 주소, 그리고 둘을 모두 포함하는 선언된 블록을 명시하는 줄이 추가됩니다.

342 342 

343키는 다른 게이트웨이에 대해 아무것도 변경하지 않습니다: 개인 주소의 게이트웨이로 로그인은 이전처럼 작동하며, 모든 나열된 블록 외부의 공개 주소의 게이트웨이로 로그인은 이전처럼 거부됩니다.343이 키는 다른 게이트웨이에는 아무 영향도 주지 않습니다. 사설 주소에 있는 게이트웨이로의 로그인은 이전처럼 작동하며, 나열된 모든 블록 외부의 공인 주소에 있는 게이트웨이로의 로그인은 이전처럼 거부됩니다.

344 344 

345선언된 블록은 누가 로그인할 수 있는지를 좁히지만 머신이 어디에 있는지를 증명하지 않으므로, 조직이 제어하는 주소 공간만 선언하세요. 클라우드 제공자의 공개 범위와 같이 다른 테넌트와 공유되는 블록은 이를 통과하는 누구나 동일한 검사를 통과하도록 합니다.345선언된 블록은 로그인할 수 있는 대상을 좁히지만 머신의 위치를 증명하지는 않으므로, 조직이 제어하는 주소 공간만 선언하세요. 클라우드 제공자의 공인 범위처럼 다른 테넌트와 공유되는 블록을 선언하면, 그 안의 누구나 동일한 검사를 통과할 수 있습니다.

346 346 

347<h3 id="deliver-policy-to-claude-desktop-sessions">347<h3 id="deliver-policy-to-claude-desktop-sessions">

348 Claude Desktop 세션에 정책 전달348 Claude Desktop 세션에 정책 전달

349</h3>349</h3>

350 350 

351Claude Desktop은 Cowork 및 Code 탭과 Chat 탭(활성화한 경우)을 포함된 Claude Code 세션에서 실행하고 해당 모델 요청을 게이트웨이를 통해 보냅니다. 게이트웨이가 `/user/bootstrap`에서 제공하는 구성에서 구축된 정책을 각 세션에 전달합니다: 모델 허용 목록, 비활성화된 도구, 일치하는 정책의 `cli` 블록에서 파생된 송신 허용 목록, 그리고 [`desktop` 오버레이](/docs/ko/claude-apps-gateway-config#claude-desktop-overlay).351Claude Desktop은 Cowork 및 Code 탭과, 활성화한 경우 Chat 탭을 내장된 Claude Code 세션에서 실행하고, 해당 모델 요청을 게이트웨이를 통해 보냅니다. Claude Desktop은 게이트웨이가 `/user/bootstrap`에서 제공하는 구성으로 만든 정책을 각 세션에 전달합니다. 여기에는 일치하는 정책의 `cli` 블록에서 파생된 모델 허용 목록, 비활성화된 도구, 송신 허용 목록과 [`desktop` 오버레이](/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)가 포함됩니다.

352 352 

353hooks, `env`, `Bash(npm *)` 같은 범위가 지정된 권한 규칙 등 다른 `cli` 키는 `/login`을 통해 로그인하는 클라이언트에만 도달합니다. Claude Desktop은 게이트웨이 URL을 자신의 관리 구성에서 읽고 [게이트웨이 URL 설정](#set-the-gateway-url)의 `forceLoginMethod` 및 `forceLoginGatewayUrl` 키와 별개인 자신의 흐름으로 로그인합니다.353훅, `env`, `Bash(npm *)` 같은 범위 지정 권한 규칙 등 다른 `cli` 키는 `/login`을 통해 로그인하는 클라이언트에만 도달합니다. Claude Desktop은 게이트웨이 URL을 자체 관리형 구성에서 읽고, [게이트웨이 URL 설정](#set-the-gateway-url)의 `forceLoginMethod` 및 `forceLoginGatewayUrl` 키와는 별개인 자체 흐름으로 로그인합니다.

354 354 

355시작 프로세스에서 전달된 설정은 부모 설정입니다. Claude Code는 정책을 전달하는 [소스](/docs/ko/managed-settings#which-managed-source-claude-code-uses)가 `parentSettingsBehavior: "merge"`를 설정하지 않는 한, 관리 배포된 관리 소스가 있는 모든 머신에서 부모 설정을 무시합니다.355시작하는 프로세스가 전달하는 설정은 부모 설정입니다. Claude Code는 [정책을 전달하는 소스](/docs/ko/managed-settings#which-managed-source-claude-code-uses)가 `parentSettingsBehavior: "merge"`를 설정하지 않는 한, 관리자가 배포한 관리형 소스가 있는 모든 머신에서 부모 설정을 무시합니다.

356 356 

357<h4 id="which-machines-need-the-opt-in">357<h4 id="which-machines-need-the-opt-in">

358 옵트인이 필요한 머신358 옵트인이 필요한 머신

359</h4>359</h4>

360 360 

361Claude Desktop만 실행하는 머신에는 옵트인이 필요합니다. Claude Desktop은 모델 목록과 비활성화된 도구 목록을 포함된 세션에 자체적으로 적용하지만, 송신 허용 목록은 `WebFetch` 도메인 규칙 및 샌드박스 네트워크 규칙 형태의 부모 설정으로만 도달합니다. 옵트인 없이, 이러한 세션은 송신 제한 없이 실행되며, 아무것도 경고하지 않습니다. 게이트웨이는 여전히 정책이 부여하지 않는 모델에 대한 추론 요청을 거부합니다.361Claude Desktop만 실행하는 머신에는 옵트인이 필요합니다. Claude Desktop은 모델 목록과 비활성화된 도구 목록을 내장된 세션에 직접 적용하지만, 송신 허용 목록은 `WebFetch` 도메인 규칙과 샌드박스 네트워크 규칙 형태의 부모 설정으로만 도달합니다. 옵트인이 없으면 이러한 세션은 송신 제한 없이 실행되며, 아무런 경고도 표시되지 않습니다. 게이트웨이는 여전히 정책이 허용하지 않는 모델에 대한 추론 요청을 거부합니다.

362 362 

363플러그인 마켓플레이스 허용 목록도 포함된 세션에만 부모 설정으로 도달합니다. Claude Desktop의 관리 구성에서 사용자 추가 플러그인 마켓플레이스를 끄면, Claude Desktop 2.16120.0 이상은 조직이 프로비저닝하지 않은 마켓플레이스를 숨기고 이들로부터의 설치를 거부합니다. 포함된 세션이 이러한 마켓플레이스에서 이미 설치된 플러그인을 로드하는 것을 중지하려면, 부모 설정으로 `strictKnownMarketplaces` 목록을 보냅니다. 옵트인 없이, Claude Code는 해당 목록을 무시하고, 이러한 플러그인은 계속 로드됩니다.363플러그인 마켓플레이스 허용 목록도 부모 설정으로만 내장된 세션에 도달합니다. Claude Desktop의 관리형 구성에서 사용자 추가 플러그인 마켓플레이스를 끄면, Claude Desktop 2.16120.0 이상은 조직이 프로비저닝하지 않은 마켓플레이스를 숨기고 해당 마켓플레이스에서의 설치를 거부합니다. 내장된 세션이 해당 마켓플레이스에서 이미 설치된 플러그인을 로드하지 못하도록, Claude Desktop은 `strictKnownMarketplaces` 목록을 부모 설정으로 보냅니다. 옵트인이 없으면 Claude Code는 해당 목록을 무시하고, 이러한 플러그인은 계속 로드됩니다.

364 364 

365개발자가 `/login`을 통해 로그인하는 머신에는 옵트인이 필요하지 않습니다; 각 Claude Code 세션은 게이트웨이에서 정책을 가져옵니다.365개발자가 `/login`을 통해 로그인하는 머신에는 옵트인이 필요하지 않습니다. 각 Claude Code 세션이 게이트웨이에서 정책을 가져옵니다.

366 366 

367[`policyHelper`](/docs/ko/settings-reference#policyhelper)가 관리 설정을 제공하는 플릿은 이를 사용할 수 없습니다: Claude Code는 도우미의 출력에서만 관리 설정을 읽기 때문에 이러한 플릿에서 부모 설정을 병합하지 않습니다.367[`policyHelper`](/docs/ko/settings-reference#policyhelper)가 관리형 설정을 제공하는 플릿은 이를 사용할 수 없습니다. Claude Code는 헬퍼의 출력에서만 관리형 설정을 읽기 때문에, 해당 플릿에서는 부모 설정을 병합하지 않습니다.

368 368 

369<h4 id="set-the-opt-in">369<h4 id="set-the-opt-in">

370 옵트인 설정370 옵트인 설정

371</h4>371</h4>

372 372 

373[게이트웨이 URL 설정](#set-the-gateway-url)에서 관리 설정 스니펫을 배포하고, 파일을 능가하는 모든 클라이언트 측 소스로 미러링한 다음, 확인하세요.373[게이트웨이 URL 설정](#set-the-gateway-url)의 관리형 설정 스니펫을 배포하고, 파일보다 우선하는 모든 클라이언트 측 소스에 미러링한 다음 확인하세요.

374 374 

375<Steps>375<Steps>

376 <Step title="관리 설정 파일에 옵트인 배포">376 <Step title="관리형 설정 파일에 옵트인 배포">

377 [위의 스니펫](#set-the-gateway-url)은 이미 `parentSettingsBehavior: "merge"`를 포함하므로, 머신으로 푸시하는 파일이 이를 전달합니다.377 [위의 스니펫](#set-the-gateway-url)에는 이미 `parentSettingsBehavior: "merge"`가 포함되어 있으므로, 머신에 푸시하는 파일에 이 설정이 포함됩니다.

378 </Step>378 </Step>

379 379 

380 <Step title="파일을 능가하는 모든 소스로 스니펫 미러링">380 <Step title="파일보다 우선하는 모든 소스에 스니펫 미러링">

381 Claude Code는 [선택된 소스](/docs/ko/managed-settings#which-managed-source-claude-code-uses)에서만 `parentSettingsBehavior`를 읽습니다. 클라이언트 측 소스에 정책 키를 추가하면 해당 소스가 선택된 소스가 될 수 있으므로, `parentSettingsBehavior`만이 아닌 전체 스니펫을 미러링하세요. [클라이언트 측 관리 설정](/docs/ko/claude-apps-gateway-config#client-side-managed-settings)은 Group Policy 또는 구성 프로필을 통해 정책을 전달하는 플릿을 다룹니다. macOS의 관리 기본 설정 plist 또는 Windows의 HKLM 정책은 `managed-settings.json` 파일을 능가하며, 게이트웨이의 자체 원격 관리 설정은 둘 다를 능가하므로, 게이트웨이에 로그인하는 머신에서도 게이트웨이 정책의 [`cli` 블록](/docs/ko/claude-apps-gateway-config#managed)에서 `parentSettingsBehavior`를 설정하세요.381 Claude Code는 [선택된 소스](/docs/ko/managed-settings#which-managed-source-claude-code-uses)에서만 `parentSettingsBehavior`를 읽습니다. 어떤 소스에든 정책 키를 추가하면 해당 소스가 선택된 소스가 될 수 있으므로, 클라이언트 측 소스에는 `parentSettingsBehavior`만이 아니라 전체 스니펫을 미러링하세요. [클라이언트 측 관리형 설정](/docs/ko/claude-apps-gateway-config#client-side-managed-settings)에서는 Group Policy 또는 구성 프로필을 통해 정책을 전달하는 플릿을 다룹니다. macOS의 관리형 기본 설정 plist나 Windows의 HKLM 정책은 `managed-settings.json` 파일보다 우선하며, 게이트웨이 자체의 원격 관리형 설정은 둘 모두보다 우선합니다. 따라서 게이트웨이에 로그인하는 머신의 경우 게이트웨이 정책의 [`cli` 블록](/docs/ko/claude-apps-gateway-config#managed)에도 `parentSettingsBehavior`를 설정하세요.

382 </Step>382 </Step>

383 383 

384 <Step title="선택된 소스 확인">384 <Step title="선택된 소스 확인">

385 Claude Desktop만 실행하는 머신에서 Agent SDK의 [`resolveSettings()`](/docs/ko/agent-sdk/typescript#resolvesettings)를 호출하고 `sources` 목록의 `managed` 항목에서 `policyOrigin`을 읽으세요. 값은 선택된 클라이언트 측 소스인 `plist`, `hklm` 또는 `file`의 이름을 지정하며, 이는 스니펫을 전달해야 하는 소스입니다. Claude Desktop의 포함된 세션은 게이트웨이 정책을 가져오지 않으므로, 게이트웨이의 `cli` 블록은 이들에 대해 선택된 소스로 계산되지 않습니다.385 Claude Desktop만 실행하는 머신에서 Agent SDK의 [`resolveSettings()`](/docs/ko/agent-sdk/typescript#resolvesettings)를 호출하고, `sources` 목록의 `managed` 항목에서 `policyOrigin`을 읽으세요. 이 값은 선택된 클라이언트 측 소스인 `plist`, `hklm` 또는 `file`을 나타내며, 이 소스에 스니펫이 있어야 합니다. Claude Desktop의 내장된 세션은 게이트웨이 정책을 가져오지 않으므로, 게이트웨이의 `cli` 블록은 이 세션에 대해 선택된 소스로 간주되지 않습니다.

386 </Step>386 </Step>

387</Steps>387</Steps>

388 388 

390 부모 설정 제한390 부모 설정 제한

391</h3>391</h3>

392 392 

393`parentSettingsBehavior: "merge"`를 배포하면, Claude Desktop뿐만 아니라 Agent SDK 애플리케이션 또는 IDE 확장도 Claude Code를 시작하는 모든 호스트 프로세스가 부모 설정을 제공할 수 있습니다.393`parentSettingsBehavior: "merge"`를 배포하면 Claude Desktop뿐 아니라 Agent SDK 애플리케이션이나 IDE 확장 등 Claude Code를 시작하는 모든 호스트 프로세스가 부모 설정을 제공할 수 있습니다.

394 394 

395Claude Code는 부모 설정을 제한적 키의 허용 목록에 대해 필터링하지만, 일부 허용된 키는 제한하기보다는 액세스를 부여할 수 있습니다. `allowManaged*Only` 잠금을 설정하지 않으면, 호스트에서 제공한 권한 허용 규칙 및 샌드박스 허용 목록이 여전히 적용됩니다. 정책의 거부 및 요청 규칙은 어느 쪽이든 적용됩니다; [이들은 모든 허용 규칙 전에 평가됩니다](/docs/ko/permissions#manage-permissions).395Claude Code는 제한적인 키의 허용 목록을 기준으로 부모 설정을 필터링하지만, 허용된 일부 키는 제한하는 대신 액세스를 부여할 수 있습니다. `allowManaged*Only` 잠금을 설정하지 않으면 호스트가 제공한 권한 허용 규칙과 샌드박스 허용 목록이 여전히 적용됩니다. 정책의 거부 및 확인 규칙은 어느 경우에나 유효합니다. [이 규칙은 모든 허용 규칙보다 먼저 평가됩니다](/docs/ko/permissions#manage-permissions).

396 396 

397Claude Code는 부모 제공 [`sandbox.credentials`](/docs/ko/settings-reference#sandbox-credentials) 항목을 제거된 형태로 전달합니다:397Claude Code는 부모가 제공한 [`sandbox.credentials`](/docs/ko/settings-reference#sandbox-credentials) 항목을 축소된 형태로 전달합니다.

398 398 

399* **`deny` 항목**: `path` 또는 `name`과 모드만으로 전달됩니다.399* **`deny` 항목**: `path` 또는 `name`과 모드만 전달됩니다.

400* **[`mode: mask`](/docs/ko/sandboxing#mask-credential-files)가 있는 파일 항목**: 전체 파일 마스크로 센티널만 전달되며, `injectHosts`는 빈 목록이므로, 프록시는 모든 플랫폼에서 부모 제공 항목에 대해 실제 값을 대체하지 않습니다. 모든 구조화된 마스킹 필드도 삭제되므로, 부모 제공 추출 패턴은 다른 소스가 동일한 경로에 대해 설정한 더 엄격한 마스크를 대체할 수 없습니다.400* **[`mode: mask`](/docs/ko/sandboxing#mask-credential-files)가 있는 파일 항목**: `injectHosts`가 빈 목록인 전체 파일 마스크로서 센티널 전용으로 전달되므로, 어떤 플랫폼에서도 프록시가 부모 제공 항목에 실제 값을 대입하지 않습니다. 모든 구조화된 마스킹 필드도 삭제되므로, 부모가 제공한 추출 패턴이 다른 소스가 동일한 경로에 설정한 더 엄격한 마스크를 대체할 수 없습니다.

401* **`mode: mask`가 있는 `envVars` 항목**: 전달되지 않습니다. `deny`는 부모 채널이 `envVars` 항목을 통해 표현할 수 있는 유일한 제한입니다.401* **`mode: mask`가 있는 `envVars` 항목**: 전달되지 않습니다. 부모 채널이 `envVars` 항목을 통해 표현할 수 있는 제한은 `deny`뿐입니다.

402* **[`awsPairs` 및 `sigv4`](/docs/ko/sandboxing#re-sign-aws-requests)**: 제한만 전달됩니다. `sigv4`에서는 `deny` 값만 유지되며, 부모가 `sigv4` 블록을 정의하면 세 가지 요청 형식 모두 `streaming`, `presigned`, `sigv4a`를 `deny`로 고정합니다. `awsPairs` 쌍은 다시 서명할 수 있는 형태로 전달되지 않습니다; 기존 AWS 변수 중 하나의 이름을 지정하는 쌍은 `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`의 자동 쌍 지정을 억제된 상태로 유지하는 비활성 항목으로 대체됩니다.402* **[`awsPairs` 및 `sigv4`](/docs/ko/sandboxing#re-sign-aws-requests)**: 제한 전용으로 전달됩니다. `sigv4`에서는 `deny` 값만 유지되며, 부모가 `sigv4` 블록을 정의하기만 하면 세 가지 요청 형식 `streaming`, `presigned`, `sigv4a`가 모두 `deny`로 고정됩니다. `awsPairs` 쌍은 재서명할 수 있는 형태로는 전달되지 않습니다. 관례적인 AWS 변수 중 하나를 지정하는 쌍은 `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`의 자동 쌍 지정을 억제된 상태로 유지하는 비활성 항목으로 대체됩니다.

403 403 

404<h4 id="deploy-the-locks">404<h4 id="deploy-the-locks">

405 잠금 배포405 잠금 배포

406</h4>406</h4>

407 407 

408부모 설정을 필터가 지원하는 제한만큼 가깝게 유지하려면, 다섯 개의 `allowManaged*Only` 잠금과 이들이 관리하는 허용 목록을 모두 병합 옵트인과 동일한 소스에 추가하세요:408부모 설정을 필터가 지원하는 범위 내에서 최대한 제한 전용에 가깝게 유지하려면, 다섯 개의 `allowManaged*Only` 잠금과 이들이 관리하는 허용 목록을 모두 병합 옵트인과 동일한 소스에 추가하세요.

409 409 

410```json theme={null}410```json theme={null}

411{411{

430}430}

431```431```

432 432 

433OS 정책(예: HKLM 레지스트리 정책 또는 관리 기본 설정 plist)은 이 파일을 능가하므로, 파일 대신 전체 스니펫을 통해 전달하세요. 게이트웨이의 원격 관리 설정은 OS 정책 및 파일 소스를 능가하지만 연결된 클라이언트에만 도달합니다. 잠금, 허용 목록, 병합 옵트인을 정책의 [`cli` 블록](/docs/ko/claude-apps-gateway-config#managed)으로 미러링하고 이 파일을 배포된 상태로 유지하세요. 연결되지 않은 머신(Claude Desktop만 실행하는 머신 포함)은 파일에서만 정책을 가져옵니다.433HKLM 레지스트리 정책이나 관리형 기본 설정 plist 같은 OS 정책은 이 파일보다 우선하므로, 파일 대신 해당 OS 정책을 통해 전체 스니펫을 전달하세요. 게이트웨이의 원격 관리형 설정은 OS 정책 및 파일 소스보다 우선하지만 연결된 클라이언트에만 도달합니다. 잠금, 허용 목록, 병합 옵트인을 정책의 [`cli` 블록](/docs/ko/claude-apps-gateway-config#managed)에 미러링하고 이 파일도 배포된 상태로 유지하세요. Claude Desktop만 실행하는 머신을 포함하여 연결되지 않는 머신은 이 파일에서만 정책을 가져오기 때문입니다.

434 434 

435<h4 id="lock-behavior-across-sources">435<h4 id="lock-behavior-across-sources">

436 소스 전체의 잠금 동작436 소스 간 잠금 동작

437</h4>437</h4>

438 438 

439한 잠금을 설정해도 다른 잠금을 제한하지 않습니다; 각 키는 [설정 참조](/docs/ko/settings-reference#all-settings)에 문서화되어 있습니다. 우승자 아래의 관리 소스에서, 두 샌드박스 잠금은 여전히 적용되며, `allowManagedPermissionRulesOnly`는 여전히 부모 제공 허용 규칙 및 `additionalDirectories`를 차단합니다. Claude Code v2.1.273 이상에서, MCP 서버 잠금도 우승자 아래의 소스에서 적용되며, 이것이 켜져 있는 동안 관리 `allowedMcpServers` 목록은 하나를 설정하는 가장 높은 우선순위 관리 소스에서 나옵니다.439한 잠금을 설정해도 다른 잠금이 제한되지는 않습니다. 각 키는 [설정 참조](/docs/ko/settings-reference#all-settings)에 문서화되어 있습니다.

440 440 

441hooks 잠금과 `allowManagedPermissionRulesOnly`의 개발자 자신의 규칙에 대한 영향은 기본적으로 우승 소스가 필요합니다; [Claude Code가 관리 소스를 결합하는 방법](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)의 `managedSourcesBehavior` 병합 옵트인에서, Claude Code는 모든 잠금에 대해 모든 소스가 설정하는 가장 엄격한 값을 적용합니다. [`policyHelper`](/docs/ko/settings-reference#policyhelper) 플릿에서, Claude Code는 도우미의 출력에서만 잠금을 읽습니다.441우선 소스보다 낮은 관리자 소스에서도 두 샌드박스 잠금은 여전히 적용되며, `allowManagedPermissionRulesOnly`는 여전히 부모가 제공한 허용 규칙과 `additionalDirectories`를 차단합니다. Claude Code v2.1.273 이상에서는 MCP 서버 잠금도 우선 소스보다 낮은 소스에서 적용되며, 이 잠금이 켜져 있는 동안 관리형 `allowedMcpServers` 목록은 이를 설정하는 가장 높은 우선순위의 관리자 소스에서 가져옵니다.

442 442 

443각 잠금은 Claude Code가 해당 설정에 대한 개발자의 자신의 항목을 무시하도록 하므로, 조직의 허용 목록을 잠금 옆에 포함하세요:443훅 잠금과, 개발자 자신의 규칙에 대한 `allowManagedPermissionRulesOnly`의 효과는 기본적으로 우선 소스에 설정되어야 합니다. [Claude Code가 관리형 소스를 결합하는 방법](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)의 `managedSourcesBehavior` 병합 옵트인에서는 Claude Code가 모든 잠금에 대해 어느 소스든 설정한 가장 엄격한 값을 적용합니다. [`policyHelper`](/docs/ko/settings-reference#policyhelper) 플릿에서는 Claude Code가 헬퍼의 출력에서만 잠금을 읽습니다.

444 444 

445* **네트워크 도메인**: 빈 관리 도메인 목록으로 잠그면 모든 샌드박스 아웃바운드 트래픽이 차단됩니다.445각 잠금은 Claude Code가 해당 설정에 대한 개발자 자신의 항목을 무시하게 하므로, 조직의 허용 목록을 잠금과 함께 포함하세요.

446* **MCP 서버**: 관리되거나 부모 제공 `allowedMcpServers` 없이 잠그면 `deniedMcpServers`가 차단하지 않는 모든 서버가 로드됩니다.446 

447* **읽기 경로**: `allowRead` 항목은 `denyRead` 영역 내의 경로만 다시 허용하므로, 관리 `denyRead`와 쌍을 이루세요.447* **네트워크 도메인**: 관리형 도메인 목록이 비어 있는 상태로 잠그면 샌드박스의 모든 아웃바운드 트래픽이 차단됩니다.

448* **MCP 서버**: 어떤 관리자 소스에도, 부모가 제공한 설정에도 `allowedMcpServers`가 없는 상태로 잠그면 `deniedMcpServers`가 차단하지 않는 모든 서버가 로드됩니다.

449* **읽기 경로**: `allowRead` 항목은 `denyRead` 영역 내의 경로만 다시 허용하므로, 관리형 `denyRead`와 함께 사용하세요.

448 450 

449<h4 id="settings-the-locks-don’t-cover">451<h4 id="settings-the-locks-don’t-cover">

450 잠금이 다루지 않는 설정452 잠금이 다루지 않는 설정

451</h4>453</h4>

452 454 

453여섯 개의 부모 제공 설정은 다섯 개의 잠금이 모두 설정되어도 필터를 통과합니다. 기본 첫 번째 우승 설정에서, 부모를 차단하는 관리 값은 가장 높은 우선순위 관리 소스의 값입니다. [MCP 서버 잠금](#lock-behavior-across-sources)이 켜져 있는 동안 `allowedMcpServers` 제외. `managedSourcesBehavior` 병합 옵트인에서, [Claude Code가 관리 소스를 결합하는 방법](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)은 대신 어느 소스의 값이 적용되는지 말합니다.455다음 부모 제공 설정은 다섯 개의 잠금을 모두 설정해도 필터를 통과합니다.

456 

457* **`forceLoginOrgUUID`**: 가장 높은 우선순위의 관리자 소스가 조직 UUID를 설정하지 않으면 Claude Code는 부모가 제공한 값을 따릅니다. 게이트웨이 로그인은 이 키를 확인하지 않습니다. 가장 높은 우선순위의 관리자 소스에 있는 조직 UUID는 부모의 값을 차단하며, Claude Code가 적용하는 값이 됩니다.

458* **`allowedMcpServers`**: 유효한 관리자 목록이 없으면 Claude Code는 부모가 제공한 허용 목록을 따릅니다. `allowManagedMcpServersOnly`는 이를 차단하지 않습니다. 이 잠금은 우선하는 목록을 관리형 값으로 적용하며, 관리자 소스가 목록을 제공하지 않으면 부모가 제공한 목록도 여기에 포함되기 때문입니다. 가장 높은 우선순위의 관리자 소스에 있는 목록은 부모의 목록을 차단하며 Claude Code가 적용하는 목록이 되므로, 해당 소스에 잠금과 함께 `allowedMcpServers`를 설정하세요. v2.1.223 이전에는 어느 관리자 소스에든 두 키 중 하나의 값이 있으면 부모의 값이 차단되었습니다.

459* **`availableModels`**: 우선하는 관리형 소스가 모델 목록을 설정하지 않으면 Claude Code는 부모가 제공한 모델 목록을 따릅니다. 플릿에서 모델을 제한한다면 우선 소스에 `availableModels`를 설정하세요.

460* **`allowedProviders`**: 우선하는 관리형 소스가 API 제공자 허용 목록을 설정하지 않으면 Claude Code는 부모가 제공한 API 제공자 허용 목록을 따릅니다. 플릿에서 개발자가 사용할 수 있는 API 제공자를 제한한다면 우선 소스에 `allowedProviders`를 설정하세요. Claude Code v2.1.285 이상이 필요합니다.

461* **`strictKnownMarketplaces`**: 우선하는 관리형 소스가 플러그인 마켓플레이스 허용 목록을 설정하지 않으면 Claude Code는 부모가 제공한 플러그인 마켓플레이스 허용 목록을 따릅니다. Claude Desktop 2.16120.0 이상은 관리형 구성에서 사용자 추가 플러그인 마켓플레이스를 끄면 이 목록을 보냅니다. 플릿에서 마켓플레이스를 제한한다면 우선 소스에 `strictKnownMarketplaces`를 설정하세요. Claude Code v2.1.282 이상이 필요합니다.

462* **`blockedMarketplaces`**: 부모가 제공한 마켓플레이스 차단 목록은 필터를 통과하며, 관리형 소스가 설정한 차단 목록에 추가됩니다. 차단 목록은 제한을 더할 수만 있기 때문입니다. Claude Code v2.1.282 이상이 필요합니다.

463* **`strictPluginOnlyCustomization`**: 이 키는 어떤 잠금과도 관계없이 필터를 통과하며, Claude Code가 보호용 훅을 포함한 개발자 자신의 사용자 정의를 무시하게 합니다. 이를 차단하는 잠금은 없습니다.

454 464 

455* **`forceLoginOrgUUID`**: 가장 높은 우선순위 관리 소스가 조직 UUID를 설정하지 않을 때 Claude Code는 부모 제공 값을 준수합니다. 게이트웨이 로그인은 이 키를 확인하지 않습니다. 가장 높은 우선순위 관리 소스의 조직 UUID는 부모의 값을 차단하며 Claude Code가 적용하는 값입니다.465기본 first-wins 설정에서는 관리자 값이 가장 높은 우선순위의 관리자 소스에 있을 때만 부모의 값을 차단합니다. 단, [MCP 서버 잠금](#lock-behavior-across-sources)이 켜져 있는 동안의 `allowedMcpServers`는 예외입니다. `managedSourcesBehavior` 병합 옵트인에서는 [Claude Code가 관리형 소스를 결합하는 방법](/docs/ko/managed-settings#how-claude-code-combines-managed-sources)에 따라 어느 소스의 값이 적용되는지가 결정됩니다.

456* **`allowedMcpServers`**: 가장 높은 우선순위 관리 소스가 허용 목록을 설정하지 않을 때 Claude Code는 부모 제공 허용 목록을 준수하며, `allowManagedMcpServersOnly`는 이를 차단하지 않습니다. 잠금은 우승 목록을 관리 값으로 적용하기 때문입니다. 가장 높은 우선순위 관리 소스의 목록은 부모의 목록을 차단하며 Claude Code가 적용하는 목록이므로, 잠금 옆에 거기에 `allowedMcpServers`를 설정하세요. v2.1.223 이전에는, 모든 관리 소스의 어느 키에 대한 값이든 부모의 값을 차단했습니다.

457* **`availableModels`**: Claude Code는 우승 관리 소스가 모델 목록을 설정하지 않을 때 부모 제공 모델 목록을 준수합니다. 플릿이 모델을 제한하면, 우승 소스에 `availableModels`를 설정하세요.

458* **`strictKnownMarketplaces`**: Claude Code는 우승 관리 소스가 플러그인 마켓플레이스 허용 목록을 설정하지 않을 때 부모 제공 플러그인 마켓플레이스 허용 목록을 준수합니다. Claude Desktop 2.16120.0 이상은 관리 구성이 사용자 추가 플러그인 마켓플레이스를 끌 때 하나를 보냅니다. 플릿이 마켓플레이스를 제한하면, 우승 소스에 `strictKnownMarketplaces`를 설정하세요. Claude Code v2.1.282 이상이 필요합니다.

459* **`blockedMarketplaces`**: 부모 제공 마켓플레이스 차단 목록은 통과하고 관리 소스가 설정한 모든 차단 목록에 추가됩니다. 차단 목록은 더 제한할 수만 있기 때문입니다. Claude Code v2.1.282 이상이 필요합니다.

460* **`strictPluginOnlyCustomization`**: 이 키는 모든 잠금과 관계없이 필터를 통과하며, Claude Code가 개발자의 자신의 사용자 정의(보호 hooks 포함)를 무시하도록 합니다. 이를 차단하는 잠금이 없습니다.

461 466 

462<h3 id="connect-claude-desktop">467<h3 id="connect-claude-desktop">

463 Claude Desktop 연결468 Claude Desktop 연결

464</h3>469</h3>

465 470 

466[Claude Desktop](/docs/ko/desktop)은 다른 MDM 키를 통해 동일한 게이트웨이에 연결합니다: Claude Desktop의 [관리 구성](https://claude.com/docs/third-party/claude-desktop/configuration)에서 `bootstrapUrl`을 `<listen.public_url>/user/bootstrap`으로 설정하고, 사용자의 정책을 `desktop` 키로 옵트인하세요. [Claude Desktop 오버레이](/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)는 둘 다를 다룹니다. 게이트웨이 서버에서 Claude Code v2.1.203 이상이 필요합니다.471[Claude Desktop](/docs/ko/desktop)은 다른 MDM 키를 통해 동일한 게이트웨이에 연결합니다. Claude Desktop의 [관리형 구성](https://claude.com/docs/third-party/claude-desktop/configuration)에서 `bootstrapUrl`을 `<listen.public_url>/user/bootstrap`으로 설정하고, `desktop` 키로 사용자의 정책을 옵트인하세요. [Claude Desktop 오버레이](/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)에서 두 부분을 모두 다룹니다. 게이트웨이 서버에 Claude Code v2.1.203 이상이 필요합니다.

467 472 

468Claude Desktop은 동일한 브라우저 SSO 단계로 게이트웨이의 ID 제공자를 통해 개발자에게 로그인하고, Anthropic 대신 게이트웨이에서 구성을 가져옵니다. 모델 액세스 및 정책은 CLI와 동일한 그룹별 규칙을 따릅니다. CLI와 Claude Desktop을 모두 사용하는 개발자는 각각에 별도로 로그인합니다; 게이트웨이 세션은 이들 사이에 공유되지 않습니다.473Claude Desktop은 동일한 브라우저 SSO 단계로 게이트웨이의 ID 제공자를 통해 개발자를 로그인시킨 다음, Anthropic 대신 게이트웨이에서 구성을 가져옵니다. 모델 액세스와 정책은 CLI와 동일한 그룹별 규칙을 따릅니다. CLI와 Claude Desktop을 모두 사용하는 개발자는 각각 별도로 로그인하며, 게이트웨이 세션은 둘 사이에 공유되지 않습니다.

469 474 

470연결되면, Claude Desktop은 활성화된 모든 탭에서 모델 요청을 게이트웨이를 통해 보냅니다. 기본적으로 Cowork 및 Code 탭을 표시합니다. Chat 탭도 켜려면, Claude Desktop의 [관리 구성](https://claude.com/docs/third-party/claude-desktop/configuration)에서 `chatTabEnabled`를 `true`로 설정하거나, Claude Code v2.1.227 이상을 실행하는 게이트웨이의 정책 [`desktop` 블록](/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)에서 설정하세요.475연결되면 Claude Desktop은 활성화된 모든 탭의 모델 요청을 게이트웨이를 통해 보냅니다. 기본적으로 Cowork 및 Code 탭이 표시됩니다. Chat 탭도 켜려면 Claude Desktop의 [관리형 구성](https://claude.com/docs/third-party/claude-desktop/configuration)에서 `chatTabEnabled`를 `true`로 설정하거나, Claude Code v2.1.227 이상을 실행하는 게이트웨이에서 정책의 [`desktop` 블록](/docs/ko/claude-apps-gateway-config#claude-desktop-overlay)에 설정하세요.

471 476 

472<h3 id="ci-pipelines-and-remote-machines">477<h3 id="ci-pipelines-and-remote-machines">

473 CI 파이프라인 및 원격 머신478 CI 파이프라인 및 원격 머신

474</h3>479</h3>

475 480 

476무인 파이프라인을 위한 서비스 토큰 흐름이 없습니다. 게이트웨이 로그인은 항상 브라우저 장치 흐름을 실행하므로, 로그인을 승인할 개발자가 없는 CI 작업은 인증할 수 없습니다; 제공자에 대해 직접 구성하세요.481무인 파이프라인을 위한 서비스 토큰 흐름은 없습니다. 게이트웨이 로그인은 항상 브라우저 디바이스 흐름을 실행하므로, 로그인을 승인할 개발자가 없는 CI 작업은 인증할 수 없습니다. 이러한 작업은 제공자에 직접 연결하도록 구성하세요.

477 482 

478개발자가 로그인하면, 해당 머신의 모든 Claude Code 세션은 게이트웨이 세션을 사용하며, 비대화형 `claude -p` 실행 및 Agent SDK에서 시작된 세션을 포함합니다. Claude Code는 [게이트웨이 정책](/docs/ko/claude-apps-gateway-config#managed)을 각각에 적용합니다.483개발자가 로그인하면 해당 머신의 각 Claude Code 세션은 비대화형 `claude -p` 실행과 Agent SDK에서 시작된 세션을 포함하여 게이트웨이 세션을 사용합니다. Claude Code는 각 세션에 [게이트웨이 정책](/docs/ko/claude-apps-gateway-config#managed)을 적용합니다.

479 484 

480장치 흐름은 폴링 CLI를 승인하는 브라우저에서 분리하므로, 디스플레이가 없는 원격 개발 상자도 작동합니다: 개발자는 원격 머신에서 SSH를 통해 `/login`을 실행하고 노트북의 브라우저에서 확인 링크를 엽니다.485디바이스 흐름은 폴링하는 CLI와 승인하는 브라우저를 분리하므로, 디스플레이가 없는 원격 개발 머신에서도 작동합니다. 개발자는 원격 머신에서 SSH를 통해 `/login`을 실행하고 노트북의 브라우저에서 확인 링크를 엽니다.

481 486 

482<h3 id="whats-enforced-on-developers">487<h3 id="whats-enforced-on-developers">

483 개발자에게 적용되는 것488 개발자에게 적용되는 사항

484</h3>489</h3>

485 490 

486이러한 보장은 `/login`을 통해 로그인한 모든 세션에 적용됩니다. Claude Desktop이 시작하는 포함된 세션은 [Claude Desktop 세션에 정책 전달](#deliver-policy-to-claude-desktop-sessions)에서 설명한 대로 정책을 가져오며, 텔레메트리 글머리 기호는 내보내기가 어디로 가는지 말합니다.491다음 보장 사항은 `/login`을 통해 로그인한 모든 세션에 적용됩니다. Claude Desktop이 시작하는 내장된 세션은 [Claude Desktop 세션에 정책 전달](#deliver-policy-to-claude-desktop-sessions)에 설명된 방식으로 정책을 가져오며, 텔레메트리 항목에 해당 세션의 내보내기가 어디로 가는지 설명되어 있습니다.

487 492 

488* **모델 액세스**: 정책이 부여하지 않는 모델에 대한 요청은 400을 반환하고, `/model` 선택기는 정책의 `availableModels` 허용 목록으로 필터링됩니다. 정책에서 [`enforceAvailableModels: true`](/docs/ko/model-config#default-model-behavior)를 설정하여 Default 옵션이 `availableModels` 내의 모델로 확인되도록 하세요. 없으면 Default는 선택 가능하게 유지되고 해당 모델이 부여되지 않으면 요청 시 거부됩니다.493* **모델 액세스**: 정책이 허용하지 않는 모델에 대한 요청은 400을 반환하며, `/model` 선택기는 정책의 `availableModels` 허용 목록으로 필터링됩니다. 정책에 [`enforceAvailableModels: true`](/docs/ko/model-config#default-model-behavior)를 설정하면 Default 옵션이 Claude Code의 기본 제공 기본값 대신 `availableModels` 내의 모델로 확인됩니다. 이 설정이 없으면 Default는 계속 선택할 수 있으며, 해당 모델이 허용되지 않은 경우 요청 시 거부됩니다.

489* **텔레메트리 대상**: `/login`을 통해 로그인한 세션에서, CLI는 로컬로 설정된 `OTEL_EXPORTER_OTLP_ENDPOINT`와 관계없이 OTLP/HTTP 내보내기를 게이트웨이로 보내며, 정책이 [수집기를 엔드포인트로 지정](/docs/ko/claude-apps-gateway-config#export-directly-to-your-collector)하지 않는 한, 게이트웨이는 이들을 [`telemetry.forward_to`](/docs/ko/claude-apps-gateway-config#telemetry)의 대상으로 중계합니다.494* **텔레메트리 대상**: `/login`을 통해 로그인한 세션에서 CLI는 정책이 [수집기를 엔드포인트로 지정](/docs/ko/claude-apps-gateway-config#export-directly-to-your-collector)하지 않는 한, 로컬에 설정된 `OTEL_EXPORTER_OTLP_ENDPOINT`가 아니라 게이트웨이로 OTLP/HTTP 내보내기를 보냅니다. 게이트웨이는 받은 내보내기를 [`telemetry.forward_to`](/docs/ko/claude-apps-gateway-config#telemetry)의 대상으로 중계합니다.

490 * [Claude Desktop이 시작하는](#connect-claude-desktop) 포함된 세션에서, CLI는 구성된 `OTEL_EXPORTER_OTLP_ENDPOINT`로 내보내기를 보냅니다. CLI는 해당 엔드포인트가 게이트웨이 자체를 가리킬 때만 이러한 내보내기에 게이트웨이 세션 토큰을 첨부합니다.495 * [Claude Desktop이 시작하는](#connect-claude-desktop) 내장된 세션에서 CLI는 구성된 `OTEL_EXPORTER_OTLP_ENDPOINT`로 내보내기를 보냅니다. CLI는 해당 엔드포인트가 게이트웨이 자체를 가리킬 때만 이러한 내보내기에 게이트웨이 세션 토큰을 첨부합니다.

491 * 신호에 대해 구성된 대상이 없으면, 게이트웨이는 이를 수락하고 폐기합니다.496 * 신호에 대해 구성된 대상이 없으면 게이트웨이는 이를 수락한 후 폐기합니다.

492 * 이미 Claude Code 텔레메트리를 직접 수집하면, 수집기를 `forward_to` 대상으로 추가하거나, 정책에서 이를 엔드포인트로 지정하여 중계를 건너뛰세요.497 * 이미 Claude Code 텔레메트리를 직접 수집하고 있다면, 수집기를 `forward_to` 대상으로 추가하거나 정책에서 수집기를 지정하여 중계를 건너뛰세요.

493* **자격증명**: 게이트웨이 토큰은 세션의 유일한 자격증명입니다. [Anthropic 프로필](/docs/ko/authentication#anthropic-profiles-and-federation-credentials) 및 이전 claude.ai 로그인은 로그인 중에 무시되므로, 개발자는 먼저 claude.ai에서 로그아웃할 필요가 없습니다. 구성된 `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, 또는 `apiKeyHelper` 자격증명의 경우, [Administrator policy requires a Cloud gateway sign-in](/docs/ko/errors#administrator-policy-requires-a-cloud-gateway-sign-in)을 참조하세요.498* **자격 증명**: 게이트웨이 토큰이 세션의 유일한 자격 증명입니다. 로그인된 동안에는 [Anthropic 프로필](/docs/ko/authentication#anthropic-profiles-and-federation-credentials)과 이전의 모든 claude.ai 로그인이 무시되므로, 개발자가 먼저 claude.ai에서 로그아웃할 필요가 없습니다. 구성된 `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` 또는 `apiKeyHelper` 자격 증명, 또는 이전 Claude Console 로그인으로 저장된 API 키에 대해서는 [Administrator policy requires a Cloud gateway sign-in](/docs/ko/errors#administrator-policy-requires-a-cloud-gateway-sign-in)을 참조하세요.

494* **관리 설정**: 잠긴 키는 로컬로 재정의될 수 없습니다. CLI는 시작 시 정책을 적용하고 각 시간별 폴에서 변경을 적용하며, [다음 시작에만 적용되는 변경](/docs/ko/server-managed-settings#fetch-and-caching-behavior)은 제외합니다.499* **관리형 설정**: 잠긴 키는 로컬에서 재정의할 수 없습니다. CLI는 시작 시 정책을 적용하고 매시간 폴링할 때마다 변경 사항을 적용하며, [다음 실행 시에만 적용되는 변경 사항](/docs/ko/server-managed-settings#fetch-and-caching-behavior)은 예외입니다.

495* **게이트웨이에 도달할 수 없는 상태에서 시작**: 로그인한 세션은 설정 없이 시작하는 대신 약 10초 후 시작 시 오류로 종료됩니다.500* **게이트웨이에 연결할 수 없는 상태에서 시작**: 로그인된 세션은 설정 없이 시작하는 대신 약 10초 후 오류와 함께 시작 시 종료됩니다.

496* **게이트웨이가 세션을 종료한 후 시작**: [실패 폐쇄 시작 적용](/docs/ko/server-managed-settings#enforce-fail-closed-startup)을 참조하여 어느 시작이 게이트웨이에서 로그아웃된 상태로 열리고 어느 시작이 게이트웨이가 `401`로 응답할 때 종료되는지 확인하세요.501* **게이트웨이가 세션을 종료한 후 시작**: 게이트웨이에서 로그아웃된 상태로 열리는 실행과 게이트웨이가 `401`로 응답할 때 종료되는 실행에 대해서는 [실패 시 차단 시작 적용](/docs/ko/server-managed-settings#enforce-fail-closed-startup)을 참조하세요.

497* **프로비저닝 해제**: 사용자가 IdP에서 비활성화된 세션은 다음 새로 고침이 실패할 때 `ttl_hours` 내에 만료됩니다.502* **프로비저닝 해제**: IdP에서 사용자가 비활성화된 세션은 다음 새로 고침이 실패하면 `ttl_hours` 내에 만료됩니다.

498* **로그아웃**: `/logout`은 개발자의 머신에서 게이트웨이 자격증명을 삭제합니다.503* **로그아웃**: `/logout`은 개발자 머신에서 게이트웨이 자격 증명을 삭제합니다.

499 * 게이트웨이의 검색 문서가 게이트웨이 URL의 자신의 스킴, 호스트, 포트에서 `revocation_endpoint`를 광고할 때, `/logout`은 또한 저장된 토큰을 해당 엔드포인트로 보내므로 게이트웨이가 자신의 측에서 세션을 종료할 수 있습니다. 요청은 최선의 노력이므로, 엔드포인트가 응답하는지 여부와 관계없이 로그아웃은 개발자의 머신에서 완료됩니다. 취소는 개발자 머신의 Claude Code v2.1.275 이상이 필요합니다.504 * 게이트웨이의 검색 문서가 게이트웨이 URL과 동일한 스킴, 호스트, 포트의 `revocation_endpoint`를 알리면, `/logout`은 저장된 토큰을 해당 엔드포인트로도 보내 게이트웨이가 자체적으로 세션을 종료할 수 있게 합니다. 이 요청은 최선 노력 방식이므로, 엔드포인트의 응답 여부와 관계없이 개발자 머신에서 로그아웃이 완료됩니다. 이 토큰 취소에는 개발자 머신에 Claude Code v2.1.275 이상이 필요합니다.

500 * `claude` 바이너리의 게이트웨이 서버는 광고하지 않으므로, 로그아웃은 개발자의 머신에서만 세션을 종료합니다. 서버 측에서 세션을 강제로 종료하려면, [JWT 비밀 회전](/docs/ko/claude-apps-gateway-deploy#jwt-secret-rotation)을 참조하세요.505 * `claude` 바이너리의 게이트웨이 서버는 이 엔드포인트를 알리지 않으므로, 해당 서버에서의 로그아웃은 개발자 머신에서만 세션을 종료합니다. 서버 측에서 세션을 강제로 종료하려면 [JWT 비밀 교체](/docs/ko/claude-apps-gateway-deploy#jwt-secret-rotation)를 참조하세요.

501 506 

502<h3 id="what-the-organization-can-see">507<h3 id="what-the-organization-can-see">

503 조직이 볼 수 있는 것508 조직이 볼 수 있는 정보

504</h3>509</h3>

505 510 

506사용 현황 텔레메트리는 개발자의 신원, 토큰 수, 모델 및 지연 시간을 조직의 수집기로 전달합니다. 게이트웨이는 프롬프트 또는 완료 콘텐츠를 기록하거나 저장하지 않습니다. 명령 및 파일 경로를 포함할 수 있는 로그 및 추적과 같은 더 풍부한 텔레메트리를 수집할지 여부는 조직의 [대상별 선택](/docs/ko/claude-apps-gateway-config#telemetry)입니다.511사용량 텔레메트리는 개발자의 신원, 토큰 수, 모델, 지연 시간을 조직의 수집기로 전달합니다. 게이트웨이는 프롬프트나 완성 콘텐츠를 로그에 기록하거나 저장하지 않습니다. 명령과 파일 경로를 포함할 수 있는 로그 및 트레이스 같은 더 풍부한 텔레메트리를 수집할지 여부는 조직의 [대상별 선택](/docs/ko/claude-apps-gateway-config#telemetry)에 달려 있습니다.

507 512 

508<h2 id="availability-and-limitations">513<h2 id="availability-and-limitations">

509 가용성 및 제한사항514 가용성 및 제한사항

12 12 

13클라우드 세션은 사용자의 머신 대신 클라우드 인프라에서 실행되는 Claude Code 세션입니다. 기본적으로 Anthropic이 관리하는 인프라에서 실행되거나, 라우팅될 때 조직의 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행됩니다. 세션은 노트북을 닫은 후에도 계속 실행되며, 모든 기기에서 확인하거나 조종할 수 있습니다.13클라우드 세션은 사용자의 머신 대신 클라우드 인프라에서 실행되는 Claude Code 세션입니다. 기본적으로 Anthropic이 관리하는 인프라에서 실행되거나, 라우팅될 때 조직의 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행됩니다. 세션은 노트북을 닫은 후에도 계속 실행되며, 모든 기기에서 확인하거나 조종할 수 있습니다.

14 14 

15클라우드 세션이 GitHub에서 코드를 클론하고 브랜치를 푸시할 수 있도록 하려면 [GitHub 연결 방법](#github-authentication-options) 중 하나로 GitHub를 연결하십시오. 저장소가 GitLab, Bitbucket 또는 기타 호스트에 있는 경우 [플랫폼 제한](#limitations)에서 지원되는 기능을 확인하십시오.

16 

15다음 중 어느 곳에서나 클라우드 세션을 시작할 수 있습니다:17다음 중 어느 곳에서나 클라우드 세션을 시작할 수 있습니다:

16 18 

17* **브라우저**: [claude.ai/code](https://claude.ai/code), 웹에서 Claude Code라고도 불림19* **브라우저**: [claude.ai/code](https://claude.ai/code), 웹에서 Claude Code라고도 불림

20* **터미널**: [`claude --cloud`](#from-terminal-to-cloud)22* **터미널**: [`claude --cloud`](#from-terminal-to-cloud)

21* **루틴**: [예약 및 트리거된 실행](/docs/ko/routines)은 각각 클라우드 세션으로 실행됨23* **루틴**: [예약 및 트리거된 실행](/docs/ko/routines)은 각각 클라우드 세션으로 실행됨

22 24 

23한 본문의 작업에 대해 Claude가 많은 클라우드 세션을 시작하고 추적하도록 하려면 [프로젝트](/docs/ko/claude-projects)를 사용하십시오. 터미널, IDE 또는 **Local**이 선택된 데스크톱 앱의 세션은 사용자의 머신에서 실행됩니다. 휴대폰이나 브라우저에서 이러한 로컬 세션을 조종하려면 [원격 제어](/docs/ko/remote-control)를 사용하세요.25설정이 완료되면 이 페이지를 참고하여 터미널과 클라우드 간에 작업을 이동하고, 세션을 관리 및 공유하고, 풀 리퀘스트 자동 수정을 켜고, 문제를 해결하십시오.

24 

25<Tip>

26 클라우드 세션을 처음 사용하시나요? [시작하기](/docs/ko/web-quickstart)에서 GitHub 계정을 연결하고 첫 번째 작업을 제출하세요.

27</Tip>

28 26 

29이 페이지에서 다루는 내용:27<Note>

28 다음 사례는 다른 페이지에서 다룹니다:

30 29 

31* [클라우드 환경](#cloud-environments): 세션이 실행되는 위치 및 구성 방법30 * **첫 번째 클라우드 세션 시작하기**: [클라우드 세션 시작하기](/docs/ko/web-quickstart)에서 GitHub를 연결하고 브라우저에서 작업을 진행하는 과정을 안내합니다

32* [GitHub 인증 옵션](#github-authentication-options): GitHub를 연결하는 두 가지 방법31 * **한 본문의 작업을 위한 여러 클라우드 세션**: [프로젝트](/docs/ko/claude-projects)를 사용하면 Claude가 세션을 대신 시작하고 추적합니다

33* [터미널과 클라우드 간에 작업 이동](#move-tasks-between-terminal-and-cloud): `--cloud` 및 `--teleport` 사용32 * **다른 기기에서 로컬 세션 조종하기**: 터미널, IDE 또는 **Local**이 선택된 데스크톱 앱의 세션은 사용자의 머신에서 실행되며, [Remote Control](/docs/ko/remote-control)을 사용하면 휴대폰이나 브라우저에서 이러한 세션에 접근할 수 있습니다

34* [세션 작업](#work-with-sessions): 권한 모드, 검토, 공유, 보관, 삭제33</Note>

35* [Pull request 자동 수정](#auto-fix-pull-requests): CI 실패 및 검토 주석에 자동으로 응답

36* [보안 및 격리](#security-and-isolation): 세션이 어떻게 격리되는지

37* [제한 사항](#limitations): 속도 제한 및 플랫폼 제한

38 34 

39<h2 id="cloud-environments">35<h2 id="cloud-environments">

40 클라우드 환경36 클라우드 환경

41</h2>37</h2>

42 38 

43모든 클라우드 세션은 [클라우드 환경](/docs/ko/cloud-environments)에서 실행되며, 이는 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 저장된 구성입니다. 아직 환경이 없으면 온보딩이 [**신뢰할 수 있는** 네트워크 액세스](/docs/ko/cloud-environments#access-levels)를 사용하여 **기본** 환경을 설정합니다. 이는 사용자를 위해 생성하거나 사용자가 생성하도록 요청합니다. 플랜에서 어느 것이 발생하는지 및 둘 이상의 환경이 있을 때 세션이 환경을 선택하는 방법은 [기본 환경](/docs/ko/cloud-environments#the-default-environment)을 참조하세요.39모든 클라우드 세션은 [클라우드 환경](/docs/ko/cloud-environments)에서 실행되며, 이는 네트워크 액세스, 환경 변수 및 설정 스크립트를 제어하는 저장된 구성입니다.

44 40 

45동일한 환경이 클라우드 세션을 시작하는 모든 위치에 적용됩니다: 웹, 터미널, [Claude Tag](https://claude.com/docs/claude-tag/overview), [routines](/docs/ko/routines) 및 모바일 및 Desktop 앱. Claude Tag 채널 세션은 조직 수준 환경만 사용하며, [공유 환경](/docs/ko/cloud-environments#organization-shared-environments) 또는 [자체 호스팅 환경](/docs/ko/self-hosted-environments)입니다.41* **첫 번째 환경**: 아직 환경이 없으면 온보딩이 [**신뢰할 수 있는** 네트워크 액세스](/docs/ko/cloud-environments#access-levels)를 사용하여 **기본** 환경을 설정합니다. 이는 사용자를 위해 생성하거나 사용자가 생성하도록 요청합니다. 플랜에서 어느 것이 발생하는지는 [기본 환경](/docs/ko/cloud-environments#the-default-environment)을 참조하세요

46 42* **세션이 사용하는 환경**: 둘 이상의 환경이 있을 때 세션이 환경을 선택하는 방법은 [기본 환경](/docs/ko/cloud-environments#the-default-environment)을 참조하세요

47환경이 허용하는 것을 변경하고, 변수를 설정하거나, 설정 스크립트를 추가하려면 [클라우드 환경 구성](/docs/ko/cloud-environments)을 참조하세요. 구성 없이 세션에 포함되는 것은 [설치된 도구](/docs/ko/cloud-environments#installed-tools)를 참조하세요.43* **세션이 접근하거나 시작 시 실행할 수 있는 항목 변경**: [클라우드 환경 구성](/docs/ko/cloud-environments)을 참조하세요

44* **구성 없이 설치되어 있는 항목**: [설치된 도구](/docs/ko/cloud-environments#installed-tools)를 참조하세요

48 45 

49<h2 id="github-authentication-options">46<h2 id="github-authentication-options">

50 GitHub 인증 옵션47 GitHub 인증 옵션

57| **GitHub App** | [웹 온보딩](/docs/ko/web-quickstart) 중에 Claude GitHub App을 승인합니다. | 모든 공개 저장소 및 Claude GitHub App이 설치된 비공개 저장소 | 브라우저 온보딩; [자동 수정](#auto-fix-pull-requests)을 원하는 팀 |54| **GitHub App** | [웹 온보딩](/docs/ko/web-quickstart) 중에 Claude GitHub App을 승인합니다. | 모든 공개 저장소 및 Claude GitHub App이 설치된 비공개 저장소 | 브라우저 온보딩; [자동 수정](#auto-fix-pull-requests)을 원하는 팀 |

58| **`/web-setup`** | 터미널에서 `/web-setup`을 실행하여 로컬 `gh` CLI 토큰을 Claude 계정으로 전송합니다. | `gh` 토큰이 액세스할 수 있는 모든 저장소(App 설치 여부와 관계없음) | 이미 `gh`를 사용하는 개별 개발자 |55| **`/web-setup`** | 터미널에서 `/web-setup`을 실행하여 로컬 `gh` CLI 토큰을 Claude 계정으로 전송합니다. | `gh` 토큰이 액세스할 수 있는 모든 저장소(App 설치 여부와 관계없음) | 이미 `gh`를 사용하는 개별 개발자 |

59 56 

60저장소에 Claude GitHub App을 설치하면 해당 저장소의 풀 요청에 대해 [자동 수정](#auto-fix-pull-requests)도 활성화됩니다.57다음 기능은 저장소에 Claude GitHub App이 설치되어 있어야 합니다:

61 58 

62[프로젝트](/docs/ko/claude-projects)의 스레드는 연결 방법에 관계없이 복제하는 각 저장소에 Claude GitHub App이 설치되어 있어야 합니다. [GitHub 액세스 설정](/docs/ko/claude-projects#set-up-github-access)을 참조하세요.59* **자동 수정**: 저장소에 Claude GitHub App을 설치하면 해당 저장소의 풀 리퀘스트에 대해 [자동 수정](#auto-fix-pull-requests)도 활성화됩니다

60* **프로젝트**: [프로젝트](/docs/ko/claude-projects)의 스레드는 연결 방법에 관계없이 복제하는 각 저장소에 Claude GitHub App이 설치되어 있어야 합니다. [GitHub 액세스 설정](/docs/ko/claude-projects#set-up-github-access)을 참조하세요

63 61 

64Anthropic 호스팅 환경에서는 GitHub 자격 증명이 Anthropic 서버에 암호화되어 저장되며 세션의 VM에 절대 들어가지 않습니다. VM의 GitHub 작업은 [GitHub 프록시](/docs/ko/cloud-environments#github-proxy)를 통해 진행되며, 이는 서버 측에서 자격 증명을 첨부합니다.62Anthropic 호스팅 환경에서는 GitHub 자격 증명이 Anthropic 서버에 암호화되어 저장되며 세션의 VM에 절대 들어가지 않습니다. VM의 GitHub 작업은 [GitHub 프록시](/docs/ko/cloud-environments#github-proxy)를 통해 진행되며, 이는 서버 측에서 자격 증명을 첨부합니다.

65 63 

66`/schedule`이 루틴을 생성하기 전에 저장소 액세스를 확인하는 방법은 [저장소 및 분기 권한](/docs/ko/routines#repositories-and-branch-permissions)을 참조하세요. `/web-setup` 안내(포함된 내용 및 제거 방법 포함)는 [터미널에서 연결](/docs/ko/web-quickstart#connect-from-your-terminal)을 참조하세요.64`/web-setup` 안내(`/web-setup`이 저장하는 내용 및 제거 방법 포함)는 [터미널에서 연결](/docs/ko/web-quickstart#connect-from-your-terminal)을 참조하세요.

67 

68빠른 웹 설정은 구성원이 `/web-setup`으로 GitHub를 연결할 수 있게 하고, 브라우저 온보딩 중에 Claude GitHub App 설치 프롬프트를 건너뛰고, 환경 양식을 표시하는 대신 브라우저 온보딩이 [**기본** 환경](/docs/ko/cloud-environments#the-default-environment)을 생성하도록 하는 조직 설정입니다. Team 및 Enterprise 플랜에서는 기본적으로 꺼져 있으며, 이는 `/web-setup`을 숨깁니다. [Owner](/docs/ko/server-managed-settings#access-control)는 [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code)의 **Quick web setup** 토글로 켭니다.

69 65 

70<Note>66<Note>

71 [Zero Data Retention](/docs/ko/zero-data-retention)이 활성화된 조직은 `/web-setup` 또는 기타 클라우드 세션 기능을 사용할 수 없습니다.67 [Zero Data Retention](/docs/ko/zero-data-retention)이 활성화된 조직은 `/web-setup` 또는 기타 클라우드 세션 기능을 사용할 수 없습니다.

72</Note>68</Note>

73 69 

70<h3 id="quick-web-setup-for-team-and-enterprise">

71 Team 및 Enterprise용 빠른 웹 설정

72</h3>

73 

74빠른 웹 설정은 구성원의 GitHub 및 환경 설정 단계를 줄여 주는 조직 설정입니다. Team 및 Enterprise 플랜에서는 기본적으로 꺼져 있습니다.

75 

76이 설정을 켜면 구성원에게 다음과 같은 변화가 있습니다:

77 

78* **`/web-setup`**: 구성원이 `/web-setup`으로 GitHub를 연결할 수 있습니다. 설정이 꺼져 있는 동안에는 이 명령이 숨겨집니다

79* **GitHub App 프롬프트**: 브라우저 온보딩에서 Claude GitHub App 설치 프롬프트를 건너뜁니다

80* **첫 번째 환경**: 브라우저 온보딩이 환경 양식을 표시하는 대신 구성원을 위해 [**기본** 환경](/docs/ko/cloud-environments#the-default-environment)을 생성합니다

81 

82[Owner](/docs/ko/server-managed-settings#access-control)는 [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code)의 **Quick web setup** 토글로 이 설정을 켭니다.

83 

74<h2 id="move-tasks-between-terminal-and-cloud">84<h2 id="move-tasks-between-terminal-and-cloud">

75 터미널과 클라우드 간 작업 이동85 터미널과 클라우드 간 작업 이동

76</h2>86</h2>

78이러한 워크플로우는 동일한 claude.ai 계정으로 로그인한 [Claude Code CLI](/docs/ko/quickstart)가 필요합니다. 터미널에서 새로운 클라우드 세션을 시작하거나, 클라우드 세션을 터미널로 가져와 로컬에서 계속 작업할 수 있습니다. 클라우드 세션은 노트북을 닫아도 유지되며, Claude 모바일 앱을 포함한 어디서나 모니터링할 수 있습니다.88이러한 워크플로우는 동일한 claude.ai 계정으로 로그인한 [Claude Code CLI](/docs/ko/quickstart)가 필요합니다. 터미널에서 새로운 클라우드 세션을 시작하거나, 클라우드 세션을 터미널로 가져와 로컬에서 계속 작업할 수 있습니다. 클라우드 세션은 노트북을 닫아도 유지되며, Claude 모바일 앱을 포함한 어디서나 모니터링할 수 있습니다.

79 89 

80<Note>90<Note>

81 CLI에서 세션 핸드오프는 일방향입니다. `--teleport`를 사용하여 클라우드 세션을 터미널로 가져올 수 있지만, 기존 터미널 세션을 클라우드로 푸시할 수는 없습니다. 작업 설명과 함께 `--cloud` 플래그는 현재 저장소에 대한 새로운 클라우드 세션을 생성합니다. `-p`와 세션 ID 또는 claude.ai/code URL을 사용하면 대신 [해당 기존 세션에 메시지를 큐에 넣습니다](/docs/ko/claude-code-on-the-web#send-follow-ups-from-the-cli). [Desktop 앱](/docs/ko/desktop#continue-in-another-surface)은 로컬 세션을 클라우드로 보낼 수 있는 **Continue in** 메뉴를 제공합니다.91 CLI에서 세션 핸드오프는 일방향입니다. `--teleport`를 사용하여 클라우드 세션을 터미널로 가져올 수 있지만, 기존 터미널 세션을 클라우드로 푸시할 수는 없습니다. 작업 설명과 함께 `--cloud` 플래그는 현재 저장소에 대한 새로운 클라우드 세션을 생성합니다. `-p`와 세션 ID 또는 claude.ai/code URL을 사용하면 대신 [해당 기존 세션에 메시지를 큐에 넣습니다](/docs/ko/claude-code-on-the-web#send-follow-ups-from-the-cli). [Desktop 앱](/docs/ko/desktop#continue-in-another-surface)은 **Open in** 메뉴에서 Code 탭의 로컬 세션을 클라우드로 보낼 수 있습니다.

82</Note>92</Note>

83 93 

84<h3 id="from-terminal-to-cloud">94<h3 id="from-terminal-to-cloud">

173 CLI에서 후속 메시지 보내기183 CLI에서 후속 메시지 보내기

174</h3>184</h3>

175 185 

176클라우드 세션이 실행 중이면, 어디서 실행되든 `claude auth login`으로 로그인한 모든 머신의 `claude` CLI에서 후속 메시지를 보낼 수 있습니다. CLI는 Anthropic 계정 자격 증명으로 인증하고 로컬 세션 상태를 보내지 않으므로, 명령은 세션을 시작한 머신에서 실행할 필요가 없으며, PowerShell을 포함한 모든 셸에서 동일합니다.186클라우드 세션이 실행 중이면, 어디서 실행되든 `claude auth login`으로 로그인한 모든 머신의 `claude` CLI에서 후속 메시지를 보낼 수 있습니다. CLI는 Anthropic 계정 자격 증명으로 인증하고 로컬 세션 상태를 보내지 않으므로, 명령은 세션을 시작한 머신에서 실행할 필요가 없습니다.

177 187 

178명령은 하나의 메시지를 게시하고 종료합니다:188명령은 하나의 메시지를 게시하고 종료합니다:

179 189 

189 `--cloud`는 Anthropic 계정이 필요합니다. Claude Code가 Amazon Bedrock, Google Cloud의 Agent Platform 또는 다른 타사 제공자로 구성된 경우 사용할 수 없습니다. `ANTHROPIC_BASE_URL`을 통해서만 구성된 [LLM gateway](/docs/ko/llm-gateway)는 이 확인에서 타사 제공자로 간주되지 않지만, 여전히 `claude auth login`으로 로그인해야 합니다. 조직의 `allow_remote_sessions` 정책도 활성화되어야 합니다. 소유자는 claude.ai/admin-settings/claude-code의 Claude Code 관리 설정에서 이를 켤 수 있습니다.199 `--cloud`는 Anthropic 계정이 필요합니다. Claude Code가 Amazon Bedrock, Google Cloud의 Agent Platform 또는 다른 타사 제공자로 구성된 경우 사용할 수 없습니다. `ANTHROPIC_BASE_URL`을 통해서만 구성된 [LLM gateway](/docs/ko/llm-gateway)는 이 확인에서 타사 제공자로 간주되지 않지만, 여전히 `claude auth login`으로 로그인해야 합니다. 조직의 `allow_remote_sessions` 정책도 활성화되어야 합니다. 소유자는 claude.ai/admin-settings/claude-code의 Claude Code 관리 설정에서 이를 켤 수 있습니다.

190</Note>200</Note>

191 201 

192<h4 id="output-and-errors">202<h4 id="output">

193 출력 및 오류203 출력

194</h4>204</h4>

195 205 

196성공하면 명령은 세션 ID와 세션을 보기 위한 링크를 인쇄합니다:206성공하면 명령은 세션 ID와 세션을 보기 위한 링크를 인쇄합니다:

203 213 

204`--output-format json`을 전달하여 머신이 읽을 수 있는 결과를 얻습니다: 성공 시 `{ok, session_id, url}`, 또는 세션이 누락되거나 보관된 경우와 같이 전송이 실패할 때 `{ok: false, session_id, error}`입니다. 지원되지 않는 제공자 또는 비활성화된 조직 정책과 같은 구성 오류는 JSON 없이 stderr에 인쇄됩니다. `--output-format stream-json`은 `--cloud <session-id>`에서 지원되지 않습니다.214`--output-format json`을 전달하여 머신이 읽을 수 있는 결과를 얻습니다: 성공 시 `{ok, session_id, url}`, 또는 세션이 누락되거나 보관된 경우와 같이 전송이 실패할 때 `{ok: false, session_id, error}`입니다. 지원되지 않는 제공자 또는 비활성화된 조직 정책과 같은 구성 오류는 JSON 없이 stderr에 인쇄됩니다. `--output-format stream-json`은 `--cloud <session-id>`에서 지원되지 않습니다.

205 215 

206CLI는 오류 앞에 `Error: `를 붙입니다. 실패한 전달은 `failed to send message to cloud session <id>: <reason>`으로 래핑됩니다.216전송이 실패하면 [클라우드 세션으로 전송할 때의 오류](#errors-when-sending-to-a-cloud-session)를 참조하십시오.

207 

208| 메시지 | 의미 |

209| - | - |

210| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code가 타사 제공자로 구성되어 있습니다. 메시지는 구성에서 사용하는 레이블(예: `Amazon Bedrock` 또는 `Google Vertex AI`)과 함께 제공자의 이름을 지정합니다. 해당 제공자의 구성을 제거합니다(예: `CLAUDE_CODE_USE_BEDROCK` 설정 해제). Anthropic 계정으로 로그인합니다(`claude auth login`). |

211| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 조직 정책이 꺼져 있습니다. |

212| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code가 조직의 정책을 가져올 수 없어 클라우드 세션이 허용된다고 가정하지 않고 전송을 거부합니다. 네트워크 연결을 확인하고 다시 시도합니다. |

213| `Attaching to an existing cloud session is not enabled for your account.` | `-p` 없이 `--cloud <session-id>`를 실행했습니다. `claude -p "your message" --cloud <session-id>`로 메시지를 보냅니다. |

214| `Session not found: <id>` | ID 또는 URL이 액세스할 수 있는 세션과 일치하지 않습니다. 세션의 claude.ai/code URL에 대해 확인합니다. |

215| `cloud session <id> is archived and cannot accept new messages` | 세션이 보관되었습니다. 대신 새 세션을 시작합니다. |

216 217 

217<h3 id="from-cloud-to-terminal">218<h3 id="from-cloud-to-terminal">

218 클라우드에서 터미널로219 클라우드에서 터미널로

239| 요구 사항 | 세부 사항 |240| 요구 사항 | 세부 사항 |

240| - | - |241| - | - |

241| 깨끗한 git 상태 | 작업 디렉토리에 커밋되지 않은 변경 사항이 없어야 합니다. Teleport는 필요한 경우 변경 사항을 stash하라는 메시지를 표시합니다. |242| 깨끗한 git 상태 | 작업 디렉토리에 커밋되지 않은 변경 사항이 없어야 합니다. Teleport는 필요한 경우 변경 사항을 stash하라는 메시지를 표시합니다. |

242| 올바른 저장소 | 포크가 아닌 동일한 저장소의 체크아웃에서 `--teleport`를 실행해야 합니다. 다른 저장소의 체크아웃에서 실행하면 Claude Code는 세션의 저장소와 체크아웃의 이름을 모두 지정하는 오류를 표시합니다. v2.1.219 이전에는 오류가 체크아웃의 저장소 이름을 지정하지 않았습니다. Claude Code가 원격을 호스트 이름으로 파싱할 수 없으면(예: `git@work:owner/repo.git`과 같은 SSH 호스트 별칭), 확인을 요청하고 원격의 소유자 및 저장소 이름이 세션의 저장소와 일치할 때 체크아웃을 수락합니다. |243| 올바른 저장소 | 포크가 아닌 동일한 저장소의 체크아웃에서 `--teleport`를 실행해야 합니다. 다른 저장소의 체크아웃에서 실행하면 Claude Code는 세션의 저장소와 체크아웃의 저장소 이름을 모두 표시하는 오류를 보여줍니다. Claude Code가 원격을 호스트 이름으로 파싱할 수 없으면(예: `git@work:owner/repo.git`과 같은 SSH 호스트 별칭), 확인을 요청하고 원격의 소유자 및 저장소 이름이 세션의 저장소와 일치할 때 체크아웃을 수락합니다. |

243| 사용 가능한 브랜치 | 클라우드 세션의 브랜치를 원격으로 푸시해야 합니다. Teleport는 자동으로 가져와 체크아웃합니다. |244| 사용 가능한 브랜치 | 클라우드 세션의 브랜치를 원격으로 푸시해야 합니다. Teleport는 자동으로 가져와 체크아웃합니다. |

244| 동일한 계정 | 클라우드 세션에서 사용된 동일한 claude.ai 계정으로 인증해야 합니다. |245| 동일한 계정 | 클라우드 세션에서 사용된 동일한 claude.ai 계정으로 인증해야 합니다. |

245 246 

249 `--teleport`를 사용할 수 없음250 `--teleport`를 사용할 수 없음

250</h4>251</h4>

251 252 

252Teleport는 claude.ai 구독 인증이 필요합니다. API 키를 통해 인증된 경우 `/login`을 실행하여 대신 claude.ai 계정으로 로그인합니다. 오류가 제공자의 이름을 지정하면 클라우드 세션을 타사 제공자를 통해 사용할 수 없습니다. [오류 테이블](#output-and-errors)을 참조하십시오. 이미 claude.ai를 통해 로그인했는데 `--teleport`를 여전히 사용할 수 없으면, 조직이 클라우드 세션을 비활성화했을 수 있습니다.253Teleport는 claude.ai 구독 인증이 필요합니다. 해당하는 경우를 찾으십시오:

254 

255* **API 키를 통해 인증된 경우**: `/login`을 실행하여 대신 claude.ai 계정으로 로그인합니다

256* **오류가 제공자의 이름을 표시하는 경우**: 클라우드 세션은 타사 제공자를 통해 사용할 수 없습니다. [오류 테이블](#errors-when-sending-to-a-cloud-session)을 참조하십시오

257* **이미 claude.ai를 통해 로그인한 경우**: 조직이 클라우드 세션을 비활성화했을 수 있습니다

253 258 

254<h2 id="work-with-sessions">259<h2 id="work-with-sessions">

255 세션 작업260 세션 작업

257 262 

258세션은 claude.ai/code의 사이드바에 나타납니다. 여기서 변경 사항을 검토하고, 팀원과 공유하고, 완료된 작업을 보관하거나, 세션을 영구적으로 삭제할 수 있습니다.263세션은 claude.ai/code의 사이드바에 나타납니다. 여기서 변경 사항을 검토하고, 팀원과 공유하고, 완료된 작업을 보관하거나, 세션을 영구적으로 삭제할 수 있습니다.

259 264 

260<h3 id="take-back-a-queued-message">265<h3 id="permission-modes-in-cloud-sessions">

261 대기 중인 메시지 되돌리기266 클라우드 세션의 권한 모드

262</h3>267</h3>

263 268 

264Claude가 작업 중일 때 메시지를 보내면 Claude가 읽을 때까지 메시지가 대기합니다. 대기 중인 메시지를 되돌리려면 메시지의 ✕를 클릭하세요. 텍스트가 메시지 상자로 돌아가므로 편집하거나 다른 내용을 보낼 수 있습니다.269클라우드 세션의 [권한 모드](/docs/ko/permission-modes)는 작업을 생성할 때와 세션이 실행되는 동안 모두 [모드 드롭다운](/docs/ko/permission-modes#switch-permission-modes)에서 선택합니다.

265 270 

266Claude가 이미 메시지를 읽었다면 메시지는 대화에 남아 있습니다.271다음 중 하나를 수행하면 Claude Code는 세션이 있던 권한 모드에서 세션을 재개합니다:

272 

273* Anthropic 호스팅 [환경이 만료된](#environment-expired) 세션을 다시 열기

274* 자체 호스팅 runner가 [유휴 상태일 때 해제한](/docs/ko/self-hosted-environments-reference#runner-cli-flags) 세션에 메시지 보내기

275 

276<h3 id="review-changes">

277 변경 사항 검토

278</h3>

279 

280각 세션은 추가 및 제거된 줄을 표시하는 diff 표시기를 표시합니다(예: `+42 -18`). 이를 선택하여 diff 보기를 열고, 특정 줄에 인라인 주석을 남기고, 다음 메시지로 Claude에 보내세요.

281 

282diff 보기는 기본적으로 세션의 변경 사항을 해당 기본 브랜치와 비교합니다. 저장소의 다른 브랜치와 비교하려면 **Compare against**를 선택하고 브랜치를 하나 고르세요.

283 

284Claude Code는 이러한 diff를 raw git blob 콘텐츠에서 계산하므로 저장소에 구성된 diff 드라이버 및 `textconv` 필터는 적용되지 않습니다.

285 

286다음 단계는 다른 곳에서 다룹니다:

287 

288* **PR 생성을 포함한 전체 안내**: [검토 및 반복](/docs/ko/web-quickstart#review-and-iterate)을 참조하세요

289* **Claude가 PR을 모니터링하여 CI 실패 및 검토 주석에 자동으로 대응하도록 하기**: [풀 리퀘스트 자동 수정](#auto-fix-pull-requests)을 참조하세요

267 290 

268<h3 id="manage-context">291<h3 id="manage-context">

269 컨텍스트 관리292 컨텍스트 관리

291 314 

292[Agent teams](/docs/ko/agent-teams)는 기본적으로 꺼져 있지만 [환경 변수](/docs/ko/cloud-environments#set-environment-variables)에 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`을 추가하여 활성화할 수 있습니다.315[Agent teams](/docs/ko/agent-teams)는 기본적으로 꺼져 있지만 [환경 변수](/docs/ko/cloud-environments#set-environment-variables)에 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`을 추가하여 활성화할 수 있습니다.

293 316 

294<h3 id="permission-modes-in-cloud-sessions">317<h3 id="take-back-a-queued-message">

295 클라우드 세션의 권한 모드318 대기 중인 메시지 되돌리기

296</h3>

297 

298[권한 모드](/docs/ko/permission-modes)는 [모드 드롭다운](/docs/ko/permission-modes#switch-permission-modes)에서 클라우드 세션을 생성할 때와 세션이 실행되는 동안 선택합니다. Anthropic 호스팅 [환경이 만료된](#environment-expired) 세션을 다시 열거나 자체 호스팅 runner가 [유휴 상태일 때 해제한](/docs/ko/self-hosted-environments-reference#runner-cli-flags) 세션에 메시지를 보내면 Claude Code는 세션이 있던 권한 모드에서 세션을 재개합니다.

299 

300<h3 id="review-changes">

301 변경 사항 검토

302</h3>319</h3>

303 320 

304각 세션은 추가 및 제거된 줄을 표시하는 diff 표시기를 표시합니다(예: `+42 -18`). 이를 선택하여 diff 보기를 열고, 특정 줄에 인라인 주석을 남기고, 다음 메시지로 Claude에 보내세요.321Claude가 작업 중일 때 메시지를 보내면 Claude가 읽을 때까지 메시지가 대기합니다. 대기 중인 메시지를 되돌리려면 메시지의 ✕를 클릭하세요. 텍스트가 메시지 상자로 돌아가므로 편집하거나 다른 내용을 보낼 수 있습니다.

305 

306diff 보기는 따로 선택하지 않으면 세션의 변경 사항을 해당 기본 분기와 비교합니다. 저장소의 다른 분기와 비교하려면 **Compare against**를 선택하고 분기를 하나 고르세요.

307 

308Claude Code는 이러한 diffs(Claude가 편집할 때 표시되는 파일별 diffs 포함)를 raw git blob 콘텐츠에서 계산하므로 저장소에 구성된 diff 드라이버 및 `textconv` 필터는 적용되지 않습니다. 세션의 자체 체크아웃 중 하나가 아닌 저장소의 파일(예: 세션 중에 워크스페이스 내에 복제된 파일)의 경우 파일별 diff는 git 비교가 아니라 Claude의 편집 자체를 표시합니다.

309 322 

310PR 생성을 포함한 전체 안내는 [검토 및 반복](/docs/ko/web-quickstart#review-and-iterate)을 참조하세요. Claude가 PR을 모니터링하여 CI 실패 및 검토 주석에 자동으로 응답하도록 하려면 [Pull request 자동 수정](#auto-fix-pull-requests)을 참조하세요.323Claude가 이미 메시지를 읽었다면 메시지는 대화에 남아 있습니다.

311 324 

312<h3 id="share-sessions">325<h3 id="share-sessions">

313 세션 공유326 세션 공유

319 Enterprise 또는 Team 계정에서 공유332 Enterprise 또는 Team 계정에서 공유

320</h4>333</h4>

321 334 

322Enterprise 및 Team 계정의 경우 두 가지 가시성 옵션은 **Private** 및 **Team**입니다. Team 가시성은 claude.ai 조직의 다른 구성원에게 세션을 표시합니다. [Claude in Slack](/docs/ko/slack) 세션은 자동으로 Team 가시성으로 공유됩니다.335Enterprise 및 Team 계정의 공유는 다음과 같이 작동합니다:

323 336 

324저장소 액세스 확인은 기본적으로 수신자의 계정에 연결된 GitHub 계정을 기반으로 활성화됩니다. 계정의 표시 이름은 액세스 권한이 있는 모든 수신자에게 표시됩니다.337* **가시성 옵션**: **Private** 및 **Team**. Team 가시성은 claude.ai 조직의 다른 구성원에게 세션을 표시합니다

338* **저장소 액세스**: 수신자의 계정에 연결된 GitHub 계정을 기반으로 확인이 기본적으로 활성화됩니다

339* **사용자 이름**: 계정의 표시 이름은 액세스 권한이 있는 모든 수신자에게 표시됩니다

340* **Slack 세션**: [Claude in Slack](/docs/ko/slack) 세션은 자동으로 Team 가시성으로 공유됩니다

325 341 

326<h4 id="share-from-a-max-or-pro-account">342<h4 id="share-from-a-max-or-pro-account">

327 Max 또는 Pro 계정에서 공유343 Max 또는 Pro 계정에서 공유

328</h4>344</h4>

329 345 

330Max 및 Pro 계정의 경우 두 가지 가시성 옵션은 **Private** 및 **Public**입니다. Public 가시성은 claude.ai에 로그인한 모든 사용자에게 세션을 표시합니다.346Max 및 Pro 계정의 공유는 다음과 같이 작동합니다:

331 347 

332공유하기 전에 민감한 내용이 있는지 세션을 확인하세요. 세션에는 개인 GitHub 저장소의 코드 및 자격 증명이 포함될 수 있습니다. 저장소 액세스 확인은 기본적으로 활성화되지 않습니다.348* **가시성 옵션**: **Private** 및 **Public**. Public 가시성은 claude.ai에 로그인한 모든 사용자에게 세션을 표시합니다

349* **저장소 액세스**: 확인은 기본적으로 활성화되지 않습니다

350* **민감한 내용**: 공유하기 전에 세션을 확인하세요. 세션에는 개인 GitHub 저장소의 코드 및 자격 증명이 포함될 수 있습니다

333 351 

334저장소 액세스를 요구하거나 공유 세션에서 이름을 숨기려면 [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code)로 이동하세요.352저장소 액세스를 요구하거나 공유 세션에서 이름을 숨기려면 [**Settings > Claude Code > Sharing settings**](https://claude.ai/settings/claude-code)로 이동하세요.

335 353 

421 조직 UUID를 가져올 수 없음439 조직 UUID를 가져올 수 없음

422</h3>440</h3>

423 441 

424`claude --cloud` 및 `claude --teleport`는 claude.ai 계정으로 로그인해야 합니다. API 키로 인증하거나 저장된 계정 세부 정보가 오래된 경우 이러한 명령은 `Unable to get organization UUID` 또는 API 키 인증이 충분하지 않다는 메시지로 실패합니다. API 키 인증 또는 오래된 계정 세부 정보를 사용하면 세션 ID 없이 `claude --teleport`를 실행하면 세션 선택기에 `Error loading Claude Code sessions`이 표시되고 동일한 수정이 적용됩니다.442`claude --cloud` 및 `claude --teleport`는 claude.ai 계정으로 로그인해야 합니다. API 키로 인증하거나 저장된 계정 세부 정보가 오래된 경우 다음 중 하나가 표시됩니다.

443 

444* `Unable to get organization UUID`

445* API 키 인증이 충분하지 않다는 메시지

446* 세션 ID 없이 `claude --teleport`를 실행할 때 세션 선택기에 표시되는 `Error loading Claude Code sessions`

425 447 

426`/login`을 실행하여 claude.ai 계정으로 로그인한 다음 명령을 다시 시도하세요. 오류가 제공자의 이름을 지정하면 [오류 표](#output-and-errors)를 참조하세요: 클라우드 세션을 타사 제공자를 통해 사용할 수 없습니다.448`/login`을 실행하여 claude.ai 계정으로 로그인한 다음 명령을 다시 시도하세요. 오류가 제공자의 이름을 지정하면 [오류 표](#errors-when-sending-to-a-cloud-session)를 참조하세요: 클라우드 세션을 타사 제공자를 통해 사용할 수 없습니다.

427 449 

428<h3 id="remote-control-session-expired-or-access-denied">450<h3 id="remote-control-session-expired-or-access-denied">

429 Remote Control 세션 만료 또는 액세스 거부451 Remote Control 세션 만료 또는 액세스 거부

435* 세션을 소유한 동일한 계정으로 로그인했는지 확인하세요457* 세션을 소유한 동일한 계정으로 로그인했는지 확인하세요

436* `Remote Control may not be available for this organization`이 표시되면 Owner가 조직에 대해 클라우드 세션을 활성화하지 않았습니다458* `Remote Control may not be available for this organization`이 표시되면 Owner가 조직에 대해 클라우드 세션을 활성화하지 않았습니다

437 459 

460<h3 id="errors-when-sending-to-a-cloud-session">

461 클라우드 세션으로 전송 시 오류

462</h3>

463 

464이러한 오류는 `-p` 사용 여부와 관계없이 [`--cloud <session-id>`](#send-follow-ups-from-the-cli)와 함께 `claude`를 실행할 때 발생합니다. CLI는 오류 앞에 `Error: `를 붙입니다. 전달에 실패하면 `failed to send message to cloud session <id>: <reason>` 형식으로 감싸서 표시됩니다.

465 

466| 메시지 | 의미 |

467| - | - |

468| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code가 타사 제공자용으로 구성되어 있습니다. 메시지에는 `Amazon Bedrock` 또는 `Google Vertex AI`와 같이 구성에서 사용하는 레이블로 제공자 이름이 표시됩니다. 예를 들어 `CLAUDE_CODE_USE_BEDROCK`의 설정을 해제하는 방식으로 해당 제공자의 구성을 제거하고 Anthropic 계정으로 로그인하세요(`claude auth login`). |

469| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 조직 정책이 꺼져 있습니다. |

470| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code가 조직의 정책을 가져올 수 없어서 클라우드 세션이 허용된다고 가정하는 대신 전송을 거부합니다. 네트워크 연결을 확인하고 다시 시도하세요. |

471| `Attaching to an existing cloud session is not enabled for your account.` | `-p` 없이 `--cloud <session-id>`를 실행했습니다. `claude -p "your message" --cloud <session-id>`로 메시지를 보내세요. |

472| `Session not found: <id>` | ID 또는 URL이 액세스할 수 있는 세션과 일치하지 않습니다. 세션의 claude.ai/code URL과 대조하여 확인하세요. |

473| `cloud session <id> is archived and cannot accept new messages` | 세션이 보관되었습니다. 대신 새 세션을 시작하세요. |

474 

438<h3 id="environment-expired">475<h3 id="environment-expired">

439 환경 만료476 환경 만료

440</h3>477</h3>

441 478 

442클라우드 세션은 비활성 기간 후 중지되고 세션의 VM이 회수됩니다. 세션은 [MCP connector](/docs/ko/cloud-environments#network-access) 도구 호출을 승인하거나 MCP 서버에 로그인하기를 기다리는 동안 비활성으로 간주되며 해당 대기 중에 만료될 수 있습니다.479클라우드 세션은 비활성 기간 후 중지되고 세션의 VM이 회수됩니다. 세션은 [MCP connector](/docs/ko/cloud-environments#network-access) 도구 호출을 승인하거나 MCP 서버에 로그인하기를 기다리는 동안 비활성으로 간주되며 해당 대기 중에 만료될 수 있습니다.

443 480 

444[claude.ai/code](https://claude.ai/code)에서 세션을 다시 열어 대화 기록이 복원된 새로운 VM을 프로비저닝하세요. VM이 회수되었을 때 여전히 실행 중이던 백그라운드 작업(예: subagents 및 셸 명령)은 복원되지 않습니다.481[claude.ai/code](https://claude.ai/code)에서 세션을 다시 열어 새로운 VM을 프로비저닝하세요.

482 

483* **복원됨**: 대화 기록

484* **복원되지 않음**: VM이 회수되었을 때 여전히 실행 중이던 백그라운드 작업(예: 서브에이전트 및 셸 명령)

445 485 

446<h2 id="limitations">486<h2 id="limitations">

447 제한 사항487 제한 사항

1455| `managed-settings.json` | 시스템 수준, OS에 따라 다름 | 재정의할 수 없는 엔터프라이즈 강제 설정입니다. [좁은 예외](/docs/ko/settings#security-keys-where-the-stricter-value-applies)를 제외하고는 재정의할 수 없습니다. [파일을 저장할 위치](/docs/ko/managed-settings#deploy-a-managed-settings-file) 및 [Claude Code가 사용하는 관리되는 소스](/docs/ko/managed-settings#precedence-within-the-managed-tier)를 참조하세요. |1455| `managed-settings.json` | 시스템 수준, OS에 따라 다름 | 재정의할 수 없는 엔터프라이즈 강제 설정입니다. [좁은 예외](/docs/ko/settings#security-keys-where-the-stricter-value-applies)를 제외하고는 재정의할 수 없습니다. [파일을 저장할 위치](/docs/ko/managed-settings#deploy-a-managed-settings-file) 및 [Claude Code가 사용하는 관리되는 소스](/docs/ko/managed-settings#precedence-within-the-managed-tier)를 참조하세요. |

1456| `CLAUDE.local.md` | 프로젝트 루트 | 이 프로젝트에 대한 개인 기본 설정으로, CLAUDE.md와 함께 로드됩니다. 수동으로 생성하고 `.gitignore`에 추가합니다. |1456| `CLAUDE.local.md` | 프로젝트 루트 | 이 프로젝트에 대한 개인 기본 설정으로, CLAUDE.md와 함께 로드됩니다. 수동으로 생성하고 `.gitignore`에 추가합니다. |

1457| `AGENTS.md` | 프로젝트 루트, `.claude/`, 또는 모든 디렉터리 | AI 코딩 에이전트를 위해 작성하는 프로젝트 지침입니다. Claude Code는 [이를 로드](/docs/ko/memory#agents-md)할 수 있으며, `CLAUDE.md`와 함께 로드할 수도 있습니다. |1457| `AGENTS.md` | 프로젝트 루트, `.claude/`, 또는 모든 디렉터리 | AI 코딩 에이전트를 위해 작성하는 프로젝트 지침입니다. Claude Code는 [이를 로드](/docs/ko/memory#agents-md)할 수 있으며, `CLAUDE.md`와 함께 로드할 수도 있습니다. |

1458| 설치된 플러그인 | `~/.claude/plugins` | 복제된 마켓플레이스, 설치된 플러그인 버전, `installed_plugins.json` 설치 기록, 플러그인별 데이터로, `claude plugin` 명령으로 관리됩니다. [claude.ai 계정에서 동기화된](/docs/ko/plugins/loading#synced-plugins) 플러그인은 `~/.claude/plugins/synced/`로 다운로드됩니다. 마켓플레이스 [`command` 소스](/docs/ko/plugins/marketplace-reference#command-plugin-source)에서 링크 모드로 설치된 플러그인의 경우, Claude Code는 복사본 대신 여기에 링크를 저장하고, 플러그인의 파일은 명령이 출력하는 디렉터리에 남아 있습니다. `command` 소스는 Claude Code v2.1.229 이상이 필요합니다. 로컬 디렉터리 마켓플레이스에서 상대 경로로 나열된 플러그인도 캐시 복사본이 아닌 소스 디렉터리에서 [제자리에 로드](/docs/ko/plugins/loading#find-plugins-on-disk)됩니다. [플러그인 캐싱](/docs/ko/plugins/loading#find-plugins-on-disk)에서 고아 버전이 정리되는 방식을 참조하세요. |1458| 설치된 플러그인 | `~/.claude/plugins` | 복제된 마켓플레이스, 설치된 플러그인 버전, `installed_plugins.json` 설치 기록, 플러그인별 데이터로, `claude plugin` 명령으로 관리됩니다. [claude.ai 계정에서 동기화된](/docs/ko/plugins/loading#synced-plugins) 플러그인은 `~/.claude/plugins/synced/`로 다운로드됩니다. 마켓플레이스 [`command` 소스](/docs/ko/plugins/marketplace-reference#command-plugin-source)에서 링크 모드로 설치된 플러그인의 경우, Claude Code는 복사본 대신 여기에 링크를 저장하고, 플러그인의 파일은 명령이 출력하는 디렉터리에 남아 있습니다. `command` 소스는 Claude Code v2.1.229 이상이 필요합니다. 로컬 경로에서 추가한 마켓플레이스에 상대 경로로 나열된 플러그인도 캐시 복사본이 아닌 소스 디렉터리에서 [제자리에 로드](/docs/ko/plugins/loading#find-plugins-on-disk)됩니다. [플러그인 캐싱](/docs/ko/plugins/loading#find-plugins-on-disk)에서 고아 버전이 정리되는 방식을 참조하세요. |

1459 1459 

1460`~/.claude`는 또한 작업할 때 Claude Code가 작성하는 데이터를 보유합니다. 트랜스크립트, 프롬프트 기록, 파일 스냅샷, 캐시, 로그입니다. 아래의 [애플리케이션 데이터](#application-data)를 참조하세요.1460`~/.claude`는 또한 작업할 때 Claude Code가 작성하는 데이터를 보유합니다. 트랜스크립트, 프롬프트 기록, 파일 스냅샷, 캐시, 로그입니다. 아래의 [애플리케이션 데이터](#application-data)를 참조하세요.

1461 1461 

26 26 

27* **`/web-setup`과 같은 CLI 흐름**: **Default**를 생성합니다27* **`/web-setup`과 같은 CLI 흐름**: **Default**를 생성합니다

28* **Pro 및 Max의 웹 온보딩**: **Default**를 생성합니다28* **Pro 및 Max의 웹 온보딩**: **Default**를 생성합니다

29* **Team 및 Enterprise의 웹 온보딩**: Owner가 [빠른 웹 설정](/docs/ko/claude-code-on-the-web#github-authentication-options)을 켜지 않은 한 **첫 번째 클라우드 환경 생성** 양식을 표시합니다. 양식의 기본값을 유지하고 **생성 및 완료**를 클릭하여 동일한 **Default** 환경을 얻습니다29* **Team 및 Enterprise의 웹 온보딩**: Owner가 [빠른 웹 설정](/docs/ko/claude-code-on-the-web#quick-web-setup-for-team-and-enterprise)을 켜지 않은 한 **첫 번째 클라우드 환경 생성** 양식을 표시합니다. 양식의 기본값을 유지하고 **생성 및 완료**를 클릭하여 동일한 **Default** 환경을 얻습니다

30 30 

31**Default**는 자체 구성을 수행하지 않습니다:31**Default**는 자체 구성을 수행하지 않습니다:

32 32 

192다음 중 하나가 전체 텍스트를 표시합니다:192다음 중 하나가 전체 텍스트를 표시합니다:

193 193 

194* `Ctrl+O`를 눌러 [대화 기록 뷰어](/docs/ko/interactive-mode#transcript-viewer)를 열고 발신자의 세션 이름 아래에서 전체 텍스트를 읽습니다.194* `Ctrl+O`를 눌러 [대화 기록 뷰어](/docs/ko/interactive-mode#transcript-viewer)를 열고 발신자의 세션 이름 아래에서 전체 텍스트를 읽습니다.

195* [전체 화면 렌더링](/docs/ko/fullscreen#use-the-mouse)에서 메시지 일부가 생략된 미리보기 줄을 클릭하면 해당 위치에서 확장됩니다.

195* [`--verbose`](/docs/ko/cli-reference#cli-flags)로 시작한 세션에서, Claude Code는 미리보기 대신 전체 텍스트를 표시합니다.196* [`--verbose`](/docs/ko/cli-reference#cli-flags)로 시작한 세션에서, Claude Code는 미리보기 대신 전체 텍스트를 표시합니다.

196 197 

197미리보기는 표시되는 것만 단축합니다. 확장하든 안 하든, Claude는 전체 메시지를 읽습니다.198미리보기는 표시되는 것만 단축합니다. 확장하든 안 하든, Claude는 전체 메시지를 읽습니다.

382 382 

383두 세션을 동시에 보려면 macOS에서 **Cmd**를 누르거나 Windows에서 **Ctrl**을 누르고 사이드바의 세션을 클릭합니다. 세션이 이미 열려 있는 창 옆에 두 번째 창에서 열립니다. 분할이 활성화되어 있는 동안 다른 사이드바 세션을 클릭하면 포커스가 있는 창을 바꿉니다. macOS에서 \*\*Cmd+\\\*\*를 누르거나 Windows에서 \*\*Ctrl+\\\*\*를 눌러 포커스된 창을 닫고 단일 세션으로 돌아갑니다.383두 세션을 동시에 보려면 macOS에서 **Cmd**를 누르거나 Windows에서 **Ctrl**을 누르고 사이드바의 세션을 클릭합니다. 세션이 이미 열려 있는 창 옆에 두 번째 창에서 열립니다. 분할이 활성화되어 있는 동안 다른 사이드바 세션을 클릭하면 포커스가 있는 창을 바꿉니다. macOS에서 \*\*Cmd+\\\*\*를 누르거나 Windows에서 \*\*Ctrl+\\\*\*를 눌러 포커스된 창을 닫고 단일 세션으로 돌아갑니다.

384 384 

385Worktrees는 기본적으로 `<project-root>/.claude/worktrees/`에 저장됩니다. Settings → Claude Code의 "Worktree location"에서 사용자 정의 디렉토리로 변경할 수 있습니다. 또한 모든 worktree 브랜치 이름 앞에 추가되는 브랜치 접두사를 설정할 수 있으며, 이는 Claude가 만든 브랜치를 정리하는 데 유용합니다. 완료되면 사이드바의 세션 위에 마우스를 올리고 아카이브 아이콘을 클릭하여 worktree를 제거합니다. PR이 병합되거나 닫힌 후 세션이 자동으로 아카이브되도록 하려면 Settings → Claude Code에서 **Auto-archive after PR merge or close**를 켭니다. 자동 아카이브는 실행을 완료한 로컬 세션에만 적용됩니다.385Worktrees는 기본적으로 `<project-root>/.claude/worktrees/`에 저장됩니다. Settings → Claude Code의 "Worktree location"에서 사용자 정의 디렉토리로 변경할 수 있습니다. 또한 모든 worktree 브랜치 이름 앞에 추가되는 브랜치 접두사를 설정할 수 있으며, 이는 Claude가 만든 브랜치를 정리하는 데 유용합니다. 완료되면 사이드바의 세션 위에 마우스를 올리고 아카이브 아이콘을 클릭하여 worktree를 제거합니다. 풀 리퀘스트가 병합되거나 닫힌 후 세션이 자동으로 아카이브되도록 하려면 Settings → Claude Code에서 **Auto-archive after PR merge or close**를 켭니다. 자동 아카이브는 실행을 완료한 로컬 세션에만 적용됩니다.

386 386 

387gitignored 파일 (예: `.env`)을 새 worktrees에 포함하려면 프로젝트 루트에 [`.worktreeinclude` 파일](/docs/ko/worktrees#copy-gitignored-files-into-worktrees)을 만듭니다.387gitignored 파일 (예: `.env`)을 새 worktrees에 포함하려면 프로젝트 루트에 [`.worktreeinclude` 파일](/docs/ko/worktrees#copy-gitignored-files-into-worktrees)을 만듭니다.

388 388 

410 백그라운드 작업 보기410 백그라운드 작업 보기

411</h3>411</h3>

412 412 

413작업 패널은 현재 세션 내에서 실행 중인 백그라운드 작업을 표시합니다: 서브에이전트, 백그라운드 셸 명령, [동적 워크플로우](/docs/ko/workflows). **Views** 메뉴에서 열거나 레이아웃으로 드래그합니다.413작업 패널은 현재 세션 내에서 실행 중인 백그라운드 작업을 표시합니다: 서브에이전트, 백그라운드 셸 명령, [동적 워크플로](/docs/ko/workflows). **Views** 메뉴에서 열거나 레이아웃으로 드래그합니다.

414 414 

415모든 항목을 클릭하여 서브에이전트 패널에서 출력을 보거나 중지합니다. 다른 세션이 수행하는 작업을 보려면 [사이드바](#work-in-parallel-with-sessions)를 사용하거나 Claude에게 [당신을 대신해 확인하도록](#work-across-sessions) 요청합니다.415모든 항목을 클릭하여 서브에이전트 패널에서 출력을 보거나 중지합니다. 다른 세션이 수행하는 작업을 보려면 [사이드바](#work-in-parallel-with-sessions)를 사용하거나 Claude에게 [대신 확인하도록](#work-across-sessions) 요청합니다.

416 416 

417<h3 id="work-across-sessions">417<h3 id="work-across-sessions">

418 세션 간에 작업하기418 세션 간에 작업하기

420 420 

421Claude는 다른 Code 탭 세션을 나열하고, 각 세션이 수행한 작업을 읽고, 세션 간에 메시지를 보낼 수 있습니다. 일반 언어로 요청합니다: "어느 세션이 auth 리팩토링을 건드렸나?", "API 세션은 무엇을 결론지었나?", 또는 "payments 세션에 스키마가 변경되었다고 알려주세요". Claude에게 세션 이름을 바꾸거나 아카이브하도록 요청할 수도 있습니다. Claude는 사이드바의 아카이브 아이콘과 동일한 방식으로 세션을 아카이브하므로 PR이 병합된 세션을 정리하도록 요청합니다.421Claude는 다른 Code 탭 세션을 나열하고, 각 세션이 수행한 작업을 읽고, 세션 간에 메시지를 보낼 수 있습니다. 일반 언어로 요청합니다: "어느 세션이 auth 리팩토링을 건드렸나?", "API 세션은 무엇을 결론지었나?", 또는 "payments 세션에 스키마가 변경되었다고 알려주세요". Claude에게 세션 이름을 바꾸거나 아카이브하도록 요청할 수도 있습니다. Claude는 사이드바의 아카이브 아이콘과 동일한 방식으로 세션을 아카이브하므로 PR이 병합된 세션을 정리하도록 요청합니다.

422 422 

423이 표면을 통해 Claude는 데스크톱 앱이 자체적으로 실행하는 세션만 봅니다: 로컬, [SSH](#ssh-sessions), Code 탭의 [WSL](/docs/ko/desktop-wsl) 세션. Claude는 클라우드 세션이나 터미널 CLI 또는 VS Code 확장에서 시작한 세션을 보지 못합니다. 같은 프로젝트의 worktrees에 있더라도 9개의 터미널 worktrees가 열려 있고 2개의 데스크톱 세션이 있으면 Claude가 그 중 하나에서 답변할 때 다른 하나의 데스크톱 세션을 보고합니다. Claude는 요청하는 세션을 나열하지 않습니다. 기본적으로 가장 최근에 활성화된 20개 세션을 보고 아카이브된 세션을 건너뜁니다. 요청하지 않는 한 [교차 세션 메시징](/docs/ko/cross-session-messaging)은 Claude가 [다른 Claude Code 세션](/docs/ko/cross-session-messaging#see-which-sessions-claude-can-reach)에 메시지를 보낼 수 있게 하며, 터미널 세션도 포함합니다.423이 사용 환경을 통해 Claude는 데스크톱 앱이 자체적으로 실행하는 세션만 봅니다: Code 탭의 로컬, [SSH](#ssh-sessions), [WSL](/docs/ko/desktop-wsl) 세션. Claude는 클라우드 세션이나 터미널 CLI 또는 VS Code 확장에서 시작한 세션을 같은 프로젝트의 worktrees에 있더라도 보지 못합니다. 따라서 9개의 터미널 worktrees와 2개의 데스크톱 세션이 열려 있으면 그 중 한 데스크톱 세션에서 답변하는 Claude는 나머지 하나의 데스크톱 세션만 보고합니다. Claude는 요청하는 세션을 나열하지 않습니다. 기본적으로 가장 최근에 활성화된 20개 세션을 보며, 요청하지 않는 한 아카이브된 세션은 건너뜁니다. [교차 세션 메시징](/docs/ko/cross-session-messaging)은 이와 별도로 Claude가 터미널 세션을 포함한 [다른 Claude Code 세션](/docs/ko/cross-session-messaging#see-which-sessions-claude-can-reach)에 메시지를 보낼 수 있게 합니다.

424 424 

425Claude가 이 표면을 통해 다른 세션에 메시지를 보낼 때 Claude Code는 보내는 세션의 제목과 다시 링크된 카드로 표시하므로 항상 메시지가 어디서 왔는지 알 수 있습니다. 수신 세션이 작업 중이면 Claude Code는 메시지를 보류하고 Claude는 현재 작업이 완료되면 읽습니다. 수신 Claude는 회신할 수 있으며 Claude Code는 회신을 이 표면을 통해 다시 전달합니다. Claude는 아카이브된 세션에 전달할 수 없으며 메시지가 전달되지 않을 때 알려줍니다.425Claude가 이 사용 환경을 통해 다른 세션에 메시지를 보낼 때 Claude Code는 보내는 세션의 제목과 다시 돌아가는 링크가 표시된 카드로 보여 주므로 항상 메시지가 어디서 왔는지 알 수 있습니다. 수신 세션이 작업 중이면 Claude Code는 메시지를 보류하고 Claude는 현재 작업이 완료되면 읽습니다. 수신 Claude는 회신할 수 있으며 Claude Code는 회신을 이 사용 환경을 통해 다시 전달합니다. Claude는 아카이브된 세션에 전달할 수 없으며 메시지가 전달되지 않을 때 알려줍니다.

426 426 

427Claude Code는 세션 간에 4가지 안전 동작을 적용합니다:427Claude Code는 세션 간에 4가지 안전 동작을 적용합니다:

428 428 

429* 세션을 아카이브하기 전에 Claude는 먼저 요청합니다. Auto 및 Bypass 권한을 포함한 모든 권한 모드에서 승인 카드를 봅니다.429* 세션을 아카이브하기 전에 Claude는 먼저 묻습니다. Auto 및 Bypass 권한을 포함한 모든 권한 모드에서 승인 카드가 표시됩니다.

430* 이 표면을 통해 Claude는 예약된 작업 실행과 같이 아무도 보고 있지 않은 세션에서 교차 세션 메시지를 보낼 수 없으며 하나에 전달할 수 없습니다.430* 이 사용 환경을 통해 Claude는 예약 작업 실행과 같이 아무도 보고 있지 않은 세션에서 교차 세션 메시지를 보낼 수 없으며 그러한 세션으로 메시지를 전달할 수도 없습니다.

431* Claude Code는 수신 세션이 [교차 세션 메시징](/docs/ko/cross-session-messaging#availability)을 가지지 않더라도 이 표면의 각 메시지를 수신 세션의 [인바운드 컨트롤](/docs/ko/cross-session-messaging#control-inbound-messages)에 대해 확인합니다. 수신 세션에서 [`crossSessionInbound`](/docs/ko/settings-reference#crosssessioninbound)를 `refuse`로 설정하면 Claude Code는 이 표면의 메시지를 삭제합니다. Claude Code는 거부를 Claude 데스크톱 앱에 보고합니다. v2.1.234 이전에는 Claude Code가 교차 세션 메시징이 없는 수신 세션으로 이 표면의 모든 메시지를 삭제했습니다.431* Claude Code는 수신 세션 자체에 [교차 세션 메시징](/docs/ko/cross-session-messaging#availability)이 없더라도 이 사용 환경의 각 메시지를 수신 세션의 [인바운드 컨트롤](/docs/ko/cross-session-messaging#control-inbound-messages)에 대해 확인합니다. 수신 세션에서 [`crossSessionInbound`](/docs/ko/settings-reference#crosssessioninbound)를 `refuse`로 설정하면 Claude Code는 이 사용 환경의 메시지를 삭제합니다. Claude Code는 거부를 Claude 데스크톱 앱에 보고합니다. v2.1.234 이전에는 Claude Code가 교차 세션 메시징이 없는 수신 세션으로 가는 이 사용 환경의 모든 메시지를 삭제했습니다.

432* Claude Code는 각 수신 메시지를 인용하고 보낸 세션에 귀속시키며 Claude는 여전히 수신 세션의 자체 권한 설정을 따릅니다.432* Claude Code는 각 수신 메시지를 인용하고 보낸 세션에 귀속시키며, Claude는 메시지에 따라 행동할 때에도 여전히 수신 세션의 자체 권한 설정을 따릅니다.

433 433 

434Claude는 또한 새 세션을 제안할 수 있습니다. 현재 작업의 범위를 벗어나지만 수정할 가치가 있는 것을 발견하면 작업을 채팅의 작업 칩으로 제공합니다. 칩을 클릭하여 자신의 worktree를 가진 새 세션에서 해당 작업을 시작합니다. Claude는 현재 세션을 중단 없이 계속합니다.434Claude는 또한 새 세션을 제안할 수 있습니다. 현재 작업의 범위를 벗어나지만 수정할 가치가 있는 것을 발견하면 작업을 채팅의 작업 칩으로 제공합니다. 칩을 클릭하여 자신의 worktree를 가진 새 세션에서 해당 작업을 시작합니다. Claude는 현재 세션을 중단 없이 계속합니다.

435 435 

441 441 

442클라우드 세션은 또한 여러 저장소를 지원합니다. 클라우드 환경을 선택한 후 선택된 저장소 옆의 **+** 버튼을 클릭하여 세션에 추가 저장소를 추가합니다. 각 저장소는 자신의 브랜치 선택기를 가집니다. 이는 공유 라이브러리와 그 소비자를 업데이트하는 것과 같이 여러 코드베이스에 걸친 작업에 유용합니다.442클라우드 세션은 또한 여러 저장소를 지원합니다. 클라우드 환경을 선택한 후 선택된 저장소 옆의 **+** 버튼을 클릭하여 세션에 추가 저장소를 추가합니다. 각 저장소는 자신의 브랜치 선택기를 가집니다. 이는 공유 라이브러리와 그 소비자를 업데이트하는 것과 같이 여러 코드베이스에 걸친 작업에 유용합니다.

443 443 

444클라우드 세션이 작동하는 방식에 대한 자세한 내용은 [웹의 Claude Code](/docs/ko/claude-code-on-the-web)를 참조하세요. 한 가지 작업이 많은 클라우드 세션이 필요할 때 사이드바에서 **Projects**를 선택하여 [프로젝트](/docs/ko/claude-projects)를 만들고, Claude가 한 대화에서 세션을 시작하고 추적하도록 합니다.444클라우드 세션이 작동하는 방식에 대한 자세한 내용은 [클라우드에서 Claude Code 사용하기](/docs/ko/claude-code-on-the-web)를 참조하세요. 한 가지 작업이 많은 클라우드 세션이 필요할 때 사이드바에서 **Projects**를 선택하여 [프로젝트](/docs/ko/claude-projects)를 만들고, Claude가 한 대화에서 세션을 시작하고 추적하도록 합니다.

445 445 

446<h3 id="continue-in-another-surface">446<h3 id="continue-in-another-surface">

447 다른 표면에서 계속하기447 다른 사용 환경에서 계속하기

448</h3>448</h3>

449 449 

450세션 도구 모음의 오른쪽 아래에 있는 VS Code 아이콘에서 액세스할 수 있는 **Continue in** 메뉴를 사용하면 세션을 다른 표면으로 이동할 수 있습니다:450세션을 다른 곳에서 계속하려면 세션 제목 옆의 캐럿 또는 사이드바의 세션 행에서 세션 메뉴를 열고 **Open in**을 선택합니다:

451 451 

452* **Claude Code on the Web**: 로컬 세션을 클라우드에서 계속 실행하도록 보냅니다. Desktop은 브랜치를 푸시하고, 대화 요약을 생성하고, 전체 컨텍스트를 사용하여 새 클라우드 세션을 만듭니다. 그 후 로컬 세션을 아카이브하거나 유지하도록 선택할 수 있습니다. 이는 깨끗한 작업 트리가 필요하며 SSH 세션에는 사용할 수 없습니다.452* **Cloud**를 선택하면 대화가 요약으로 이어진 상태로 세션을 [클라우드 세션](/docs/ko/claude-code-on-the-web)으로 계속합니다. 확인하기 전에 대화 상자에 파일도 함께 이동하는지, 그리고 클라우드 세션이 준비되면 이 세션이 아카이브되는지가 표시됩니다. [SSH](#ssh-sessions)를 통해 실행되거나 [WSL](/docs/ko/desktop-wsl)에서 실행되는 세션은 이 방식으로 이동할 수 없습니다.

453* **Your IDE**: 현재 작업 디렉토리에서 지원되는 IDE에서 프로젝트를 엽니다.453* 설치된 편집기나 파일 관리자를 선택하면 디스크에 있는 세션의 폴더를 해당 앱에서 엽니다.

454 454 

455<h3 id="sessions-from-dispatch">455<h3 id="sessions-from-dispatch">

456 Dispatch에서 세션456 Dispatch에서 시작한 세션

457</h3>457</h3>

458 458 

459[Dispatch](https://support.claude.com/en/articles/13947068)는 [Cowork](https://claude.com/product/cowork) 탭에 있는 Claude와의 지속적인 대화입니다. Dispatch에 작업을 메시지하면 처리 방법을 결정합니다.459[Dispatch](https://support.claude.com/en/articles/13947068)는 [Cowork](https://claude.com/product/cowork) 탭에 있는 Claude와의 지속적인 대화입니다. Dispatch에 작업을 메시지하면 처리 방법을 결정합니다.

460 460 

461작업은 두 가지 방법으로 Code 세션이 될 수 있습니다: 직접 요청하는 경우 (예: "Claude Code 세션을 열고 로그인 버그를 수정하세요") 또는 Dispatch가 작업이 개발 작업이라고 결정하고 자동으로 하나를 생성하는 경우입니다. 일반적으로 Code로 라우팅되는 작업에는 버그 수정, 종속성 업데이트, 테스트 실행 또는 pull request 열기가 포함됩니다. 연구, 문서 편집, 스프레드시트 작업은 Cowork에 남아 있습니다.461작업은 두 가지 방법으로 Code 세션이 될 수 있습니다: 직접 요청하는 경우 (예: "Claude Code 세션을 열고 로그인 버그를 수정하세요") 또는 Dispatch가 작업이 개발 작업이라고 결정하고 자동으로 하나를 생성하는 경우입니다. 일반적으로 Code로 라우팅되는 작업에는 버그 수정, 의존성 업데이트, 테스트 실행 또는 풀 리퀘스트 열기가 포함됩니다. 연구, 문서 편집, 스프레드시트 작업은 Cowork에 남아 있습니다.

462 462 

463어느 쪽이든 Code 세션은 **Dispatch** 배지가 있는 Code 탭의 사이드바에 나타납니다. 완료되거나 승인이 필요할 때 휴대폰에서 푸시 알림을 받습니다.463어느 쪽이든 Code 세션은 **Dispatch** 배지가 있는 Code 탭의 사이드바에 나타납니다. 완료되거나 승인이 필요할 때 휴대폰에서 푸시 알림을 받습니다.

464 464 

465[컴퓨터 사용](#let-claude-use-your-computer)이 활성화되어 있으면 Dispatch 생성 Code 세션도 사용할 수 있습니다. 이러한 세션의 앱 승인은 30분 후 만료되고 다시 프롬프트하며, 일반 Code 세션처럼 전체 세션 동안 지속되지 않습니다.465[컴퓨터 사용](#let-claude-use-your-computer)이 활성화되어 있으면 Dispatch 생성 Code 세션도 사용할 수 있습니다. 이러한 세션의 앱 승인은 30분 후 만료되고 다시 확인을 요청하며, 일반 Code 세션처럼 전체 세션 동안 지속되지 않습니다.

466 466 

467설정, 페어링, Dispatch 설정은 [Dispatch 도움말 문서](https://support.claude.com/en/articles/13947068)를 참조하세요. Dispatch는 Pro 또는 Max 계획이 필요하며 Team 또는 Enterprise 계획에서는 사용할 수 없습니다.467설정, 페어링, Dispatch 설정은 [Dispatch 도움말 문서](https://support.claude.com/en/articles/13947068)를 참조하세요. Dispatch는 Pro 또는 Max 계획이 필요하며 Team 또는 Enterprise 계획에서는 사용할 수 없습니다.

468 468 

739 739 

740[Extended thinking](/docs/ko/model-config#extended-thinking)은 기본적으로 활성화되어 있으며, 복잡한 추론 작업의 성능을 향상시키지만 추가 토큰을 사용합니다. Anthropic API에서 생각을 비활성화하려면 로컬 환경 편집기에서 `MAX_THINKING_TOKENS`을 `0`으로 설정합니다. 이는 Opus 5.5, Sonnet 5.5 또는 Fable 모델에는 영향을 주지 않으며, 이들은 항상 extended thinking을 사용합니다. Anthropic API에서 생각을 비활성화한 상태에서 Claude Code는 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) Opus 5와 같은 모델에 더 높은 수준 대신 노력 `high`를 보냅니다.740[Extended thinking](/docs/ko/model-config#extended-thinking)은 기본적으로 활성화되어 있으며, 복잡한 추론 작업의 성능을 향상시키지만 추가 토큰을 사용합니다. Anthropic API에서 생각을 비활성화하려면 로컬 환경 편집기에서 `MAX_THINKING_TOKENS`을 `0`으로 설정합니다. 이는 Opus 5.5, Sonnet 5.5 또는 Fable 모델에는 영향을 주지 않으며, 이들은 항상 extended thinking을 사용합니다. Anthropic API에서 생각을 비활성화한 상태에서 Claude Code는 [해당 조합을 허용하지 않는](/docs/ko/errors#effort-isnt-available-with-thinking-turned-off) Opus 5와 같은 모델에 더 높은 수준 대신 노력 `high`를 보냅니다.

741 741 

742[적응형 추론](/docs/ko/model-config#adjust-effort-level)이 있는 모델에서는 적응형 추론이 생각 깊이를 제어하기 때문에 `0`이 아닌 `MAX_THINKING_TOKENS` 값은 무시됩니다. Opus 4.6 및 Sonnet 4.6에서는 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 `1`로 설정하여 고정 생각 예산을 사용합니다. Fable 모델, Sonnet 5 이상, Opus 4.7 이상은 항상 적응형 추론을 사용하며 고정 예산 모드가 없습니다.742[적응형 추론](/docs/ko/model-config#adjust-effort-level)이 있는 모델에서는 적응형 추론이 사고 깊이를 제어하기 때문에 Claude Code가 양수 `MAX_THINKING_TOKENS` 값의 숫자 자체를 무시합니다. Opus 4.6 및 Sonnet 4.6에서는 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 `1`로 설정하여 고정 사고 예산을 사용합니다. Fable 모델, Sonnet 5 이상, Opus 4.7 이상은 항상 적응형 추론을 사용하며 고정 예산 모드가 없습니다.

743 743 

744<h4 id="local-sessions-on-managed-devices">744<h4 id="local-sessions-on-managed-devices">

745 관리되는 디바이스의 로컬 세션745 관리되는 디바이스의 로컬 세션

135 135 

136**Claude를 일정에 따라 실행.** [예약된 작업](/docs/ko/desktop-scheduled-tasks)을 설정하여 Claude를 정기적으로 자동으로 실행합니다: 매일 아침 일일 코드 검토, 주간 종속성 감사 또는 연결된 도구에서 정보를 가져오는 브리핑입니다.136**Claude를 일정에 따라 실행.** [예약된 작업](/docs/ko/desktop-scheduled-tasks)을 설정하여 Claude를 정기적으로 자동으로 실행합니다: 매일 아침 일일 코드 검토, 주간 종속성 감사 또는 연결된 도구에서 정보를 가져오는 브리핑입니다.

137 137 

138**준비가 되면 확장.** 사이드바에서 [병렬 세션](/docs/ko/desktop#work-in-parallel-with-sessions)을 열어 여러 작업을 동시에 수행하고, 필요에 따라 각각 자체 Git worktree에서 실행하고, [작업 창](/docs/ko/desktop#watch-background-tasks)을 열어 세션이 실행 중인 서브에이전트 및 백그라운드 명령어를 봅니다. [사이드 채팅](/docs/ko/desktop#ask-a-side-question-without-derailing-the-session)을 열어 메인 스레드를 방해하지 않고 질문을 할 수 있습니다. [장기 실행 작업을 클라우드로 전송](/docs/ko/desktop#run-long-running-tasks-in-the-cloud)하여 앱을 닫아도 계속 실행되도록 하거나, 작업이 예상보다 오래 걸리면 [웹 또는 IDE에서 세션을 계속](/docs/ko/desktop#continue-in-another-surface)할 수 있습니다. [GitHub, Slack 및 Linear와 같은 외부 도구를 연결](/docs/ko/desktop#extend-claude-code)하여 워크플로우를 통합합니다.138**준비가 되면 확장.** 사이드바에서 [병렬 세션](/docs/ko/desktop#work-in-parallel-with-sessions)을 열어 여러 작업을 동시에 수행하고, 필요에 따라 각각 자체 Git worktree에서 실행하고, [작업 창](/docs/ko/desktop#watch-background-tasks)을 열어 세션이 실행 중인 서브에이전트 및 백그라운드 명령을 봅니다. [사이드 채팅](/docs/ko/desktop#ask-a-side-question-without-derailing-the-session)을 열어 메인 스레드를 방해하지 않고 질문을 할 수 있습니다. [장기 실행 작업을 클라우드로 전송](/docs/ko/desktop#run-long-running-tasks-in-the-cloud)하여 앱을 닫아도 계속 실행되도록 하거나, 작업이 예상보다 오래 걸리면 [이미 시작한 세션을 클라우드로 이동](/docs/ko/desktop#continue-in-another-surface)할 수 있습니다. [GitHub, Slack 및 Linear와 같은 외부 도구를 연결](/docs/ko/desktop#extend-claude-code)하여 워크플로를 통합합니다.

139 139 

140<h2 id="what’s-next">140<h2 id="what’s-next">

141 다음 단계141 다음 단계

124 변수124 변수

125</h2>125</h2>

126 126 

127타임아웃, 토큰 예산, 재시도 횟수와 같은 숫자 변수는 일반 숫자 외에도 과학적 표기법과 자릿수 구분자 표기를 허용합니다. 단, 해당 변수의 행에 일반 숫자만 허용한다고 명시된 경우는 예외입니다. 예를 들어 Claude Code는 `2e3`을 2000으로, `64_000`을 64000으로 읽습니다. v2.1.211 이전에는 이러한 표기가 경고 없이 훨씬 작은 값으로 설정될 수 있었습니다. 예를 들어 `1e6`은 타임아웃을 1로 설정했습니다.127타임아웃, 토큰 예산, 재시도 횟수 같은 숫자 변수는 일반 숫자 외에도 과학적 표기법과 자릿수 구분자 표기를 허용합니다. 단, 변수의 행에 일반 숫자만 허용한다고 명시된 경우는 예외입니다. 예를 들어 Claude Code는 `2e3`을 2000으로, `64_000`을 64000으로 읽습니다. v2.1.211 이전에는 이러한 표기가 경고 없이 훨씬 작은 값을 설정할 수 있었습니다. 예를 들어 `1e6`은 타임아웃을 1로 설정했습니다.

128 128 

129<Note>129<Note>

130 동작을 켜거나 끄는 변수의 경우, 대소문자에 관계없이 `1`, `true`, `yes`, `on`으로 설정하면 켜지고 `0`, `false`, `no`, `off`로 설정하면 꺼집니다.130 동작을 켜거나 끄는 변수의 경우, 대소문자와 관계없이 `1`, `true`, `yes`, `on`으로 설정하면 켜지고 `0`, `false`, `no`, `off`로 설정하면 꺼집니다.

131 131 

132 일부 변수는 설정 여부만 확인하므로 `0`을 포함해 비어 있지 않은 모든 값이 해당 동작을 켜며, 동작을 끄려면 변수를 설정 해제하거나 빈 값으로 설정해야 합니다. 다음 변수가 이러한 방식으로 동작합니다.132 일부 변수는 설정 여부만 확인하므로 `0`을 포함한 비어 있지 않은 모든 값이 동작을 켜며, 동작을 끄려면 변수를 설정 해제하거나 빈 값으로 설정해야 합니다. 다음 변수가 이런 방식으로 작동합니다.

133 133 

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`

138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`138 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

139 * `IS_DEMO`139 * `IS_DEMO`

140 140 

141 다른 한 변수는 고유한 규칙을 따릅니다. `FORCE_HYPERLINK`는 숫자를 읽으므로 `0`만 해당 동작을 끕니다. 각 변수의 행에도 해당 변수의 규칙이 명시되어 있습니다.141 다른 변수 하나는 자체 규칙을 따릅니다. `FORCE_HYPERLINK`는 숫자를 읽으므로 `0`만 이 기능을 끕니다. 각 변수의 행에도 해당 변수의 규칙이 명시되어 있습니다.

142</Note>142</Note>

143 143 

144| 변수 | 용도 |144| 변수 | 용도 |

145| :- | :- |145| :- | :- |

146| `ANTHROPIC_API_KEY` | `X-Api-Key` 헤더로 전송되는 API 키입니다. 설정되면 로그인한 상태라도 Claude Pro, Max, Team 또는 Enterprise 구독 대신 이 키가 사용됩니다. 비대화형 모드(`-p`)에서는 키가 있으면 항상 사용됩니다. 대화형 모드에서는 키가 구독을 재정의하기 전에 한 번 승인하라는 확인을 요청합니다. 구독을 대신 사용하려면 `unset ANTHROPIC_API_KEY`를 실행하십시오 |146| `ANTHROPIC_API_KEY` | `X-Api-Key` 헤더로 전송되는 API 키입니다. 설정하면 로그인한 상태이더라도 Claude Pro, Max, Team 또는 Enterprise 구독 대신 이 키가 사용됩니다. 비대화형 모드(`-p`)에서는 키가 있으면 항상 사용됩니다. 대화형 모드에서는 키가 구독을 재정의하기 전에 한 번 승인하도록 확인을 요청합니다. 구독을 대신 사용하려면 `unset ANTHROPIC_API_KEY`를 실행합니다 |

147| `ANTHROPIC_AUTH_TOKEN` | `Authorization` 헤더의 사용자 지정 값입니다(여기에 설정한 값 앞에 `Bearer `가 붙습니다) |147| `ANTHROPIC_AUTH_TOKEN` | `Authorization` 헤더의 사용자 지정 값입니다(여기에 설정한 값 앞에 `Bearer `가 붙습니다) |

148| `ANTHROPIC_AWS_API_KEY` | AWS Console에서 생성한 [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)용 워크스페이스 API 키입니다. `x-api-key`로 전송되며 AWS SigV4보다 우선합니다 |148| `ANTHROPIC_AWS_API_KEY` | AWS Console에서 생성한 [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)용 워크스페이스 API 키입니다. `x-api-key`로 전송되며 AWS SigV4보다 우선합니다 |

149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 엔드포인트 URL을 재정의합니다. 사용자 지정 리전에서 사용하거나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. 기본값은 `https://aws-external-anthropic.{region}.api.aws`입니다. Claude Code는 [Amazon Bedrock과 동일한 우선순위](/docs/ko/amazon-bedrock#3-configure-claude-code)로 리전을 결정합니다 |149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws) 엔드포인트 URL을 재정의합니다. 사용자 지정 리전을 사용하거나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. 기본값은 `https://aws-external-anthropic.{region}.api.aws`입니다. Claude Code는 [Amazon Bedrock과 동일한 우선순위](/docs/ko/amazon-bedrock#3-configure-claude-code)로 리전을 결정합니다 |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)에 필수입니다. 모든 요청에 `anthropic-workspace-id` 헤더로 전송됩니다 |150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ko/claude-platform-on-aws)에 필요합니다. 모든 요청에 `anthropic-workspace-id` 헤더로 전송됩니다 |

151| `ANTHROPIC_BASE_URL` | 프록시나 게이트웨이를 통해 요청을 라우팅하도록 API 엔드포인트를 재정의합니다. 퍼스트 파티가 아닌 호스트로 설정하면 [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)이 기본적으로 비활성화됩니다. 프록시가 `tool_reference` 블록을 전달하는 경우 `ENABLE_TOOL_SEARCH=true`를 설정하십시오. v2.1.196부터는 이 값이 `api.anthropic.com` 이외의 호스트를 가리키면 [Remote Control](/docs/ko/remote-control#requirements)이 비활성화되며, 이는 Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에서의 동작과 동일합니다 |151| `ANTHROPIC_BASE_URL` | 프록시나 게이트웨이를 통해 요청을 라우팅하도록 API 엔드포인트를 재정의합니다. 퍼스트 파티가 아닌 호스트로 설정하면 [MCP 도구 검색](/docs/ko/mcp#scale-with-mcp-tool-search)이 기본적으로 비활성화됩니다. 프록시가 `tool_reference` 블록을 전달하는 경우 `ENABLE_TOOL_SEARCH=true`를 설정합니다. v2.1.196부터는 이 값이 `api.anthropic.com` 이외의 호스트를 가리키면 [Remote Control](/docs/ko/remote-control#requirements)이 비활성화되며, 이는 Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에서의 동작과 동일합니다 |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock 엔드포인트 URL을 재정의합니다. 사용자 지정 Amazon Bedrock 엔드포인트에 사용하거나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock)을 참조하십시오 |152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock 엔드포인트 URL을 재정의합니다. 사용자 지정 Amazon Bedrock 엔드포인트를 사용하거나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock)을 참조하세요 |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle 엔드포인트 URL을 재정의합니다. [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint)를 참조하십시오 |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle 엔드포인트 URL을 재정의합니다. [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint)를 참조하세요 |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Claude Code가 AWS 리전에서 파생된 접두사 대신 먼저 시도하는 교차 리전 추론 프로필 접두사(`us`, `eu`, `apac`, `jp`, `au` 또는 `global`)입니다. AWS GovCloud 리전에서는 무시됩니다. Claude Code v2.1.224 이상이 필요합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#cross-region-inference-profile-prefixes)을 참조하십시오 |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Claude Code가 AWS 리전에서 파생된 접두사 대신 먼저 시도하는 리전 간 추론 프로필 접두사(`us`, `eu`, `apac`, `jp`, `au` 또는 `global`)입니다. AWS GovCloud 리전에서는 무시됩니다. Claude Code v2.1.224 이상이 필요합니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#cross-region-inference-profile-prefixes)을 참조하세요 |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [서비스 티어](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)(`default`, `flex` 또는 `priority`)입니다. `X-Amzn-Bedrock-Service-Tier` 헤더로 전송됩니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#service-tiers)을 참조하십시오 |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [서비스 티어](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)(`default`, `flex` 또는 `priority`)입니다. `X-Amzn-Bedrock-Service-Tier` 헤더로 전송됩니다. [Amazon Bedrock](/docs/ko/amazon-bedrock#service-tiers)을 참조하세요 |

156| `ANTHROPIC_BETAS` | API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 필요한 베타 헤더를 이미 전송합니다. Claude Code가 기본 지원을 추가하기 전에 [Anthropic API 베타](https://platform.claude.com/docs/en/api/beta-headers)를 사용하려면 이 변수를 사용하십시오. API 키 인증이 필요한 [`--betas` 플래그](/docs/ko/cli-reference#cli-flags)와 달리, 이 변수는 Claude.ai 구독을 포함한 모든 인증 방식에서 작동합니다 |156| `ANTHROPIC_BETAS` | API 요청에 포함할 추가 `anthropic-beta` 헤더 값의 쉼표로 구분된 목록입니다. Claude Code는 필요한 베타 헤더를 이미 전송합니다. Claude Code가 기본 지원을 추가하기 전에 [Anthropic API 베타](https://platform.claude.com/docs/en/api/beta-headers)를 사용하려면 이 변수를 사용합니다. API 키 인증이 필요한 [`--betas` 플래그](/docs/ko/cli-reference#cli-flags)와 달리, 이 변수는 Claude.ai 구독을 포함한 모든 인증 방법에서 작동합니다 |

157| `ANTHROPIC_CUSTOM_HEADERS` | 요청에 추가할 사용자 지정 헤더입니다(`Name: Value` 형식, 여러 헤더는 줄바꿈으로 구분). 이름이나 값에 둥근 따옴표나 폭이 없는 공백처럼 HTTP 헤더가 담을 수 없는 문자가 포함되면, 요청은 해당 쌍을 위치로 식별하는 오류와 함께 실패합니다. Claude Code v2.1.227 이상이 필요합니다. [Invalid request header value](/docs/ko/errors#invalid-request-header-value)에 정확한 문자 집합과 검사가 실행되는 위치가 나와 있습니다. `Authorization`이나 `Host`처럼 자격 증명, 조직 또는 테넌트, 라우팅, API 동작 헤더를 설정하는 값은 서버 관리형 설정이 이를 전달할 때 [승인이 필요한 설정](/docs/ko/server-managed-settings#environment-variables-and-the-approval-dialog)으로 간주됩니다. 프로젝트 또는 로컬 설정에서 전달된 이러한 값은 [`env` 값이 적용되는 시점에 대한 규칙](/docs/ko/settings-reference#when-claude-code-applies-env-values)을 따릅니다 |157| `ANTHROPIC_CUSTOM_HEADERS` | 요청에 추가할 사용자 지정 헤더입니다(`Name: Value` 형식, 여러 헤더는 줄바꿈으로 구분). 이름이나 값에 둥근 따옴표나 폭 없는 공백처럼 HTTP 헤더가 담을 수 없는 문자가 포함되어 있으면, 요청은 해당 쌍을 위치로 식별하는 오류와 함께 실패합니다. Claude Code v2.1.227 이상이 필요합니다. [Invalid request header value](/docs/ko/errors#invalid-request-header-value)에 정확한 문자 집합과 검사가 실행되는 위치가 나와 있습니다. `Authorization`이나 `Host`처럼 자격 증명, 조직 또는 테넌트, 라우팅, API 동작 헤더를 설정하는 값은 서버 관리 설정이 전달할 때 [승인이 필요한 설정](/docs/ko/server-managed-settings#environment-variables-and-the-approval-dialog)으로 간주됩니다. 프로젝트 또는 로컬 설정에서 전달되는 경우 이러한 값은 [`env` 값이 적용되는 시점에 대한 규칙](/docs/ko/settings-reference#when-claude-code-applies-env-values)을 따릅니다 |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` 선택기에 사용자 지정 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 모델이나 게이트웨이 전용 모델을 선택 가능하게 하려면 이 변수를 사용하십시오. [모델 구성](/docs/ko/model-config#add-a-custom-model-option)을 참조하십시오 |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` 선택기에 사용자 지정 항목으로 추가할 모델 ID입니다. 기본 제공 별칭을 대체하지 않고 비표준 모델이나 게이트웨이 전용 모델을 선택할 수 있게 하려면 이 변수를 사용합니다. [모델 구성](/docs/ko/model-config#add-a-custom-model-option)을 참조하세요 |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 선택기에서 사용자 지정 모델 항목에 표시되는 설명입니다. 설정하지 않으면 기본값은 `Custom model (<model-id>)`입니다 |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` 선택기의 사용자 지정 모델 항목에 표시되는 설명입니다. 설정하지 않으면 기본값은 `Custom model (<model-id>)`입니다 |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 선택기에서 사용자 지정 모델 항목에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 [ID를 인식하는](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 경우 모델 이름을, 그렇지 않으면 모델 ID를 표시합니다 |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` 선택기의 사용자 지정 모델 항목에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 [ID를 인식하는](/docs/ko/model-config#customize-pinned-model-display-and-capabilities) 경우 모델 이름이, 그렇지 않으면 모델 ID가 표시됩니다 |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 사용자 지정 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | 사용자 지정 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` 별칭이 가리키는 모델 ID이자, 서드파티 제공업체에서 [자동 모델 폴백](/docs/ko/model-config#automatic-model-fallback)을 위해 Claude Code가 Fable 모델로 인식하는 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하십시오 |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` 별칭이 가리키는 모델 ID이자, 서드 파티 제공업체에서 [자동 모델 폴백](/docs/ko/model-config#automatic-model-fallback)을 위해 Claude Code가 Fable 모델로 인식하는 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Fable 모델에 표시되는 설명입니다. 설정하지 않으면 `Custom Fable model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Fable 모델에 표시되는 설명입니다. 설정하지 않으면 해당 행에 `Custom Fable model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` 선택기에서 고정된 Fable 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름을, 그렇지 않으면 고정된 ID를 표시합니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` 선택기에서 고정된 Fable 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름이, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Fable 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Fable 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` 별칭이 가리키는 모델 ID로, [백그라운드 기능](/docs/ko/costs#background-token-usage)에도 사용됩니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하십시오 |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` 별칭이 가리키는 모델 ID이며, [백그라운드 기능](/docs/ko/costs#background-token-usage)에도 사용됩니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Haiku 모델에 표시되는 설명입니다. 설정하지 않으면 `Custom Haiku model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Haiku 모델에 표시되는 설명입니다. 설정하지 않으면 해당 행에 `Custom Haiku model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` 선택기에서 고정된 Haiku 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름을, 그렇지 않으면 고정된 ID를 표시합니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` 선택기에서 고정된 Haiku 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름이, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Haiku 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Haiku 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

170| `ANTHROPIC_DEFAULT_MODEL` | 새 세션이 기본적으로 시작하는 모델입니다. Claude Code v2.1.236 이상이 필요합니다. [새 세션의 기본 모델 설정](/docs/ko/model-config#set-a-default-model-for-new-sessions)을 참조하십시오 |170| `ANTHROPIC_DEFAULT_MODEL` | 새 세션이 기본적으로 시작되는 모델입니다. Claude Code v2.1.236 이상이 필요합니다. [새 세션의 기본 모델 설정](/docs/ko/model-config#set-a-default-model-for-new-sessions)을 참조하세요 |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` 별칭이 가리키는 모델 ID이자, 플랜 모드가 활성화된 동안 `opusplan`이 사용하는 모델 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하십시오 |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` 별칭이 가리키는 모델 ID이자, 플랜 모드가 활성화된 동안 `opusplan`이 사용하는 모델 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Opus 모델에 표시되는 설명입니다. 설정하지 않으면 `Custom Opus model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Opus 모델에 표시되는 설명입니다. 설정하지 않으면 해당 행에 `Custom Opus model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` 선택기에서 고정된 Opus 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름을, 그렇지 않으면 고정된 ID를 표시합니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` 선택기에서 고정된 Opus 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름이, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Opus 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Opus 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` 별칭이 가리키는 모델 ID이자, 플랜 모드가 활성화되지 않았을 때 `opusplan`이 사용하는 모델 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하십시오 |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` 별칭이 가리키는 모델 ID이자, 플랜 모드가 활성화되지 않았을 때 `opusplan`이 사용하는 모델 ID입니다. [모델 구성](/docs/ko/model-config#environment-variables)을 참조하세요 |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Sonnet 모델에 표시되는 설명입니다. 설정하지 않으면 `Custom Sonnet model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` 선택기에서 고정된 Sonnet 모델에 표시되는 설명입니다. 설정하지 않으면 해당 행에 `Custom Sonnet model`로 시작하는 기본 설명이 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` 선택기에서 고정된 Sonnet 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름을, 그렇지 않으면 고정된 ID를 표시합니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` 선택기에서 고정된 Sonnet 모델에 표시되는 이름입니다. 설정하지 않으면 Claude Code가 고정된 ID를 인식하는 경우 모델 이름이, 그렇지 않으면 고정된 ID가 표시됩니다. [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Sonnet 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하십시오 |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | 고정된 Sonnet 모델이 지원하는 [기능](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)의 쉼표로 구분된 목록입니다(예: `effort,thinking`). [모델 구성](/docs/ko/model-config#customize-pinned-model-display-and-capabilities)을 참조하세요 |

179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)의 페더레이션 규칙 ID입니다. `ANTHROPIC_ORGANIZATION_ID`와 함께 설정하면 Claude Code는 페더레이션 자격 증명을 선택하며, 이는 `/login` 자격 증명보다 우선순위가 높습니다. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하십시오 |179| `ANTHROPIC_FEDERATION_RULE_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)의 페더레이션 규칙 ID입니다. `ANTHROPIC_ORGANIZATION_ID`와 함께 설정하면 Claude Code는 페더레이션 자격 증명을 선택하며, 이 자격 증명은 `/login` 자격 증명보다 우선순위가 높습니다. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하세요 |

180| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 인증용 API 키입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |180| `ANTHROPIC_FOUNDRY_API_KEY` | Microsoft Foundry 인증용 API 키입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Entra 액세스 토큰과 같은 Microsoft Foundry 인증용 Bearer 토큰입니다. Claude Code는 이를 `Authorization: Bearer` 헤더로 전송합니다. `ANTHROPIC_FOUNDRY_API_KEY` 및 Azure 기본 자격 증명 체인보다 우선합니다. [Microsoft Foundry](/docs/ko/microsoft-foundry)를 참조하십시오. Claude Code v2.1.203 이상이 필요합니다 |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Entra 액세스 토큰 같은 Microsoft Foundry 인증용 Bearer 토큰입니다. Claude Code는 이를 `Authorization: Bearer` 헤더로 전송합니다. `ANTHROPIC_FOUNDRY_API_KEY` 및 Azure 기본 자격 증명 체인보다 우선합니다. [Microsoft Foundry](/docs/ko/microsoft-foundry)를 참조하세요. Claude Code v2.1.203 이상이 필요합니다 |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 리소스의 전체 기본 URL입니다(예: `https://my-resource.services.ai.azure.com/anthropic`). `ANTHROPIC_FOUNDRY_RESOURCE`의 대안입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry 리소스의 전체 기본 URL입니다(예: `https://my-resource.services.ai.azure.com/anthropic`). `ANTHROPIC_FOUNDRY_RESOURCE`의 대안입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 리소스 이름입니다(예: `my-resource`). Claude Code는 [URL이나 호스트 이름을 거부합니다](/docs/ko/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). `ANTHROPIC_FOUNDRY_BASE_URL`이 설정되지 않은 경우 필수입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry 리소스 이름입니다(예: `my-resource`). Claude Code는 [URL이나 호스트 이름을 거부합니다](/docs/ko/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). `ANTHROPIC_FOUNDRY_BASE_URL`이 설정되지 않은 경우 필수입니다([Microsoft Foundry](/docs/ko/microsoft-foundry) 참조) |

184| `ANTHROPIC_MODEL` | 사용할 모델 설정의 이름입니다([모델 구성](/docs/ko/model-config#environment-variables) 참조) |184| `ANTHROPIC_MODEL` | 사용할 모델 설정의 이름입니다([모델 구성](/docs/ko/model-config#environment-variables) 참조) |

185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)의 조직 ID입니다. `ANTHROPIC_FEDERATION_RULE_ID`와 함께 설정하십시오. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하십시오 |185| `ANTHROPIC_ORGANIZATION_ID` | [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)의 조직 ID입니다. `ANTHROPIC_FEDERATION_RULE_ID`와 함께 설정합니다. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하세요 |

186| `ANTHROPIC_PROFILE` | 인증에 사용할 Anthropic 프로필의 이름입니다. 예를 들어 [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication)으로 생성했거나 [API 키 없이 Console 계정에 로그인](/docs/ko/authentication#sign-in-without-an-api-key)하여 생성한 프로필이 있습니다. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하십시오 |186| `ANTHROPIC_PROFILE` | 인증에 사용할 Anthropic 프로필의 이름입니다. 예를 들어 [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication)으로 생성했거나 [API 키 없이 Console 계정에 로그인](/docs/ko/authentication#sign-in-without-an-api-key)하여 생성한 프로필입니다. [인증 우선순위](/docs/ko/authentication#authentication-precedence)를 참조하세요 |

187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] [백그라운드 작업용 Haiku급 모델](/docs/ko/costs)의 이름입니다 |187| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATED] [백그라운드 작업용 Haiku급 모델](/docs/ko/costs)의 이름입니다 |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock 또는 Amazon Bedrock Mantle을 사용할 때 Haiku급 모델의 AWS 리전을 재정의합니다. Amazon Bedrock에서는 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 또는 deprecated된 `ANTHROPIC_SMALL_FAST_MODEL`도 설정된 경우에만 적용됩니다. 그렇지 않으면 Amazon Bedrock은 세션 리전에서 [기본 Sonnet 모델 또는 기본 모델](/docs/ko/amazon-bedrock#4-pin-model-versions)로 백그라운드 작업을 실행하기 때문입니다 |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock 또는 Amazon Bedrock Mantle을 사용할 때 Haiku급 모델의 AWS 리전을 재정의합니다. Amazon Bedrock에서는 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 또는 deprecated된 `ANTHROPIC_SMALL_FAST_MODEL`도 설정된 경우에만 적용됩니다. 그렇지 않으면 Amazon Bedrock은 세션 리전에서 [기본 Sonnet 모델 또는 주 모델](/docs/ko/amazon-bedrock#4-pin-model-versions)로 백그라운드 작업을 실행하기 때문입니다 |

189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud's Agent Platform 엔드포인트 URL을 재정의합니다. 사용자 지정 Google Cloud's Agent Platform 엔드포인트에 사용하거나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai)을 참조하십시오 |189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud's Agent Platform 엔드포인트 URL을 재정의합니다. 사용자 지정 Google Cloud's Agent Platform 엔드포인트를 사용하거나 [LLM 게이트웨이](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다. [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai)을 참조하세요 |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform 요청이 전송되는 GCP 프로젝트 ID입니다. [GCP 자격 증명 구성](/docs/ko/google-vertex-ai#3-configure-gcp-credentials)을 참조하십시오 |190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud's Agent Platform 요청이 전달되는 GCP 프로젝트 ID입니다. [GCP 자격 증명 구성](/docs/ko/google-vertex-ai#3-configure-gcp-credentials)을 참조하세요 |

191| `ANTHROPIC_WORKSPACE_ID` | [워크로드 아이덴티티 페더레이션](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)용 워크스페이스 ID입니다. 페더레이션 규칙의 범위가 둘 이상의 워크스페이스인 경우, 토큰 교환 시 대상 워크스페이스를 알 수 있도록 이 값을 설정하십시오 |191| `ANTHROPIC_WORKSPACE_ID` | [워크로드 ID 페더레이션](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation)의 워크스페이스 ID입니다. 페더레이션 규칙의 범위가 둘 이상의 워크스페이스인 경우, 토큰 교환이 대상 워크스페이스를 알 수 있도록 이 값을 설정합니다 |

192| `API_FORCE_IDLE_TIMEOUT` | 바이트가 도착하지 않을 때 스트리밍 모델 응답을 중단하는 5분 본문 유휴 타임아웃을 재정의합니다. 예를 들어 느린 [게이트웨이](/docs/ko/llm-gateway)나 로컬 모델이 청크 사이에 5분 넘게 멈추는 경우 `0`으로 설정하여 타임아웃을 끄거나, `1`로 설정하여 모든 제공업체에서 타임아웃을 켜 둘 수 있습니다. 설정하지 않으면 직접 Anthropic API, [Claude Platform on AWS](/docs/ko/claude-platform-on-aws), `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`이 설정된 Amazon Bedrock을 제외한 제공업체에서 타임아웃이 활성화됩니다. [스트림 워치독](/docs/ko/network-config#streaming-idle-watchdogs)은 이와 독립적으로 실행되며, 여기서 `0`으로 설정하더라도 오래 지속되는 무응답 상태를 중단합니다 |192| `API_FORCE_IDLE_TIMEOUT` | 바이트가 도착하지 않을 때 스트리밍 모델 응답을 중단하는 5분 본문 유휴 타임아웃을 재정의합니다. 느린 [게이트웨이](/docs/ko/llm-gateway)나 로컬 모델이 청크 사이에 5분 넘게 멈추는 경우처럼 타임아웃을 끄려면 `0`으로 설정하고, 모든 제공업체에서 켜 두려면 `1`로 설정합니다. 설정하지 않으면 직접 Anthropic API, [Claude Platform on AWS](/docs/ko/claude-platform-on-aws), 그리고 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`이 설정된 Amazon Bedrock을 제외한 제공업체에서 타임아웃이 활성화됩니다. [스트림 워치독](/docs/ko/network-config#streaming-idle-watchdogs)은 이와 독립적으로 실행되며, 여기서 `0`을 설정하더라도 길게 이어지는 무응답 일시 정지를 중단합니다 |

193| `API_TIMEOUT_MS` | API 요청의 타임아웃(밀리초)입니다(기본값: 600000, 즉 10분, 최댓값: 2147483647). 느린 네트워크에서 요청이 시간 초과되거나 프록시를 통해 라우팅할 때 이 값을 늘리십시오. 최댓값을 초과하는 값은 내부 타이머를 오버플로시켜 요청이 즉시 실패하게 만듭니다 |193| `API_TIMEOUT_MS` | API 요청의 타임아웃(밀리초)입니다(기본값: 600000, 즉 10분; 최대값: 2147483647). 느린 네트워크에서 요청이 시간 초과되거나 프록시를 통해 라우팅할 때 이 값을 늘립니다. 최대값을 초과하는 값은 기본 타이머를 오버플로시켜 요청이 즉시 실패하게 만듭니다 |

194| `AWS_BEARER_TOKEN_BEDROCK` | 인증용 Amazon Bedrock API 키입니다([Amazon Bedrock API 키](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) 참조) |194| `AWS_BEARER_TOKEN_BEDROCK` | 인증용 Amazon Bedrock API 키입니다([Amazon Bedrock API 키](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) 참조) |

195| `BASH_DEFAULT_TIMEOUT_MS` | 포그라운드 Bash 또는 PowerShell 도구 명령의 기본 타임아웃(밀리초)입니다(기본값: 120000, 즉 2분). 30분보다 긴 기본값은 무인 세션에서 [백그라운드 명령의 시간 제한](/docs/ko/tools-reference#time-limit-for-background-commands) 기본값으로도 사용됩니다. 백그라운드 시간 제한에는 Claude Code v2.1.285 이상이 필요합니다 |195| `BASH_DEFAULT_TIMEOUT_MS` | 포그라운드 Bash 또는 PowerShell 도구 명령의 기본 타임아웃(밀리초)입니다(기본값: 120000, 즉 2분). 기본값이 30분보다 길면 무인 세션에서 [백그라운드 명령의 시간 제한](/docs/ko/tools-reference#time-limit-for-background-commands) 기본값으로도 사용됩니다. 백그라운드 시간 제한에는 Claude Code v2.1.285 이상이 필요합니다 |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code가 명령 결과로 다시 읽어 들이는 bash 출력의 최대 문자 수입니다(기본값: 30000, 최댓값: 150000). [`bashOutputMaxChars`](/docs/ko/settings-reference#bashoutputmaxchars) 설정을 지정하면 Claude Code는 이 변수를 무시합니다. [출력 제한](/docs/ko/tools-reference#output-limits)을 참조하십시오 |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code가 명령 결과로 다시 읽어 들이는 bash 출력의 최대 문자 수입니다(기본값: 30000; 최대값: 150000). [`bashOutputMaxChars`](/docs/ko/settings-reference#bashoutputmaxchars) 설정을 지정하면 Claude Code는 이 변수를 무시합니다. [출력 제한](/docs/ko/tools-reference#output-limits)을 참조하세요 |

197| `BASH_MAX_TIMEOUT_MS` | 모델이 포그라운드 Bash 또는 PowerShell 도구 명령에 설정할 수 있는 최대 타임아웃(밀리초)입니다(기본값: 600000, 즉 10분). 실제 상한은 이 값과 `BASH_DEFAULT_TIMEOUT_MS` 중 더 큰 값입니다. 2시간보다 긴 실제 상한은 무인 세션에서 [백그라운드 명령의 시간 제한](/docs/ko/tools-reference#time-limit-for-background-commands) 최댓값으로도 사용됩니다. 백그라운드 시간 제한에는 Claude Code v2.1.285 이상이 필요합니다 |197| `BASH_MAX_TIMEOUT_MS` | 모델이 포그라운드 Bash 또는 PowerShell 도구 명령에 설정할 수 있는 최대 타임아웃(밀리초)입니다(기본값: 600000, 즉 10분). 실제 상한은 이 값과 `BASH_DEFAULT_TIMEOUT_MS` 중 큰 값입니다. 실제 상한이 2시간보다 길면 무인 세션에서 [백그라운드 명령의 시간 제한](/docs/ko/tools-reference#time-limit-for-background-commands) 최대값으로도 사용됩니다. 백그라운드 시간 제한에는 Claude Code v2.1.285 이상이 필요합니다 |

198| `BETA_TRACING_ENDPOINT` | [상세 베타 트레이싱](/docs/ko/monitoring-usage#traces-beta)용 OTLP 엔드포인트입니다. `ENABLE_BETA_TRACING_DETAILED=1`과 함께 사용하면 로그와 트레이스가 구성된 익스포터 대신 이 엔드포인트로 전송됩니다. 셸, 사용자 설정 또는 관리형 설정에서 설정하십시오. [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다 |198| `BETA_TRACING_ENDPOINT` | [상세 베타 트레이싱](/docs/ko/monitoring-usage#traces-beta)용 OTLP 엔드포인트입니다. `ENABLE_BETA_TRACING_DETAILED=1`과 함께 사용하면 로그와 트레이스가 구성된 내보내기 도구 대신 이 엔드포인트로 전송됩니다. 셸, 사용자 설정 또는 관리형 설정에서 설정합니다. [프로젝트 및 로컬 설정](/docs/ko/settings-reference#variables-claude-code-ignores-in-env)에서는 무시됩니다 |

199| `CCR_FORCE_BUNDLE` | `1`로 설정하면 [`claude --cloud`](/docs/ko/claude-code-on-the-web#send-local-repositories-without-github)가 원격에서 복제하는 대신 로컬 저장소를 번들로 묶어 업로드하도록 강제합니다 |199| `CCR_FORCE_BUNDLE` | `1`로 설정하면 [`claude --cloud`](/docs/ko/claude-code-on-the-web#send-local-repositories-without-github)가 원격에서 클론하는 대신 로컬 저장소를 번들로 묶어 업로드하도록 강제합니다 |

200| `CLAUDECODE` | Claude Code가 생성하는 하위 프로세스(Bash 및 PowerShell 도구, tmux 세션, [훅](/docs/ko/hooks) 명령, [상태줄](/docs/ko/statusline) 명령, stdio [MCP 서버](/docs/ko/mcp) 하위 프로세스)에서 `1`로 설정됩니다. IDE 확장 프로그램도 통합 터미널에서 이 값을 설정합니다. 스크립트가 Claude Code가 생성한 하위 프로세스 내에서 실행 중인지 감지하는 데 사용합니다. Claude Code가 시작한 stdio MCP 서버 내부가 아니라 도구 호출이나 훅에 의해 현재 프로세스가 직접 생성되었는지 확인하려면 대신 `CLAUDE_CODE_CHILD_SESSION`을 사용하십시오 |200| `CLAUDECODE` | Claude Code가 생성하는 하위 프로세스(Bash 및 PowerShell 도구, tmux 세션, [훅](/docs/ko/hooks) 명령, [상태줄](/docs/ko/statusline) 명령, stdio [MCP 서버](/docs/ko/mcp) 하위 프로세스)에서 `1`로 설정됩니다. IDE 확장 프로그램도 통합 터미널에서 이 변수를 설정합니다. 스크립트가 Claude Code가 생성한 하위 프로세스 내에서 실행 중인지 감지하는 데 사용합니다. 현재 프로세스가 Claude Code가 시작한 stdio MCP 서버 내부가 아니라 도구 호출이나 훅에 의해 직접 생성되었는지 확인하려면 대신 `CLAUDE_CODE_CHILD_SESSION`을 사용합니다 |

201| `CLAUDE_AFK_COUNTDOWN_MS` | 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자에서 자동 계속 전 화면 카운트다운이 나타나는 시점(밀리초)입니다. 기본값은 `20000`(20초)이며, 자동 계속 타임아웃으로 상한이 정해집니다. 자동 계속이 켜져 있지 않으면 효과가 없습니다. [`askUserQuestionTimeout`](/docs/ko/settings-reference#askuserquestiontimeout) 설정과 `CLAUDE_AFK_TIMEOUT_MS`를 참조하십시오. Claude Code v2.1.198 이상이 필요합니다 |201| `CLAUDE_AFK_COUNTDOWN_MS` | 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자에서 자동 계속까지 몇 밀리초 남았을 때 화면 카운트다운이 표시되는지 지정합니다. 기본값은 `20000`(20초)이며, 자동 계속 타임아웃을 넘지 않습니다. 자동 계속이 켜져 있지 않으면 효과가 없습니다. [`askUserQuestionTimeout`](/docs/ko/settings-reference#askuserquestiontimeout) 설정과 `CLAUDE_AFK_TIMEOUT_MS`를 참조하세요. Claude Code v2.1.198 이상이 필요합니다 |

202| `CLAUDE_AFK_TIMEOUT_MS` | 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자가 사용자 없이 자동으로 계속되기까지의 유휴 시간(밀리초)입니다. 자동 계속은 기본적으로 꺼져 있으며, [`askUserQuestionTimeout`](/docs/ko/settings-reference#askuserquestiontimeout) 설정으로 사용할 수 있습니다. 이 변수는 데모 및 자동화된 테스트용 재정의입니다. 설정하면 해당 설정보다 우선하며, 설정이 지정되지 않았거나 `never`인 경우에도 자동 계속을 켭니다. `0`으로 설정해도 타임아웃이 꺼지지 않으며, 대화 상자가 즉시 닫힙니다. v2.1.198과 v2.1.199에서는 자동 계속이 `60000`(60초) 타임아웃으로 기본적으로 켜져 있었습니다. Claude Code v2.1.198 이상이 필요합니다 |202| `CLAUDE_AFK_TIMEOUT_MS` | 응답하지 않은 [`AskUserQuestion`](/docs/ko/tools-reference) 대화 상자가 사용자 없이 자동으로 계속되기까지의 유휴 시간(밀리초)입니다. 자동 계속은 기본적으로 꺼져 있으며, [`askUserQuestionTimeout`](/docs/ko/settings-reference#askuserquestiontimeout) 설정으로 사용하도록 선택할 수 있습니다. 이 변수는 데모와 자동화된 테스트를 위한 재정의 수단입니다. 설정하면 해당 설정보다 우선하며, 설정이 지정되지 않았거나 `never`인 경우에도 자동 계속을 켭니다. `0`으로 설정해도 타임아웃이 꺼지지 않으며, 대화 상자가 즉시 닫힙니다. v2.1.198과 v2.1.199에서는 자동 계속이 기본적으로 켜져 있었으며 타임아웃은 `60000`(60초)이었습니다. Claude Code v2.1.198 이상이 필요합니다 |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1`로 설정하면 Explore, Plan과 같은 모든 기본 제공 [서브에이전트](/docs/ko/sub-agents) 유형을 비활성화합니다. 비대화형 모드(`-p` 플래그)에서만 적용됩니다. 빈 상태에서 시작하려는 SDK 사용자에게 유용합니다. 이 설정은 Agent 도구 호출에서 `subagent_type`이 생략되었을 때 Claude Code가 실행하는 서브에이전트인 `general-purpose`도 제거합니다. 이 경우 해당 호출은 [`subagent_type is required`](/docs/ko/errors#subagent-type-is-required) 오류로 실패합니다 |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1`로 설정하면 Explore, Plan 같은 모든 기본 제공 [서브에이전트](/docs/ko/sub-agents) 유형을 비활성화합니다. 비대화형 모드(`-p` 플래그)에서만 적용됩니다. 빈 상태에서 시작하려는 SDK 사용자에게 유용합니다. 이 설정은 Agent 도구 호출에서 `subagent_type`을 생략했을 때 Claude Code가 실행하는 서브에이전트인 `general-purpose`도 제거합니다. 그러면 이러한 호출은 [`subagent_type is required`](/docs/ko/errors#subagent-type-is-required) 오류와 함께 실패합니다 |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1`로 설정하면 SDK로 생성한 MCP 서버의 도구 이름에 `mcp__<server>__` 접두사를 붙이지 않습니다. 도구는 원래 이름을 사용합니다. SDK 사용 시에만 해당합니다 |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1`로 설정하면 SDK에서 생성한 MCP 서버의 도구 이름에서 `mcp__<server>__` 접두사를 생략합니다. 도구는 원래 이름을 사용합니다. SDK 사용 시에만 해당합니다 |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 서브에이전트의 정체 타임아웃(밀리초)입니다. 기본값은 `600000`(10분)입니다. 스트림 워치독이 켜진 상태에서 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`를 늘리면 [느리거나 정체된 API 응답 처리](/docs/ko/agent-sdk/typescript#handle-slow-or-stalled-api-responses)에 설명된 대로 기본값도 함께 늘어납니다. 타이머는 스트리밍 진행 이벤트마다 재설정되며, 해당 시간 내에 진행이 없으면 Claude Code는 서브에이전트를 중단하고 정체 사실을 상위 에이전트에 보고합니다 |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | 서브에이전트의 정체 타임아웃(밀리초)입니다. 기본값은 `600000`(10분)이며, 스트림 워치독이 켜진 상태에서 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`를 높이면 [느리거나 정체된 API 응답 처리](/docs/ko/agent-sdk/typescript#handle-slow-or-stalled-api-responses)에 설명된 대로 기본값도 함께 높아집니다. 타이머는 각 스트리밍 진행 이벤트마다 재설정되며, 해당 시간 내에 진행 상황이 도착하지 않으면 Claude Code는 서브에이전트를 중단하고 정체를 상위 에이전트에 보고합니다 |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 자동 압축이 트리거되는 자동 압축 윈도우의 비율(1-100)을 설정합니다. 더 일찍 압축하려면 `50`과 같은 낮은 값을 사용하십시오. 이 변수로 임계값을 높일 수는 없으므로 기본 비율보다 높은 값은 무시됩니다. [모델의 컨텍스트 한도 전에 압축하는](/docs/ko/model-config#context-window-and-auto-compaction) 세션에서만 적용됩니다. 메인 대화와 서브에이전트 모두에 적용됩니다 |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 자동 압축이 트리거되는 자동 압축 윈도우의 백분율(1-100)을 설정합니다. 더 일찍 압축하려면 `50` 같은 낮은 값을 사용합니다. 이 변수로 임계값을 높일 수는 없으므로 기본 백분율보다 높은 값은 무시됩니다. [모델의 컨텍스트 한도 전에 압축하는](/docs/ko/model-config#context-window-and-auto-compaction) 세션에서만 적용됩니다. 메인 대화와 서브에이전트 모두에 적용됩니다 |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1`로 설정하면 오래 실행되는 에이전트 작업의 자동 백그라운드 전환을 강제로 활성화합니다. 활성화하면 서브에이전트는 약 2분간 실행된 후 백그라운드로 이동합니다. Claude Code v2.1.212 이상에서는 비대화형 모드에서 [오래 걸리는 MCP 도구 호출의 자동 백그라운드 전환](/docs/ko/mcp#automatic-backgrounding-of-long-tool-calls)도 활성화합니다 |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1`로 설정하면 오래 실행되는 에이전트 작업의 자동 백그라운드 전환을 강제로 활성화합니다. 활성화되면 서브에이전트는 약 2분 동안 실행된 후 백그라운드로 이동합니다. Claude Code v2.1.212 이상에서는 비대화형 모드에서 [긴 MCP 도구 호출의 자동 백그라운드 전환](/docs/ko/mcp#automatic-backgrounding-of-long-tool-calls)도 활성화합니다 |

208| `CLAUDE_AX_PREPARK_MS` | [스크린 리더 모드](/docs/ko/accessibility)에서 Claude Code가 새 줄이나 변경된 줄을 쓰기 전에 대기하는 시간(밀리초)입니다. 기본값은 `0`이므로 Claude Code는 대기하지 않습니다. v2.1.287 이전에는 기본값이 `50`이었습니다. Claude Code는 대기 시간의 상한을 `5000`으로 제한합니다. Claude Code v2.1.233 이상이 필요합니다 |208| `CLAUDE_AX_PREPARK_MS` | [화면 읽기 프로그램 모드](/docs/ko/accessibility)에서 Claude Code가 새 줄이나 변경된 줄을 쓰기 전에 기다리는 시간(밀리초)입니다. 기본값은 `0`이므로 Claude Code는 기다리지 않습니다. v2.1.287 이전에는 기본값이 `50`이었습니다. Claude Code는 대기 시간을 `5000`으로 제한합니다. Claude Code v2.1.233 이상이 필요합니다 |

209| `CLAUDE_AX_SCREEN_READER` | `1`로 설정하면 장식용 테두리나 애니메이션이 없는 평문 텍스트로 스크린 리더 친화적인 출력을 렌더링합니다. [`axScreenReader`](/docs/ko/settings-reference#axscreenreader)가 `true`인 경우에도 스크린 리더 모드를 강제로 끄려면 `0`으로 설정하십시오. [`--ax-screen-reader`](/docs/ko/cli-reference#cli-flags) 플래그가 우선합니다. Claude Code v2.1.181 이상이 필요합니다 |209| `CLAUDE_AX_SCREEN_READER` | `1`로 설정하면 장식용 테두리나 애니메이션이 없는 평면 텍스트 형태의 화면 읽기 프로그램 친화적인 출력을 렌더링합니다. `0`으로 설정하면 [`axScreenReader`](/docs/ko/settings-reference#axscreenreader)가 `true`이더라도 화면 읽기 프로그램 모드를 강제로 끕니다. [`--ax-screen-reader`](/docs/ko/cli-reference#cli-flags) 플래그가 우선합니다. Claude Code v2.1.181 이상이 필요합니다 |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | [스크린 리더 모드](/docs/ko/accessibility)에서 시작 확인 줄 이후 Claude Code가 첫 인터페이스 렌더링을 보류하는 시간(밀리초)으로, 새 출력이 끼어들기 전에 스크린 리더가 해당 줄을 끝까지 읽을 수 있게 합니다. 기본값은 `3000`입니다. 즉시 렌더링하려면 `0`으로 설정하십시오. Claude Code는 보류 시간의 상한을 `600000`(10분)으로 제한합니다. 첫 키 입력 시 보류가 일찍 종료됩니다. Claude Code v2.1.217 이상이 필요합니다 |210| `CLAUDE_AX_STARTUP_QUIET_MS` | [화면 읽기 프로그램 모드](/docs/ko/accessibility)에서 Claude Code가 시작 확인 줄 이후 첫 인터페이스 렌더링을 보류하는 시간(밀리초)으로, 새 출력이 끼어들기 전에 화면 읽기 프로그램이 해당 줄을 끝까지 읽을 수 있게 합니다. 기본값은 `3000`입니다. 즉시 렌더링하려면 `0`으로 설정합니다. Claude Code는 보류 시간을 `600000`(10분)으로 제한합니다. 첫 번째 키 입력 시 보류가 일찍 끝납니다. Claude Code v2.1.217 이상이 필요합니다 |

211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 메인 세션에서 각 Bash 또는 PowerShell 명령 실행 후 원래 작업 디렉터리로 돌아갑니다 |211| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | 메인 세션에서 각 Bash 또는 PowerShell 명령 후 원래 작업 디렉터리로 돌아갑니다 |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | 바이트 수준 스트리밍 유휴 워치독의 타임아웃(밀리초)입니다. 설정하면 해당 워치독에 대해 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`보다 우선하며, 이벤트 수준 워치독은 변경되지 않습니다. Claude Code는 이 변수를 10초에서 30분 사이로 제한합니다. Claude Code v2.1.210 이상이 필요합니다 |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | 바이트 수준 스트리밍 유휴 워치독의 타임아웃(밀리초)입니다. 설정하면 해당 워치독에 대해 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`보다 우선하며, 이벤트 수준 워치독은 변경하지 않습니다. Claude Code는 이 변수를 10초에서 30분 사이로 제한합니다. Claude Code v2.1.210 이상이 필요합니다 |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | 화면 잠금 리스너와 같은 외부 도구가 화면 잠금을 해제할 때 생성하고 잠글 때 삭제하는 파일의 경로입니다. 파일이 존재하는 동안 Claude Code는 [Remote Control 모바일 푸시 알림](/docs/ko/remote-control#mobile-push-notifications)을 건너뛰므로, 컴퓨터를 적극적으로 사용하는 동안에는 푸시를 받지 않습니다. 파일이 없거나 읽을 수 없으면 알림이 평소대로 전송됩니다. Claude Code는 파일을 폴링하지 않고 푸시를 트리거하는 이벤트마다 한 번씩 확인합니다. Claude Code v2.1.181 이상이 필요합니다 |213| `CLAUDE_CLIENT_PRESENCE_FILE` | 화면 잠금 리스너 같은 외부 도구가 화면 잠금을 해제할 때 생성하고 잠글 때 삭제하는 파일의 경로입니다. 파일이 존재하는 동안 Claude Code는 [Remote Control 모바일 푸시 알림](/docs/ko/remote-control#mobile-push-notifications)을 건너뛰므로, 컴퓨터를 적극적으로 사용하는 동안에는 푸시를 받지 않습니다. 파일이 없거나 읽을 수 없으면 알림이 정상적으로 전송됩니다. Claude Code는 파일을 폴링하지 않고 푸시를 트리거하는 이벤트마다 한 번씩 확인합니다. Claude Code v2.1.181 이상이 필요합니다 |

214| `CLAUDE_CODE_ACCESSIBILITY` | `1`로 설정하면 네이티브 터미널 커서를 계속 표시하고 반전 텍스트 커서 표시기를 비활성화합니다. macOS 확대/축소와 같은 화면 돋보기가 커서 위치를 추적할 수 있게 합니다 |214| `CLAUDE_CODE_ACCESSIBILITY` | `1`로 설정하면 네이티브 터미널 커서를 계속 표시하고 반전 텍스트 커서 표시기를 비활성화합니다. macOS 확대/축소 같은 화면 확대 도구가 커서 위치를 추적할 수 있게 합니다 |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `1`로 설정하면 `--add-dir`로 지정한 디렉터리에서 메모리 파일을 로드합니다. `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, `CLAUDE.local.md`를 로드합니다. 기본적으로 추가 디렉터리는 메모리 파일을 로드하지 않습니다 |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `1`로 설정하면 `--add-dir`로 지정한 디렉터리에서 메모리 파일을 로드합니다. `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md`, `CLAUDE.local.md`를 로드합니다. 기본적으로 추가 디렉터리에서는 메모리 파일을 로드하지 않습니다 |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | `1`로 설정하면 [전체 화면 렌더링](/docs/ko/fullscreen)에서 증분 업데이트를 보내는 대신 매 프레임마다 전체 화면을 다시 그립니다. 전체 화면 모드에서 오래되었거나 잘못 배치된 텍스트 조각이 표시되는 경우 사용하십시오. Windows의 백그라운드 세션과 [에이전트 뷰](/docs/ko/agent-view)에서는 Claude Code가 이를 자동으로 활성화합니다 |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | `1`로 설정하면 [전체 화면 렌더링](/docs/ko/fullscreen)에서 증분 업데이트를 보내는 대신 매 프레임마다 전체 화면을 다시 그립니다. 전체 화면 모드에서 오래되었거나 위치가 잘못된 텍스트 조각이 표시되는 경우 사용합니다. Claude Code는 Windows의 백그라운드 세션과 [에이전트 뷰](/docs/ko/agent-view)에서 이를 자동으로 활성화합니다 |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | `1`로 설정하면 Claude Code가 모델 ID를 effort 지원 모델로 인식하지 않더라도 모든 요청에 [effort](/docs/ko/model-config#adjust-effort-level) 매개변수를 전송합니다. 사용자 지정 식별자로 모델을 제공하는 [LLM 게이트웨이](/docs/ko/llm-gateway)나 서드파티 제공업체를 통해 라우팅할 때 사용하십시오. Claude 3 모델, Sonnet 4.0 및 4.5, Opus 4.0 및 4.1, Haiku 4.5 등 API에서 effort 매개변수를 거부하는 모델은 요청이 실패하지 않도록 계속 제외됩니다 |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | `1`로 설정하면 Claude Code가 모델 ID를 effort 지원 모델로 인식하지 않더라도 모든 요청에 [effort](/docs/ko/model-config#adjust-effort-level) 매개변수를 전송합니다. 사용자 지정 식별자로 모델을 제공하는 [LLM 게이트웨이](/docs/ko/llm-gateway)나 서드 파티 제공업체를 통해 라우팅할 때 사용합니다. Claude 3 모델, Sonnet 4.0 및 4.5, Opus 4.0 및 4.1, Haiku 4.5 등 API에서 effort 매개변수를 거부하는 모델은 요청이 실패하지 않도록 여전히 제외됩니다 |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 자격 증명을 새로 고치는 간격(밀리초)입니다([`apiKeyHelper`](/docs/ko/settings-reference#apikeyhelper) 사용 시) |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 자격 증명을 새로 고쳐야 하는 간격(밀리초)입니다([`apiKeyHelper`](/docs/ko/settings-reference#apikeyhelper) 사용 시) |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0`으로 설정하면 새 [아티팩트](/docs/ko/artifacts#create-an-artifact)가 게시될 때 Claude Code가 브라우저를 자동으로 열지 않습니다 |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | `0`으로 설정하면 새 [아티팩트](/docs/ko/artifacts#create-an-artifact)가 게시될 때 Claude Code가 브라우저를 자동으로 열지 않습니다 |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0`으로 설정하면 Claude가 [아티팩트의 댓글](/docs/ko/artifacts#collect-comments-on-an-artifact)을 읽고 답하지 않습니다. `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 [아티팩트를 끈](/docs/ko/artifacts#availability) 경우에는 효과가 없습니다. Claude Code v2.1.221 이상이 필요합니다 |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | `0`으로 설정하면 Claude가 [아티팩트의 댓글](/docs/ko/artifacts#collect-comments-on-an-artifact)을 읽고 답글을 달지 않습니다. `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`이 [아티팩트를 끈](/docs/ko/artifacts#availability) 경우에는 효과가 없습니다. Claude Code v2.1.221 이상이 필요합니다 |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0`으로 설정하면 Claude가 [자신에게 전송된 댓글에 스스로 답하지](/docs/ko/artifacts#let-claude-reply-to-comments-on-its-own) 않습니다. Claude Code v2.1.228 이상이 필요합니다 |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | `0`으로 설정하면 Claude가 [자신에게 전송된 댓글에 스스로 답글을 달지](/docs/ko/artifacts#let-claude-reply-to-comments-on-its-own) 않습니다. Claude Code v2.1.228 이상이 필요합니다 |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0`으로 설정하면 클라이언트 버전과 프롬프트 지문을 담은 [귀속 블록](/docs/ko/llm-gateway-protocol#system-prompt-attribution-block)을 시스템 프롬프트 시작 부분에서 생략합니다. 어느 쪽이든 Anthropic API에 직접 연결할 때의 캐싱에는 영향이 없습니다. 일부 직접 연결 환경에서는 `0`으로 설정해도 Claude Code가 [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode) 분류기 요청에 이 블록을 유지합니다. 이것이 적용되는 연결과 자격 증명은 [시스템 프롬프트 귀속 블록](/docs/ko/llm-gateway-protocol#system-prompt-attribution-block)에서 확인하십시오. v2.1.181 이전에는 사용자 지정 기본 URL 및 Microsoft Foundry 연결에서 이 블록에 요청별 토큰이 포함되었으므로, 해당 버전에서는 LLM 게이트웨이가 요청 본문 기준으로 캐싱하거나 서드파티 제공업체로 요청을 전달하는 경우, 또는 Microsoft Foundry에 직접 연결하는 경우 `0`으로 설정하십시오 |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | `0`으로 설정하면 클라이언트 버전과 프롬프트 지문을 담은 [어트리뷰션 블록](/docs/ko/llm-gateway-protocol#system-prompt-attribution-block)을 시스템 프롬프트 시작 부분에서 생략합니다. Anthropic API에 직접 연결할 때의 캐싱은 어느 쪽이든 영향을 받지 않습니다. 일부 직접 연결 설정에서는 `0`으로 설정하더라도 Claude Code가 [자동 모드](/docs/ko/permission-modes#eliminate-prompts-with-auto-mode) 분류기 요청에 이 블록을 유지합니다. [시스템 프롬프트 어트리뷰션 블록](/docs/ko/llm-gateway-protocol#system-prompt-attribution-block)에서 여기에 해당하는 연결과 자격 증명을 확인합니다. v2.1.181 이전에는 사용자 지정 기본 URL과 Microsoft Foundry 연결에서 블록에 요청별 토큰이 포함되었으므로, 해당 버전에서는 LLM 게이트웨이가 요청 본문을 기준으로 캐시하거나 요청을 서드 파티 제공업체로 전달하는 경우, 또는 Microsoft Foundry에 직접 연결하는 경우 `0`으로 설정합니다 |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS`가 활성화된 경우, 아직 실행 중인 [백그라운드 서브에이전트](/docs/ko/sub-agents#run-subagents-in-foreground-or-background)를 확인하도록 Claude에게 알리는 간격(초)입니다. `1`부터 `86400`까지의 일반 정수만 허용하며, 그 외의 값이나 표기는 설정되지 않은 것으로 읽힙니다. 설정하지 않으면 확인 알림이 없습니다. Claude Code v2.1.248 이상이 필요합니다 |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | v2.1.283에서 제거되었습니다. 대신 `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE`을 사용합니다 |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [자동 압축 윈도우](/docs/ko/model-config#set-the-auto-compact-window)를 토큰 단위로 `100000`부터 `1000000`까지 설정합니다. `500000`과 같은 일반 정수만 허용합니다. `500k`와 같은 값은 `500`으로 읽혀 최솟값인 100K로 제한됩니다. 실제 윈도우는 모델의 컨텍스트 윈도우로도 상한이 정해집니다. `/autocompact` 명령, `--autocompact` 플래그, `autoCompactWindow` 설정보다 우선합니다. 상태줄의 `used_percentage`는 항상 모델의 전체 컨텍스트 윈도우를 기준으로 측정하므로, 이 변수를 설정하면 해당 비율은 더 이상 압축이 실행될 시점을 나타내지 않습니다 |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [자동 압축 윈도우](/docs/ko/model-config#set-the-auto-compact-window)를 토큰 단위로 `100000`에서 `1000000` 사이에서 설정합니다. `500000` 같은 일반 정수만 허용합니다. `500k` 같은 값은 `500`으로 읽혀 최소값인 100K로 고정됩니다. 실제 윈도우는 모델의 컨텍스트 윈도우로도 제한됩니다. `/autocompact` 명령, `--autocompact` 플래그, `autoCompactWindow` 설정보다 우선합니다. 상태줄의 `used_percentage`는 항상 모델의 전체 컨텍스트 윈도우를 기준으로 측정하므로, 이 변수를 설정하면 해당 백분율은 더 이상 압축이 실행될 시점을 나타내지 않습니다 |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 자동 [IDE 연결](/docs/ko/vs-code)을 재정의합니다. 기본적으로 Claude Code는 지원되는 IDE의 통합 터미널에서 실행될 때 자동으로 연결됩니다. 이를 방지하려면 `false`로 설정하십시오. tmux가 상위 터미널을 가리는 경우처럼 자동 감지가 실패할 때 연결 시도를 강제하려면 `true`로 설정하십시오. [`autoConnectIde`](/docs/ko/settings-reference#autoconnectide) 전역 구성 설정보다 우선합니다 |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 자동 [IDE 연결](/docs/ko/vs-code)을 재정의합니다. 기본적으로 Claude Code는 지원되는 IDE의 통합 터미널 안에서 실행되면 자동으로 연결합니다. 이를 방지하려면 `false`로 설정합니다. tmux가 상위 터미널을 가리는 경우처럼 자동 감지가 실패할 때 연결 시도를 강제하려면 `true`로 설정합니다. [`autoConnectIde`](/docs/ko/settings-reference#autoconnectide) 전역 구성 설정보다 우선합니다 |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code가 서버에 [자동 모드 작업 검토](/docs/ko/permission-modes#server-side-classifier-review)를 요청할지 제어합니다. `0`으로 설정하면 Claude Code 자체의 분류기 요청을 대신 사용합니다. Anthropic API에 직접 연결하는 경우 v2.1.281 이상이 필요합니다. 링크된 섹션에 변수가 설정되지 않았을 때 어떤 세션이 서버에 요청하는지와 적용 버전이 나와 있습니다. Claude Code v2.1.271 이상이 필요합니다 |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code가 서버에 [자동 모드 작업 검토](/docs/ko/permission-modes#server-side-classifier-review)를 요청할지 여부를 제어합니다. 대신 Claude Code 자체의 분류기 요청을 사용하려면 `0`으로 설정합니다. Anthropic API에 직접 연결하는 경우 v2.1.281 이상이 필요합니다. 링크된 섹션에는 변수가 설정되지 않았을 때 어떤 세션이 어느 버전부터 서버에 요청하는지 나와 있습니다. Claude Code v2.1.271 이상이 필요합니다 |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | 요청이 [`AWS default-chain credential resolve timed out`](/docs/ko/errors#aws-default-chain-credential-resolve-timed-out) 오류로 실패하기 전에 Claude Code가 AWS 기본 자격 증명 공급자 체인이 자격 증명을 생성하기를 기다리는 시간(밀리초)입니다(기본값: `60000`). `aws-vault`와 같은 래퍼를 통한 MFA 포함 브라우저 기반 SSO 로그인처럼 체인의 단계에 정당하게 더 오랜 시간이 필요한 경우 늘리십시오. Claude Code가 기본 체인으로 서명하는 모든 곳에 적용됩니다: [Amazon Bedrock](/docs/ko/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ko/claude-platform-on-aws), [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint). Claude Code v2.1.207 이상이 필요합니다 |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | 요청이 [`AWS default-chain credential resolve timed out`](/docs/ko/errors#aws-default-chain-credential-resolve-timed-out) 오류와 함께 실패하기 전에 Claude Code가 AWS 기본 자격 증명 공급자 체인이 자격 증명을 생성하기를 기다리는 시간(밀리초)입니다(기본값: `60000`). `aws-vault` 같은 래퍼를 통한 MFA 포함 브라우저 기반 SSO 로그인처럼 체인의 단계에 정당하게 더 오랜 시간이 필요한 경우 값을 높입니다. Claude Code가 기본 체인으로 서명하는 모든 곳에 적용됩니다: [Amazon Bedrock](/docs/ko/amazon-bedrock#credential-caching-and-resolution-timeout), [Claude Platform on AWS](/docs/ko/claude-platform-on-aws), [Mantle 엔드포인트](/docs/ko/amazon-bedrock#use-the-mantle-endpoint). Claude Code v2.1.207 이상이 필요합니다 |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0`으로 설정하면 [Bash 명령 실행 중 변경된 파일의 diff](/docs/ko/hooks#bash)를 끄고, `1`로 설정하면 모든 권한 모드에서 이를 기록합니다. [`bashEditDiffEnabled`](/docs/ko/settings-reference#basheditdiffenabled) 설정보다 우선합니다. Claude Code v2.1.269 이상이 필요합니다 |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | `0`으로 설정하면 [Bash 명령이 실행되는 동안 변경된 파일의 diff](/docs/ko/hooks#bash)를 끄고, `1`로 설정하면 모든 권한 모드에서 이를 기록합니다. [`bashEditDiffEnabled`](/docs/ko/settings-reference#basheditdiffenabled) 설정보다 우선합니다. Claude Code v2.1.269 이상이 필요합니다 |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | `0`으로 설정하면 비대화형 세션이 백그라운드 작업이 아직 실행 중이더라도 매 턴 종료 시 호스트에 유휴 상태를 보고합니다. 기본적으로 백그라운드 에이전트나 [워크플로](/docs/ko/workflows) 실행과 같은 백그라운드 작업이 아직 진행 중이면 세션은 턴 종료 후에도 실행 중 상태를 계속 보고합니다. 이를 통해 원격 세션 목록처럼 상태를 감시하는 호스트가 작업 도중에 Claude가 사용자 입력을 기다리고 있다고 알리지 않게 됩니다. 개발 서버와 같은 백그라운드 셸 명령은 실행 중 상태를 유지하지 않습니다. 실행 중 상태 기본값과 `0` 옵트아웃에는 Claude Code v2.1.269 이상이 필요합니다. 이전 버전에서는 실행 중 상태를 유지하려면 `1`로 설정하십시오 |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | `0`으로 설정하면 백그라운드 작업이 아직 실행 중이더라도 비대화형 세션이 매 턴이 끝날 때마다 호스트에 유휴 상태를 보고합니다. 기본적으로 세션은 백그라운드 에이전트나 [워크플로](/docs/ko/workflows) 실행 같은 백그라운드 작업이 아직 진행 중인 동안 턴이 끝난 후에도 실행 중 상태를 계속 보고합니다. 이렇게 하면 원격 세션 목록처럼 상태를 감시하는 호스트가 작업 도중에 Claude가 사용자 입력을 기다리고 있다고 알리는 것을 방지할 수 있습니다. 개발 서버 같은 백그라운드 셸 명령은 실행 중 상태를 유지하지 않습니다. 실행 중 상태 기본값과 `0` 옵트아웃에는 Claude Code v2.1.269 이상이 필요합니다. 이전 버전에서는 실행 중 상태를 유지하려면 `1`로 설정합니다 |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 세션에 활성 [Remote Control](/docs/ko/remote-control) 연결이 있는 동안 Bash 도구 및 [훅 명령](/docs/ko/hooks) 하위 프로세스에서 자동으로 설정되며, 연결이 종료되면 제거됩니다. 값은 `session_` 형식의 세션 ID로, 세션의 `claude.ai/code` URL에 나타나는 식별자와 같으므로 스크립트가 자신을 실행한 세션으로 다시 연결할 수 있습니다. Claude Code v2.1.199 이상이 필요합니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서는 대신 `CLAUDE_CODE_REMOTE_SESSION_ID`를 읽으십시오 |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | 세션에 활성 [Remote Control](/docs/ko/remote-control) 연결이 있는 동안 Bash 도구 및 [훅 명령](/docs/ko/hooks) 하위 프로세스에서 자동으로 설정되며, 연결이 끝나면 제거됩니다. 값은 `session_` 형식의 세션 ID로, 세션의 `claude.ai/code` URL에 나타나는 것과 동일한 식별자이므로 스크립트가 자신을 실행한 세션으로 다시 연결할 수 있습니다. Claude Code v2.1.199 이상이 필요합니다. [클라우드 세션](/docs/ko/claude-code-on-the-web)에서는 대신 `CLAUDE_CODE_REMOTE_SESSION_ID`를 읽습니다 |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | `0`으로 설정하면 Claude Code가 `^H`로도 표기되는 `0x08` 바이트를 일반 Backspace로 읽고, `1`로 설정하면 Ctrl+Backspace로 읽습니다. 어느 값이든 플랫폼 기본값을 대체합니다. 기본적으로 Claude Code는 Windows에서는 이를 Ctrl+Backspace로 읽되 `TERM_PROGRAM`이 `mintty`이거나 `TERM`이 `cygwin`인 경우는 예외이며, macOS와 Linux에서는 일반 Backspace로 읽습니다. [Backspace가 단어 전체를 삭제하는](/docs/ko/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) Windows 터미널에서는 `0`으로 설정하십시오 |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | `0`으로 설정하면 Claude Code가 `^H`로도 표기되는 `0x08` 바이트를 일반 Backspace로 읽고, `1`로 설정하면 Ctrl+Backspace로 읽습니다. 어느 값이든 플랫폼 기본값을 대체합니다. 기본적으로 Claude Code는 Windows에서는 이를 Ctrl+Backspace로 읽으며(단, `TERM_PROGRAM`이 `mintty`이거나 `TERM`이 `cygwin`인 경우 제외), macOS와 Linux에서는 일반 Backspace로 읽습니다. [Backspace가 단어 전체를 삭제하는](/docs/ko/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) Windows 터미널에서는 `0`으로 설정합니다 |

232| `CLAUDE_CODE_CERT_STORE` | TLS 연결을 위한 CA 인증서 소스의 쉼표로 구분된 목록입니다. `bundled`는 Claude Code와 함께 제공되는 Mozilla CA 세트입니다. `system`은 운영 체제 신뢰 저장소로, `tls.getCACertificates`가 있는 런타임(네이티브 바이너리 또는 npm 설치의 경우 Node 22.15 이상)에서만 읽습니다. [CA 인증서 저장소](/docs/ko/network-config#ca-certificate-store)를 참조하십시오. 기본값은 `bundled,system`입니다 |232| `CLAUDE_CODE_CERT_STORE` | TLS 연결을 위한 CA 인증서 소스의 쉼표로 구분된 목록입니다. `bundled`는 Claude Code와 함께 제공되는 Mozilla CA 세트입니다. `system`은 운영 체제 신뢰 스토어로, `tls.getCACertificates`가 있는 런타임(네이티브 바이너리 또는 npm 설치의 경우 Node 22.15 이상)에서만 읽습니다. [CA 인증서 스토어](/docs/ko/network-config#ca-certificate-store)를 참조하세요. 기본값은 `bundled,system`입니다 |

233| `CLAUDE_CODE_CHILD_SESSION` | Claude Code가 Bash, PowerShell, Monitor 도구, [훅](/docs/ko/hooks) 명령, [상태줄](/docs/ko/statusline) 명령을 통해 생성하는 하위 프로세스에서 `1`로 설정됩니다. stdio [MCP 서버](/docs/ko/mcp) 하위 프로세스는 오래 유지되며 자신을 생성한 세션보다 오래 살아남으므로 설정되지 않습니다. `CLAUDECODE`와 달리 이 변수는 IDE 확장 프로그램이 아닌 Claude Code 자체가 하위 프로세스를 실행할 때만 설정하므로, 중첩된 세션과 IDE 통합 터미널에서 실행한 최상위 `claude`를 확실하게 구별합니다. 이렇게 시작된 중첩 대화형 `claude` TUI는 `--resume`, `--continue`, 위쪽 화살표 기록, `claude agents` 목록에서 자동으로 제외됩니다. 비대화형 `claude -p` 세션은 계속 저장됩니다. 이 제외를 재정의하려면 `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`로 설정하십시오. Claude Code v2.1.172 이상이 필요합니다 |233| `CLAUDE_CODE_CHILD_SESSION` | Claude Code가 Bash, PowerShell, Monitor 도구, [훅](/docs/ko/hooks) 명령, [상태줄](/docs/ko/statusline) 명령을 통해 생성하는 하위 프로세스에서 `1`로 설정됩니다. stdio [MCP 서버](/docs/ko/mcp) 하위 프로세스에는 설정되지 않습니다. 이러한 하위 프로세스는 오래 유지되며 자신을 생성한 세션보다 오래 존재하기 때문입니다. `CLAUDECODE`와 달리 이 변수는 Claude Code 자체가 하위 프로세스를 시작할 때만 설정되고 IDE 확장 프로그램은 설정하지 않으므로, 중첩 세션을 IDE 통합 터미널에서 실행한 최상위 `claude`와 확실하게 구별합니다. 이런 방식으로 시작된 중첩 대화형 `claude` TUI는 `--resume`, `--continue`, 위쪽 화살표 기록, `claude agents` 목록에서 자동으로 제외됩니다. 비대화형 `claude -p` 세션은 계속 저장됩니다. 이 제외를 재정의하려면 `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`을 설정합니다. Claude Code v2.1.172 이상이 필요합니다 |

234| `CLAUDE_CODE_CLIENT_CERT` | mTLS 인증용 클라이언트 인증서 파일의 경로입니다 |234| `CLAUDE_CODE_CLIENT_CERT` | mTLS 인증용 클라이언트 인증서 파일 경로입니다 |

235| `CLAUDE_CODE_CLIENT_KEY` | mTLS 인증용 클라이언트 개인 키 파일의 경로입니다 |235| `CLAUDE_CODE_CLIENT_KEY` | mTLS 인증용 클라이언트 개인 키 파일 경로입니다 |

236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 암호화된 CLAUDE\_CODE\_CLIENT\_KEY의 암호문입니다(선택 사항) |236| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 암호화된 CLAUDE\_CODE\_CLIENT\_KEY의 암호문입니다(선택 사항) |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186에서 제거되어 이제 아무 효과가 없습니다. 이전에는 스트리밍 API 요청의 연결, TLS, 응답 헤더 단계에 별도의 타임아웃을 설정했습니다. 요청별 타임아웃에는 `API_TIMEOUT_MS`를 사용하십시오. 스트리밍 요청의 응답 헤더 단계에 대해서는 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`를 참조하십시오 |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186에서 제거되었으며 이제 아무 동작도 하지 않습니다. 이전에는 스트리밍 API 요청의 연결, TLS, 응답 헤더 단계에 대해 별도의 타임아웃을 설정했습니다. 요청별 타임아웃에는 `API_TIMEOUT_MS`를 사용합니다. 스트리밍 요청의 응답 헤더 단계에 대해서는 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`를 참조하세요 |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 디버그 로그 파일 경로를 재정의합니다. 이름과 달리 디렉터리가 아닌 파일 경로입니다. 디버그 모드는 `--debug`, `/debug` 또는 `DEBUG` 환경 변수를 통해 별도로 활성화해야 하며, 이 변수만 설정해서는 로깅이 활성화되지 않습니다. [`--debug-file`](/docs/ko/cli-reference#cli-flags) 플래그는 두 가지를 한 번에 수행합니다. 기본값은 `~/.claude/debug/<session-id>.txt`입니다 |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | 디버그 로그 파일 경로를 재정의합니다. 이름과 달리 디렉터리가 아니라 파일 경로입니다. `--debug`, `/debug` 또는 `DEBUG` 환경 변수를 통해 디버그 모드를 별도로 활성화해야 합니다. 이 변수만 설정해서는 로깅이 활성화되지 않습니다. [`--debug-file`](/docs/ko/cli-reference#cli-flags) 플래그는 두 가지를 한 번에 수행합니다. 기본값은 `~/.claude/debug/<session-id>.txt`입니다 |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 디버그 로그 파일에 기록되는 최소 로그 수준입니다. 값: `verbose`, `debug`(기본값), `info`, `warn`, `error`. 전체 상태줄 명령 출력과 같은 대량의 진단 정보를 포함하려면 `verbose`로 설정하고, 노이즈를 줄이려면 `error`로 높이십시오 |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | 디버그 로그 파일에 기록되는 최소 로그 수준입니다. 값: `verbose`, `debug`(기본값), `info`, `warn`, `error`. 전체 상태줄 명령 출력 같은 대량 진단 정보를 포함하려면 `verbose`로 설정하고, 노이즈를 줄이려면 `error`로 높입니다 |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1`로 설정하면 [1M 컨텍스트 윈도우](/docs/ko/model-config#extended-context) 지원을 비활성화합니다. 설정하면 모델 선택기에서 1M 모델 변형을 사용할 수 없으며, Claude Code는 [Sonnet 5.5](/docs/ko/model-config#sonnet-5-5-and-sonnet-5-context-window) 및 Fable 모델처럼 기본적으로 1M 윈도우를 갖는 모델의 세션을 200K 윈도우로 제한합니다. 이 제한이 적용되는 방식은 [확장 컨텍스트](/docs/ko/model-config#extended-context)를 참조하십시오. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. 인식되지 않는 `[1m]` 모델 ID의 윈도우를 수정하는 데 있어 이 변수의 역할은 [게이트웨이 또는 사용자 지정 모델 ID의 윈도우 수정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)을 참조하십시오 |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | `1`로 설정하면 [1M 컨텍스트 윈도우](/docs/ko/model-config#extended-context) 지원을 비활성화합니다. 설정하면 모델 선택기에서 1M 모델 변형을 사용할 수 없으며, Claude Code는 [Sonnet 5.5](/docs/ko/model-config#sonnet-5-5-and-sonnet-5-context-window) 및 Fable 모델처럼 기본 1M 윈도우를 가진 모델의 세션을 200K 윈도우로 제한합니다. 이 제한이 적용되는 방식은 [확장 컨텍스트](/docs/ko/model-config#extended-context)를 참조하세요. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. 인식되지 않는 `[1m]` 모델 ID의 윈도우를 보정하는 역할에 대해서는 [게이트웨이 또는 사용자 지정 모델 ID의 윈도우 보정](/docs/ko/model-config#correct-the-window-for-a-gateway-or-custom-model-id)을 참조하세요 |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | `1`로 설정하면 Opus 4.6 및 Sonnet 4.6에서 [적응형 추론](/docs/ko/model-config#adjust-effort-level)을 비활성화하고 `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 폴백합니다. 항상 적응형 추론을 사용하는 [Fable 모델](/docs/ko/model-config#extended-thinking), Sonnet 5 이상, Opus 4.7 이상에는 효과가 없습니다 |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | `1`로 설정하면 Opus 4.6과 Sonnet 4.6에서 [적응형 추론](/docs/ko/model-config#adjust-effort-level)을 비활성화하고 `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 폴백합니다. 항상 적응형 추론을 사용하는 [Fable 모델](/docs/ko/model-config#extended-thinking), Sonnet 5 이상, Opus 4.7 이상에는 효과가 없습니다 |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | `1`로 설정하면 Claude Code가 관리자 소스 전반에서 [관리형 설정](/docs/ko/managed-settings#precedence-within-the-managed-tier) `env` 블록을 키별로 병합하지 않으므로, v2.1.223 이전처럼 우선순위가 가장 높은 소스의 `env` 블록 전체만 적용됩니다. Claude Code는 설정 `env` 블록을 통해 전달된 값을 무시하므로, Claude Code를 실행하는 환경에서 설정하십시오. Claude Code v2.1.223 이상이 필요합니다 |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | `1`로 설정하면 Claude Code가 관리자 소스 전반에서 [관리형 설정](/docs/ko/managed-settings#precedence-within-the-managed-tier) `env` 블록을 키별로 병합하지 않으므로, v2.1.223 이전처럼 우선순위가 가장 높은 소스의 `env` 블록 전체만 적용됩니다. Claude Code는 설정의 `env` 블록을 통해 전달된 값을 무시하므로 Claude Code를 실행하는 환경에서 설정합니다. Claude Code v2.1.223 이상이 필요합니다 |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1`로 설정하면 [advisor 도구](/docs/ko/advisor)를 비활성화합니다. `/advisor` 명령을 사용할 수 없게 되고, 구성된 `advisorModel`은 무시되며, `--advisor` 플래그는 허용되지만 효과가 없으므로 이 플래그를 전달하는 기존 스크립트는 오류 없이 계속 작동합니다 |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | `1`로 설정하면 [advisor 도구](/docs/ko/advisor)를 비활성화합니다. `/advisor` 명령을 사용할 수 없게 되고, 구성된 `advisorModel`은 무시되며, `--advisor` 플래그는 허용되지만 효과가 없으므로 이 플래그를 전달하는 기존 스크립트는 오류 없이 계속 작동합니다 |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1`로 설정하면 [백그라운드 에이전트와 에이전트 뷰](/docs/ko/agent-view)를 끕니다: `claude agents`, `--bg`, `/background`, 온디맨드 슈퍼바이저. [`disableAgentView`](/docs/ko/settings-reference#disableagentview) 설정과 동일합니다 |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | `1`로 설정하면 [백그라운드 에이전트와 에이전트 뷰](/docs/ko/agent-view)를 끕니다: `claude agents`, `--bg`, `/background`, 온디맨드 슈퍼바이저. [`disableAgentView`](/docs/ko/settings-reference#disableagentview) 설정과 동일합니다 |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | `1`로 설정하면 [전체 화면 렌더링](/docs/ko/fullscreen)을 비활성화하고 기존 메인 화면 렌더러를 사용합니다. 대화가 터미널의 기본 스크롤백에 남으므로 `Cmd+f`와 tmux 복사 모드가 평소처럼 작동합니다. `CLAUDE_CODE_NO_FLICKER`와 [`tui`](/docs/ko/settings-reference#tui) 설정보다 우선합니다. `/tui default`로도 전환할 수 있습니다. 항상 전체 화면 렌더링을 사용하는 [에이전트 뷰](/docs/ko/agent-view)에서 연 백그라운드 세션에는 적용되지 않습니다 |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | `1`로 설정하면 [전체 화면 렌더링](/docs/ko/fullscreen)을 비활성화하고 기존 메인 화면 렌더러를 사용합니다. 대화가 터미널의 기본 스크롤백에 남아 있으므로 `Cmd+f`와 tmux 복사 모드가 평소처럼 작동합니다. `CLAUDE_CODE_NO_FLICKER`와 [`tui`](/docs/ko/settings-reference#tui) 설정보다 우선합니다. `/tui default`로 전환할 수도 있습니다. 항상 전체 화면 렌더링을 사용하는 [에이전트 뷰](/docs/ko/agent-view)에서 연 백그라운드 세션에는 적용되지 않습니다 |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | `1`로 설정하면 세션 출력을 claude.ai의 비공개 웹 페이지로 게시하는 [Artifact](/docs/ko/artifacts) 도구를 끕니다. 일단 설정하면 어떤 설정 파일로도 도구를 다시 켤 수 없습니다. 대신 설정 파일에서 도구를 끄려면 [`enableArtifact`](/docs/ko/settings-reference#enableartifact)를 `false`로 설정하십시오. deprecated된 [`disableArtifact`](/docs/ko/settings-reference#disableartifact) 키로도 끌 수 있습니다 |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | `1`로 설정하면 세션 출력을 claude.ai의 비공개 웹 페이지로 게시하는 [Artifact](/docs/ko/artifacts) 도구를 끕니다. 설정하고 나면 어떤 설정 파일로도 도구를 다시 켤 수 없습니다. 대신 설정 파일에서 도구를 끄려면 [`enableArtifact`](/docs/ko/settings-reference#enableartifact)를 `false`로 설정합니다. deprecated된 [`disableArtifact`](/docs/ko/settings-reference#disableartifact) 키도 도구를 끕니다 |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | `1`로 설정하면 첨부 파일 처리를 비활성화합니다. `@` 구문을 사용한 파일 멘션이 파일 내용으로 확장되지 않고 일반 텍스트로 전송됩니다 |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | `1`로 설정하면 첨부 파일 처리를 비활성화합니다. `@` 구문을 사용한 파일 멘션은 파일 내용으로 확장되지 않고 일반 텍스트로 전송됩니다 |

248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1`로 설정하면 Claude Code 프로세스가 다른 프로세스가 [`gcpAuthRefresh`](/docs/ko/settings-reference#gcpauthrefresh) 또는 [`awsAuthRefresh`](/docs/ko/settings-reference#awsauthrefresh) 명령을 실행하는 동안 기다리지 않고 직접 실행합니다. Claude Code v2.1.286 이상이 필요합니다 |248| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1`로 설정하면 Claude Code 프로세스가 다른 프로세스의 실행을 기다리는 대신 [`gcpAuthRefresh`](/docs/ko/settings-reference#gcpauthrefresh) 또는 [`awsAuthRefresh`](/docs/ko/settings-reference#awsauthrefresh) 명령을 직접 실행합니다. Claude Code v2.1.286 이상이 필요합니다 |

249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1`로 설정하면 [자동 메모리](/docs/ko/memory#auto-memory)를 비활성화합니다. `--bare` 모드나 [`autoMemoryEnabled: false`](/docs/ko/settings-reference#automemoryenabled)로 인해 비활성화되는 경우에도 자동 메모리를 강제로 켜려면 `0`으로 설정하십시오. 비활성화되면 Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다 |249| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1`로 설정하면 [자동 메모리](/docs/ko/memory#auto-memory)를 비활성화합니다. `0`으로 설정하면 `--bare` 모드나 [`autoMemoryEnabled: false`](/docs/ko/settings-reference#automemoryenabled)로 인해 비활성화되는 경우에도 자동 메모리를 강제로 켭니다. 비활성화되면 Claude는 자동 메모리 파일을 생성하거나 로드하지 않습니다 |

250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1`로 설정하면 Bash 및 서브에이전트 도구의 `run_in_background` 매개변수, 자동 백그라운드 전환, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화합니다 |250| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1`로 설정하면 Bash 및 서브에이전트 도구의 `run_in_background` 매개변수, 자동 백그라운드 전환, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화합니다 |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1`로 설정하면 Claude Code가 `Content-Type` 헤더가 없거나 비어 있는 [Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답을 Amazon Bedrock의 바이너리 이벤트 스트림으로 취급하지 않습니다. 기본적으로 Claude Code는 게이트웨이가 그 외에는 수정되지 않은 응답에서 헤더만 누락했다고 가정하므로, 본문을 디코딩하여 스트리밍이 계속 작동합니다. 스트림을 server-sent events로 다시 내보내는 게이트웨이에서만 이 변수를 설정하십시오. 그러면 Claude Code는 헤더가 없는 본문을 대신 server-sent events로 읽습니다. Claude Code v2.1.239 이상이 필요합니다 |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1`로 설정하면 Claude Code가 `Content-Type` 헤더가 없거나 비어 있는 [Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답을 Amazon Bedrock의 바이너리 이벤트 스트림으로 처리하지 않습니다. 기본적으로 Claude Code는 게이트웨이가 다른 부분은 수정하지 않은 응답에서 헤더만 누락했다고 가정하므로, 본문을 디코딩하여 스트리밍이 계속 작동합니다. 스트림을 서버 전송 이벤트로 다시 내보내기도 하는 게이트웨이에 대해서만 이 변수를 설정합니다. 그러면 Claude Code는 헤더가 없는 본문을 서버 전송 이벤트로 읽습니다. Claude Code v2.1.239 이상이 필요합니다 |

252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1`로 설정하면 [Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답이 `application/vnd.amazon.eventstream` content-type을 갖는지 확인하는 검사를 건너뜁니다. 이 변수가 없으면 응답에 다른 content-type이 있을 때 Claude Code는 해당 유형을 명시하는 오류와 함께 요청을 실패시키며, 이는 [게이트웨이나 프록시가 응답을 변환하고 있음](/docs/ko/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)을 의미합니다. 이 변수를 설정하는 대신 게이트웨이가 `Content-Type` 헤더와 본문을 수정 없이 전달하도록 구성하십시오. Claude Code v2.1.208 이상이 필요합니다 |252| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1`로 설정하면 [Amazon Bedrock](/docs/ko/amazon-bedrock) 스트리밍 응답에 `application/vnd.amazon.eventstream` content-type이 포함되어 있는지 확인하는 검사를 건너뜁니다. 이 변수가 없으면 응답에 다른 content-type이 포함된 경우 Claude Code는 해당 유형을 명시하는 오류와 함께 요청을 실패 처리하며, 이는 [게이트웨이나 프록시가 응답을 변환하고 있음](/docs/ko/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy)을 의미합니다. 이 변수를 설정하기보다는 게이트웨이가 `Content-Type` 헤더와 본문을 수정 없이 전달하도록 구성합니다. Claude Code v2.1.208 이상이 필요합니다 |

253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1`로 설정하면 [슈퍼바이저](/docs/ko/agent-view#the-supervisor-process)가 [백그라운드 세션](/docs/ko/agent-view)의 프로세스를 중지, 재시작 또는 업데이트할 때, 해당 세션에서 실행 중인 백그라운드 셸 명령, 동적 워크플로, 그리고 v2.1.198부터는 백그라운드 서브에이전트를 세션의 다음 프로세스로 넘기지 않고 중지합니다. 이 인계에만 영향을 줍니다. `←`나 [`/background`](/docs/ko/agent-view#from-inside-a-session)로 세션을 백그라운드로 전환하면 진행 중인 작업이 여전히 이어지며, `CLAUDE_DISABLE_ADOPT`는 두 가지를 모두 끕니다. Claude Code v2.1.196 이상이 필요합니다 |253| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1`로 설정하면 [슈퍼바이저](/docs/ko/agent-view#the-supervisor-process)가 [백그라운드 세션](/docs/ko/agent-view)의 프로세스를 중지, 재시작 또는 업데이트할 때 해당 세션에서 실행 중인 백그라운드 셸 명령, 동적 워크플로, 그리고 v2.1.198부터는 백그라운드 서브에이전트를 세션의 다음 프로세스로 넘기지 않고 중지합니다. 이 인계에만 영향을 줍니다. `←` 또는 [`/background`](/docs/ko/agent-view#from-inside-a-session)로 세션을 백그라운드로 전환하면 진행 중인 작업이 여전히 이어지며, `CLAUDE_DISABLE_ADOPT`는 두 가지를 모두 끕니다. Claude Code v2.1.196 이상이 필요합니다 |

254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1`로 설정하면 메모리 압박 상황에서 Claude Code가 [백그라운드 셸 명령](/docs/ko/interactive-mode#background-bash-commands)을 종료하지 않습니다. 기본적으로 macOS와 Linux에서 Claude Code는 운영 체제가 심각한 메모리 압박을 보고하고, 세션이 실행 중인 턴이나 서브에이전트 없이 30분간 유휴 상태일 때 백그라운드 셸을 종료합니다. Windows에는 메모리 압박 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다 |254| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | `1`로 설정하면 Claude Code가 시스템 메모리 부족 시 [백그라운드 셸 명령](/docs/ko/interactive-mode#background-bash-commands)을 종료하지 않습니다. 기본적으로 macOS와 Linux에서 Claude Code는 운영 체제가 심각한 메모리 부족을 보고하고 세션이 실행 중인 턴이나 서브에이전트 없이 30분 동안 유휴 상태였을 때 백그라운드 셸을 종료합니다. Windows에는 메모리 부족 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다 |