Documentation 2026-07-11 19:03 UTC to 2026-07-13 23:57 UTC

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 스크린 리더로 Claude Code 사용하기

6 

7> VoiceOver 및 NVDA와 같은 스크린 리더, 스크린 확대기, 감소된 모션, 색맹 친화적 테마에 대한 Claude Code 설정하기.

8 

9Claude Code는 시각적 터미널 인터페이스를 일반 텍스트로 바꾸는 스크린 리더 모드를 갖추고 있습니다. 상자, 진행 애니메이션, 제자리 다시 그리기 대신 이 모드는 VoiceOver 또는 NVDA와 같은 스크린 리더가 순서대로 읽을 수 있는 레이블이 지정된 줄을 인쇄하므로 전체 대화를 진행하고, 도구 권한을 승인하고, 출력을 끝까지 검토할 수 있습니다.

10 

11스크린 리더 모드는 선택 사항입니다. 스크린 리더 대신 스크린 확대기, 감소된 모션 또는 색맹 친화적 테마를 사용하는 경우 [스크린 리더 모드 이외의 접근성 설정](#accessibility-settings-beyond-screen-reader-mode)을 참조하십시오.

12 

13<Note>

14 스크린 리더 모드는 Claude Code v2.1.181 이상이 필요합니다. 이전 버전은 `--ax-screen-reader` 플래그를 `error: unknown option '--ax-screen-reader'`로 거부합니다.

15</Note>

16 

17<h2 id="turn-on-screen-reader-mode">

18 스크린 리더 모드 켜기

19</h2>

20 

21스크린 리더를 사용하는 빈도와 일치하는 방법을 선택하십시오:

22 

23* 한 세션의 경우: `claude --ax-screen-reader`를 실행합니다.

24* 한 셸에서 시작된 세션의 경우: `CLAUDE_AX_SCREEN_READER` 환경 변수를 `1`로 설정합니다. Bash 또는 Zsh에서는 `export CLAUDE_AX_SCREEN_READER=1`을 실행하고, PowerShell에서는 `$env:CLAUDE_AX_SCREEN_READER = "1"`을 실행합니다. 모든 셸을 포함하려면 셸 프로필에 줄을 추가합니다.

25* 머신의 모든 세션의 경우: 사용자 [설정 파일](/ko/settings)에 `"axScreenReader": true`를 추가합니다. 이는 VS Code 통합 터미널을 포함한 모든 터미널을 포함합니다.

26 

27<Note>

28 메서드는 우선순위 순서로 나열됩니다: [`--ax-screen-reader`](/ko/cli-reference#cli-flags) 플래그는 [`CLAUDE_AX_SCREEN_READER`](/ko/env-vars) 환경 변수를 재정의하고, 이는 [`axScreenReader`](/ko/settings#available-settings) 설정을 재정의합니다.

29</Note>

30 

31SSH를 통해 Claude Code를 사용하는 경우 Claude Code가 실행되는 원격 머신에서 환경 변수 또는 설정을 설정합니다.

32 

33모드가 켜져 있으면 Claude Code가 인쇄하는 첫 번째 것은 모드를 켠 메서드의 이름을 지정하는 확인 줄입니다: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]` 또는 `[Screen Reader Mode: on via settings]`; 이 메서드 명명 형식은 Claude Code v2.1.206 이상이 필요합니다.

34{/* max-version: 2.1.205 */}이전 버전은 `[Accessible screen reader mode: on]`을 인쇄합니다.

35 

36<h2 id="turn-off-screen-reader-mode">

37 스크린 리더 모드 끄기

38</h2>

39 

40모드를 켠 메서드를 역으로 수행합니다: 플래그 없이 시작하거나, 환경 변수를 설정 해제하거나, `axScreenReader`를 `false`로 설정합니다. `CLAUDE_AX_SCREEN_READER=0`을 설정하면 설정이 `true`일 때도 모드가 꺼진 상태로 유지됩니다.

41 

42<h2 id="what-your-screen-reader-hears">

43 스크린 리더가 듣는 것

44</h2>

45 

46스크린 리더 모드에서 Claude Code는 평문을 작성합니다:

47 

48* 인터페이스 크롬에 대한 상자 그리기 문자 없음

49* 색상 전용 신호 없음

50* 변경되지 않은 콘텐츠의 다시 그리기 없음; 진행 스피너는 정적 텍스트로 렌더링됨

51* Claude의 회신의 표는 상자 문자 그리드 대신 `Header: value` 문장으로 읽힙니다. {/* min-version: 2.1.198 */}Claude Code v2.1.198 이상이 필요합니다; 이전 버전은 스크린 리더 모드에서도 표를 그리드로 그립니다.

52 

53출력은 터미널의 스크롤백에 누적되므로 스크린 리더의 검토 명령 또는 터미널의 검색을 사용하여 이전 턴을 다시 읽을 수 있습니다.

54 

55스크린 리더 모드는 [`tui` 설정](/ko/settings#available-settings)으로 [전체 화면 렌더링](/ko/fullscreen)을 켜도 평문 스크롤로 렌더링됩니다; 모드가 활성화되어 있는 동안 설정은 효과가 없습니다. 첨부된 백그라운드 세션은 여전히 전체 화면으로 렌더링됩니다; [알려진 제한 사항](#known-limitations)을 참조하십시오.

56 

57트랜스크립트의 각 메시지는 스크린 리더가 발표하는 레이블로 시작하며, 메시지가 무엇인지 이름을 지정합니다: 사용자 메시지, Claude의 회신, 도구 활동, 오류 및 프롬프트. 레이블은 검색 가능하므로 터미널의 스크롤백을 검색하여 트랜스크립트의 섹션 간에 이동할 수 있습니다:

58 

59| 레이블 | 의미 |

60| :--------------------- | :-------------------------------------------------------- |

61| `you:` | 사용자 메시지 |

62| `claude:` | Claude의 회신 |

63| `tool:` | 파일 편집 또는 명령 실행과 같은 도구 활동 |

64| `tool error:` | 실패한 도구 |

65| `error:` | 실패한 API 요청과 같은 대화의 오류 |

66| `Permission Required:` | 사용자의 답변을 기다리는 권한 프롬프트 |

67| `Cost:` | Claude Code가 종료될 때 세션 비용 요약(계정이 [비용을 표시](/ko/costs)하는 경우) |

68 

69터미널 커서는 입력 캐럿을 따르므로 스크린 리더의 현재 줄 읽기 명령은 편집 중인 프롬프트로 "내가 어디에 있는가"에 답합니다.

70 

71<h3 id="jump-between-turns">

72 턴 간 이동

73</h3>

74 

75Claude Code는 턴 경계에서 OSC 133 셸 통합 마커를 내보내므로 터미널의 이전 프롬프트로 이동 키는 전체 트랜스크립트를 읽지 않고 턴 간에 이동합니다:

76 

77* iTerm2: Cmd+Shift+Up

78* VS Code 터미널: Windows에서 Ctrl+Up, macOS에서 Cmd+Up

79* Windows Terminal: 기본적으로 키가 없음; 설정에서 `scrollToMark` 작업을 바인딩합니다

80* Kitty 및 Ghostty: 터미널의 설명서에서 프롬프트로 이동 키를 확인합니다

81 

82macOS Terminal은 마커에 작용하지 않으며 Claude Code는 WezTerm에서 마커를 내보내지 않습니다. 이러한 터미널에서는 스크롤백에서 `you:` 레이블을 검색합니다.

83 

84<h2 id="answer-menus-and-prompts">

85 메뉴 및 프롬프트에 답하기

86</h2>

87 

88스크린 리더 모드에서 일반적으로 화살표 키로 탐색하는 메뉴(권한 프롬프트 포함)는 번호가 지정된 목록이 됩니다. 각 옵션은 번호가 지정된 줄로 발표되고 유효한 범위의 이름을 지정하는 `Enter selection` 프롬프트가 뒤따릅니다. 원하는 옵션의 번호를 입력하고 Enter를 누릅니다.

89 

90* 해제 가능한 메뉴를 취소하려면: Escape를 누릅니다. 프롬프트는 `or Escape to cancel`로 끝납니다.

91* 목록에 없는 번호를 입력하면: Claude Code는 유효한 범위를 발표하고 다시 시도하도록 합니다.

92 

93예/아니오 프롬프트는 두 옵션 메뉴 대신 입력된 답변을 요청합니다. `y` 또는 `n`으로 답하고 Enter를 누릅니다. `yes` 및 `no`도 작동합니다.

94 

95<h2 id="hear-when-claude-code-needs-you">

96 Claude Code가 필요할 때 듣기

97</h2>

98 

99스크린 리더 모드에서 Claude Code는 필요할 때 터미널 벨을 울리므로 트랜스크립트를 계속 확인할 필요가 없습니다. 벨은 다음과 같은 경우에 울립니다:

100 

101* Claude가 회신을 완료합니다

102* 권한 프롬프트가 나타납니다

103* 5초 이상 실행된 도구가 완료됩니다

104 

105벨은 터미널의 표준 경고입니다. 벨을 끄려면 터미널 애플리케이션에서 벨 설정을 변경합니다. 벨은 스크린 리더 모드를 요구하지 않습니다: 모드 외부에서 [`preferredNotifChannel`](/ko/settings#available-settings)을 `"terminal_bell"`로 설정하여 Claude가 사용자를 기다릴 때 유사한 경고를 받습니다. [터미널 벨 또는 알림 받기](/ko/terminal-config#get-a-terminal-bell-or-notification)를 참조하십시오.

106 

107<h2 id="accessibility-settings-beyond-screen-reader-mode">

108 스크린 리더 모드 이외의 접근성 설정

109</h2>

110 

111이러한 옵션은 스크린 리더 모드 외부의 접근성 요구 사항을 해결합니다. 모두 함께 작동합니다.

112 

113* `CLAUDE_CODE_ACCESSIBILITY` [환경 변수](/ko/env-vars)는 스크린 확대기용입니다. `CLAUDE_CODE_ACCESSIBILITY=1`을 설정하여 macOS Zoom과 같은 확대기가 커서 위치를 추적할 수 있도록 기본 터미널 커서를 표시합니다.

114* `prefersReducedMotion` [설정](/ko/settings#available-settings)은 인터페이스의 나머지를 변경하지 않고 스피너, 반짝임 및 기타 애니메이션을 줄이거나 비활성화합니다.

115* `theme` [설정](/ko/settings#available-settings)은 색맹 친화적 `dark-daltonized` 및 `light-daltonized` 테마를 포함한 인터페이스 색상을 선택합니다.

116 

117<h2 id="known-limitations">

118 알려진 제한 사항

119</h2>

120 

121일부 동작은 스크린 리더 모드에 맞게 조정되지 않습니다:

122 

123* 스크린 리더 모드는 스크린 리더가 실행 중일 때 자동으로 켜지지 않습니다.

124* [계획 모드](/ko/permission-modes#analyze-before-you-edit-with-plan-mode) 진입과 같은 모드 변경은 아직 발표되지 않습니다.

125* `claude attach` 또는 에이전트 보기에서 [백그라운드 세션](/ko/agent-view)에 첨부하면 기본 스크롤백이 없는 터미널의 대체 화면으로 들어갑니다. 이는 [다른 첨부된 세션과 동일한 동작](/ko/fullscreen)입니다. 나가려면 빈 프롬프트에서 왼쪽 화살표를 누르거나 대화 상자에 포커스가 있으면 Ctrl+Z를 누릅니다.

126* Claude Code는 종료 시 인쇄하는 요약에서 비용을 발표하며, 턴당이 아닙니다.

127* 스크린 리더 모드는 `-p` 플래그로 [비대화형 모드](/ko/headless)를 변경하지 않습니다. 비대화형 모드는 이미 평문을 작성하며 스크립팅을 위한 대안으로 남아 있습니다.

128 

129<h2 id="report-an-issue">

130 문제 보고

131</h2>

132 

133스크린 리더, 확대기 또는 터미널에서 작동하지 않는 경우 [Claude Code 이슈 추적기](https://github.com/anthropics/claude-code/issues)에서 이슈를 열고 제목에 보조 기술을 언급합니다. 보고서에 운영 체제, 터미널 애플리케이션, 보조 기술 이름 및 버전을 포함합니다.

134 

135<h2 id="related-resources">

136 관련 리소스

137</h2>

138 

139이 페이지는 이 페이지에서 다루는 내용에 대한 전체 참조 항목 및 관련 설정을 보유합니다:

140 

141* [설정](/ko/settings#available-settings): `axScreenReader`, `prefersReducedMotion`, `theme` 및 `preferredNotifChannel` 항목

142* [환경 변수](/ko/env-vars): `CLAUDE_AX_SCREEN_READER` 및 `CLAUDE_CODE_ACCESSIBILITY` 항목

143* [CLI 참조](/ko/cli-reference#cli-flags): `--ax-screen-reader` 플래그

144* [터미널 구성](/ko/terminal-config): 스크린 리더 모드 외부의 벨, 알림 및 테마

145* [비대화형 모드](/ko/headless): 스크린 리더 모드 없이 평문을 작성하는 스크립팅된 `claude -p` 실행

69 69 

70[Server-managed settings](/ko/server-managed-settings) 및 [Settings files and precedence](/ko/settings#settings-files)를 참조하세요.70[Server-managed settings](/ko/server-managed-settings) 및 [Settings files and precedence](/ko/settings#settings-files)를 참조하세요.

71 71 

72<h3 id="wsl-sessions-in-claude-code-desktop">

73 Claude Code Desktop의 WSL 세션

74</h3>

75 

76Windows에서 [Claude Code Desktop은 WSL 2 배포판 내부에서 Code 세션을 실행할 수 있습니다](/ko/desktop-wsl). 세션의 Claude Code 프로세스는 배포판 내부에서 실행되므로 위의 WSL 검색 경로를 통해 관리 설정을 확인합니다. Windows 전용 소스는 `wslInheritsWindowsSettings: true`가 배포되지 않으면 이에 도달하지 않습니다.

77 

78관리 설정이 있는 기기에서는 Desktop WSL 세션을 기본적으로 사용할 수 없습니다. 조직에서 이를 활성화하려면 Anthropic 계정 팀에 문의하세요. 활성화되면:

79 

80* HKLM 레지스트리 또는 `C:\Program Files\ClaudeCode` 파일을 통해 `wslInheritsWindowsSettings: true`를 배포하여 WSL 세션이 호스트 세션과 동일한 정책을 상속하도록 합니다.

81* WSL 세션 내에서 `/status`를 실행하여 확인합니다. `Setting sources` 줄에는 배포한 Windows 소스인 `Enterprise managed settings`가 `(HKLM)` 또는 `(file)`과 함께 표시되어야 합니다.

82 

83WSL 2 유틸리티 VM 내부의 프로세스는 Windows 측 엔드포인트 감지 센서에 표시되지 않습니다. CrowdStrike Falcon을 사용하는 경우 WSL 2에서 Linux용 Falcon 센서를 활성화하고 CrowdStrike의 WSL 문서에서 요구하는 두 가지 제외 사항(WSL 가상 머신 프로세스 및 VM 디스크 이미지)을 적용하여 배포판 내 프로세스 및 파일 활동을 관찰할 수 있도록 합니다. Claude Code의 [OpenTelemetry 도구 실행 텔레메트리](/ko/monitoring-usage)는 WSL 및 네이티브 세션에 대해 동일하게 내보내집니다.

84 

72<h2 id="decide-what-to-enforce">85<h2 id="decide-what-to-enforce">

73 시행할 항목 결정86 시행할 항목 결정

74</h2>87</h2>

100 사용량 가시성 설정113 사용량 가시성 설정

101</h2>114</h2>

102 115 

103필요한 보고 내용에 따라 모니터링을 선택하세요.116보고해야 할 내용에 따라 모니터링을 선택하세요. 대시보드, API 및 지출 제어는 Claude for Teams 또는 Enterprise 플랜과 Claude Console 조직 간에 다르므로, 기능을 중심으로 보고를 계획하기 전에 가용성 열을 확인하세요.

104 117 

105| 기능 | 제공 항목 | 가용성 | 시작 위치 |118| 기능 | 제공 항목 | 가용성 | 시작 위치 |

106| :------------------ | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------- |119| :--------------------- | :-------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- |

107| Usage monitoring | 세션, 도구 및 토큰의 OpenTelemetry 내보내기 | 모든 제공자 | [Monitoring usage](/ko/monitoring-usage) |120| Usage monitoring | 세션, 도구 및 토큰의 OpenTelemetry 내보내기 | 모든 제공자 | [Monitoring usage](/ko/monitoring-usage) |

108| Analytics dashboard | 사용자별 메트릭, 기여도 추적, 리더보드 | Anthropic만 | [Analytics](/ko/analytics) |121| Analytics dashboard | Teams / Enterprise의 채택 및 기여도 메트릭(리더보드 포함); Console의 사용자별 사용량 및 지출 메트릭 | Teams / Enterprise at [claude.ai/analytics](https://claude.ai/analytics/claude-code), Console at [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | [Analytics](/ko/analytics) |

109| Cost tracking | 지출 제한, 속도 제한 및 사용량 속성 | Anthropic; 타사 클라우드의 경우, [Claude apps gateway](/ko/claude-apps-gateway)가 사용자별 속성 및 [지출 제한](/ko/claude-apps-gateway-spend-limits)을 제공합니다 | [Costs](/ko/costs) |122| Programmatic reporting | API를 통한 사용자별 사용량 및 비용 데이터 | Enterprise의 경우 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide), Console의 경우 [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) | [Costs](/ko/costs#manage-costs-for-your-organization) |

123| Spend controls | 지출 제한 및 속도 제한 | Teams / Enterprise의 관리자 설정, Console의 워크스페이스 제한; 타사 클라우드의 경우, 클라우드 예산 제어 또는 사용자별 [지출 제한](/ko/claude-apps-gateway-spend-limits)이 있는 [Claude apps gateway](/ko/claude-apps-gateway) | [Costs](/ko/costs#manage-costs-for-your-organization) |

110 124 

111클라우드 제공자는 AWS Cost Explorer, GCP Billing 또는 Azure Cost Management를 통해 지출을 노출합니다. Claude for Teams 및 Enterprise 플랜에는 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code)의 사용량 대시보드가 포함됩니다.125Teams 및 Enterprise에서 사용자별 사용량 및 지출 수치는 분석 대시보드가 아닌 조직의 분석 설정에 있는 [지출 보고서](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)에서 제공됩니다. 클라우드 제공자는 AWS Cost Explorer, GCP Billing 또는 Azure Cost Management를 통해 지출을 노출합니다. Claude 채팅, Claude Code 및 Cowork 전반에 걸쳐 엔터프라이즈 예산을 계획하려면 [Claude Enterprise 소비 가이드](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide)를 참조하세요.

112 126 

113<h2 id="review-data-handling">127<h2 id="review-data-handling">

114 데이터 처리 검토128 데이터 처리 검토

6 6 

7> 주 모델을 더 강력한 조언자 모델과 쌍으로 만들어 Claude가 작업 중 핵심 순간에 조언자를 참고하도록 합니다.7> 주 모델을 더 강력한 조언자 모델과 쌍으로 만들어 Claude가 작업 중 핵심 순간에 조언자를 참고하도록 합니다.

8 8 

9{/* plan-availability: feature=advisor providers=anthropic */}

10 

11<Note>9<Note>

12 조언자 도구는 실험적이며 Anthropic API를 사용하는 Claude Code v2.1.98 이상이 필요합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. 동작, 가격 책정 및 가용성은 변경될 수 있습니다.10 조언자 도구는 실험적이며 Anthropic API가 필요합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. 동작, 가격 책정 및 가용성은 변경될 수 있습니다.

13</Note>11</Note>

14 12 

15조언자 도구를 사용하면 Claude가 작업 중 핵심 순간(예: 접근 방식을 확정하기 전, 반복되는 오류에 막혔을 때, 작업 완료를 선언하기 전)에 일반적으로 더 강력한 두 번째 모델을 참고할 수 있습니다. 조언자는 모든 도구 호출 및 결과를 포함한 전체 대화를 받고 Claude가 계속하기 전에 적용할 지침을 반환합니다.13조언자 도구를 사용하면 Claude가 작업 중 핵심 순간(예: 접근 방식을 확정하기 전, 반복되는 오류에 막혔을 때, 작업 완료를 선언하기 전)에 일반적으로 더 강력한 두 번째 모델을 참고할 수 있습니다. 조언자는 모든 도구 호출 및 결과를 포함한 전체 대화를 받고 Claude가 계속하기 전에 적용할 지침을 반환합니다.

161 159 

162조언자 도구는 다음 모두를 요구합니다:160조언자 도구는 다음 모두를 요구합니다:

163 161 

164* **Claude Code v2.1.98 이상**: `claude update`를 실행하여 업그레이드하세요.

165* **Anthropic API만**: 조언자는 서버 실행 도구입니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. `ANTHROPIC_BASE_URL`로 구성된 [LLM 게이트웨이](/ko/llm-gateway)를 통해 가용성은 게이트웨이가 요청을 Anthropic API로 그대로 전달하는지 여부에 따라 달라집니다.162* **Anthropic API만**: 조언자는 서버 실행 도구입니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. `ANTHROPIC_BASE_URL`로 구성된 [LLM 게이트웨이](/ko/llm-gateway)를 통해 가용성은 게이트웨이가 요청을 Anthropic API로 그대로 전달하는지 여부에 따라 달라집니다.

166* **지원되는 주 모델**: Opus 4.6 이상, Sonnet 4.6 이상 또는 Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5도 Claude Code v2.1.170 이상에서 적합합니다.163* **지원되는 주 모델**: Opus 4.6 이상, Sonnet 4.6 이상 또는 Haiku 4.5. {/* min-version: 2.1.170 */}Fable 5도 Claude Code v2.1.170 이상에서 적합합니다.

167 164 

497 OAuth2 인증497 OAuth2 인증

498</h3>498</h3>

499 499 

500[MCP 사양은 OAuth 2.1을 지원합니다](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). SDK는 OAuth 흐름을 자동으로 처리하지 않지만 애플리케이션에서 OAuth 흐름을 완료한 후 헤더를 통해 액세스 토큰을 전달할 수 있습니다:500[MCP 사양은 OAuth 2.1을 지원합니다](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). SDK는 브라우저를 열거나 대화형 OAuth 흐름을 실행하지 않습니다. 구성된 서버가 인증 챌린지를 반환하고 저장된 토큰이 없을 때, 에이전트 실행은 해당 서버의 도구 없이 계속되며, 서버는 [시스템 초기화 메시지](/ko/agent-sdk/typescript#sdksystemmessage)의 `mcp_servers` 배열에서 `needs-auth` 상태로 보고됩니다. 에이전트가 특정 서버 연결에 의존하는 경우 시작 시 해당 배열을 확인하세요.

501 

502자격 증명을 제공하려면 애플리케이션에서 OAuth 흐름을 완료하고 결과 액세스 토큰을 서버의 `headers`에 전달합니다:

501 503 

502<CodeGroup>504<CodeGroup>

503 ```typescript TypeScript theme={null}505 ```typescript TypeScript theme={null}

62 ```62 ```

63 </Tab>63 </Tab>

64 64 

65 <Tab title="Python">65 <Tab title="Python (uv)">

66 [uv](https://docs.astral.sh/uv/)는 가상 환경을 자동으로 처리하는 빠른 Python 패키지 관리자입니다:

67 

68 ```bash theme={null}

69 uv init

70 uv add claude-agent-sdk

71 ```

72 </Tab>

73 

74 <Tab title="Python (pip)">

75 가상 환경을 생성하고 활성화한 다음 패키지를 설치합니다. 가상 환경에 설치하면 최근 Debian, Ubuntu 및 Homebrew 설치의 시스템 Python이 venv 외부의 `pip install`에 대해 반환하는 `error: externally-managed-environment` 오류를 피할 수 있습니다.

76 

77 macOS 또는 Linux에서:

78 

66 ```bash theme={null}79 ```bash theme={null}

80 python3 -m venv .venv

81 source .venv/bin/activate

82 pip install claude-agent-sdk

83 ```

84 

85 Windows에서:

86 

87 ```powershell theme={null}

88 py -m venv .venv

89 .venv\Scripts\Activate.ps1

67 pip install claude-agent-sdk90 pip install claude-agent-sdk

68 ```91 ```

69 92 

93 PowerShell이 실행 정책 오류로 `Activate.ps1`을 차단하면 먼저 `Set-ExecutionPolicy -Scope Process RemoteSigned`를 실행합니다.

94 

70 Python 패키지는 Python 3.10 이상이 필요합니다. pip에서 `No matching distribution found for claude-agent-sdk`를 보고하면 인터프리터가 3.10보다 오래된 것입니다. macOS 또는 Linux에서 `python3 --version`을 실행하거나 Windows에서 `py --version`을 실행하여 확인하십시오.95 Python 패키지는 Python 3.10 이상이 필요합니다. pip에서 `No matching distribution found for claude-agent-sdk`를 보고하면 인터프리터가 3.10보다 오래된 것입니다. macOS 또는 Linux에서 `python3 --version`을 실행하거나 Windows에서 `py --version`을 실행하여 확인하십시오.

71 </Tab>96 </Tab>

72 </Tabs>97 </Tabs>

77 </Step>102 </Step>

78 103 

79 <Step title="API 키 설정">104 <Step title="API 키 설정">

80 [콘솔](https://platform.claude.com/)에서 API 키를 가져온 다음 환경 변수로 설정하십시오:105 [콘솔](https://platform.claude.com/)에서 API 키를 가져온 다음 환경 변수로 설정합니다.

106 

107 macOS 또는 Linux에서:

81 108 

82 ```bash theme={null}109 ```bash theme={null}

83 export ANTHROPIC_API_KEY=your-api-key110 export ANTHROPIC_API_KEY=sk-ant-xxxxx

111 ```

112 

113 Windows PowerShell에서:

114 

115 ```powershell theme={null}

116 $env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

84 ```117 ```

85 118 

86 SDK는 또한 타사 API 제공자를 통한 인증을 지원합니다:119 SDK는 또한 타사 API 제공자를 통한 인증을 지원합니다:

10 설치10 설치

11</h2>11</h2>

12 12 

13최근 Debian, Ubuntu, 및 Homebrew Python 설치에서 가상 환경에 패키지를 설치합니다. 시스템 Python에 대해 `pip install`을 실행하면 `error: externally-managed-environment` 오류가 발생합니다.

14 

13```bash theme={null}15```bash theme={null}

16python3 -m venv .venv

17source .venv/bin/activate

14pip install claude-agent-sdk18pip install claude-agent-sdk

15```19```

16 20 

21uv, Windows PowerShell, 및 API 키 설정에 대해서는 [Agent SDK 개요에서 시작하기](/ko/agent-sdk/overview#get-started)를 참조하십시오.

22 

17<h2 id="choosing-between-query-and-claudesdkclient">23<h2 id="choosing-between-query-and-claudesdkclient">

18 `query()`와 `ClaudeSDKClient` 중 선택하기24 `query()`와 `ClaudeSDKClient` 중 선택하기

19</h2>25</h2>

332 시작 모델 확인332 시작 모델 확인

333</h2>333</h2>

334 334 

335Claude Code가 Amazon Bedrock으로 구성되어 시작되면 사용하려는 모델이 계정에서 액세스 가능한지 확인합니다. 이 확인에는 Claude Code v2.1.94 이상이 필요합니다.335Claude Code가 Amazon Bedrock으로 구성되어 시작되면 사용하려는 모델이 계정에서 액세스 가능한지 확인합니다.

336 336 

337현재 Claude Code 기본값보다 오래된 모델 버전을 고정했고 계정이 최신 버전을 호출할 수 있는 경우 Claude Code는 고정을 업데이트하라는 메시지를 표시합니다. 수락하면 새 모델 ID를 [사용자 설정 파일](/ko/settings)에 쓰고 Claude Code를 다시 시작합니다. 거부하면 다음 기본 버전 변경까지 기억됩니다. [애플리케이션 추론 프로필 ARN](#map-each-model-version-to-an-inference-profile)을 가리키는 고정은 관리자가 관리하므로 건너뜁니다.337현재 Claude Code 기본값보다 오래된 모델 버전을 고정했고 계정이 최신 버전을 호출할 수 있는 경우 Claude Code는 고정을 업데이트하라는 메시지를 표시합니다. 수락하면 새 모델 ID를 [사용자 설정 파일](/ko/settings)에 쓰고 Claude Code를 다시 시작합니다. 거부하면 다음 기본 버전 변경까지 기억됩니다. [애플리케이션 추론 프로필 ARN](#map-each-model-version-to-an-inference-profile)을 가리키는 고정은 관리자가 관리하므로 건너뜁니다.

338 338 

435 435 

436Mantle은 Bedrock Invoke API 대신 기본 Anthropic API 형태를 통해 Claude 모델을 제공하는 Amazon Bedrock 엔드포인트입니다. 이 페이지의 앞부분에서 설명한 동일한 AWS 자격 증명, IAM 권한 및 `awsAuthRefresh` 구성을 사용합니다.436Mantle은 Bedrock Invoke API 대신 기본 Anthropic API 형태를 통해 Claude 모델을 제공하는 Amazon Bedrock 엔드포인트입니다. 이 페이지의 앞부분에서 설명한 동일한 AWS 자격 증명, IAM 권한 및 `awsAuthRefresh` 구성을 사용합니다.

437 437 

438<Note>

439 Mantle에는 Claude Code v2.1.94 이상이 필요합니다. `claude --version`을 실행하여 확인하십시오.

440</Note>

441 

442<h3 id="enable-mantle">438<h3 id="enable-mantle">

443 Mantle 활성화439 Mantle 활성화

444</h3>440</h3>

26* **리더보드**: Claude Code 사용량으로 순위가 매겨진 상위 기여자26* **리더보드**: Claude Code 사용량으로 순위가 매겨진 상위 기여자

27* **데이터 내보내기**: 사용자 정의 보고를 위해 기여도 데이터를 CSV로 다운로드27* **데이터 내보내기**: 사용자 정의 보고를 위해 기여도 데이터를 CSV로 다운로드

28 28 

29사용자별 토큰 수 및 비용 추정치는 [OpenTelemetry 내보내기](/ko/monitoring-usage)를 구성하세요.29사용자별 토큰 수 및 비용 추정치는 [OpenTelemetry 내보내기](/ko/monitoring-usage)를 구성하거나, 조직의 분석 설정에서 [지출 보고서](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)를 내보내세요. 이 보고서는 사용자별 및 모델별 토큰 사용량 및 예상 사용량 크레딧 지출을 나열합니다.

30 30 

31<h3 id="enable-contribution-metrics">31<h3 id="enable-contribution-metrics">

32 기여도 지표 활성화32 기여도 지표 활성화

228 프로그래매틱 방식으로 데이터 접근228 프로그래매틱 방식으로 데이터 접근

229</h4>229</h4>

230 230 

231Enterprise 플랜에서 [Claude Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)는 Claude Code를 포함한 Claude 전체 표면에서 조직의 사용자별 참여, 사용량 및 비용 보고서를 반환합니다. 기본 소유자는 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys)에서 `read:analytics` 범위를 가진 키를 생성합니다. API는 Teams 플랜에서 사용할 수 없습니다.

232 

231GitHub를 통해 이 데이터를 쿼리하려면 `claude-code-assisted` 레이블이 지정된 PR을 검색합니다.233GitHub를 통해 이 데이터를 쿼리하려면 `claude-code-assisted` 레이블이 지정된 PR을 검색합니다.

232 234 

233<h2 id="access-analytics-for-api-customers">235<h2 id="access-analytics-for-api-customers">

234 API 고객을 위한 분석 접근236 API 고객을 위한 분석 접근

235</h2>237</h2>

236 238 

237Claude Console을 사용하는 API 고객은 [platform.claude.com/claude-code](https://platform.claude.com/claude-code)에서 분석에 접근할 수 있습니다. 대시보드에 접근하려면 UsageView 권한이 필요하며, 이는 개발자, 청구, 관리자, 소유자 및 기본 소유자 역할에 부여됩니다.239Claude Console을 사용하는 API 고객은 [platform.claude.com/claude-code](https://platform.claude.com/claude-code)에서 분석에 접근할 수 있습니다. 대시보드에 접근하려면 UsageView 권한이 필요하며, 이는 Developer, Billing, Admin, Owner 및 Primary Owner 역할에 부여됩니다. 동일한 일일 사용자별 지표를 프로그래밍 방식으로 가져오려면 Admin API 키를 사용하여 [Claude Code Analytics API](https://platform.claude.com/docs/ko/build-with-claude/claude-code-analytics-api)를 사용합니다.

238 240 

239<Note>241<Note>

240 GitHub 통합을 포함한 기여도 지표는 현재 API 고객에게 사용할 수 없습니다. Console 대시보드는 사용량 및 지출 지표만 표시합니다.242 GitHub 통합을 포함한 기여도 지표는 현재 API 고객에게 사용할 수 없습니다. Console 대시보드는 사용량 및 지출 지표만 표시합니다.

7> 채널을 사용하여 MCP 서버에서 실행 중인 Claude Code 세션으로 메시지, 알림 및 웹훅을 푸시합니다. CI 결과, 채팅 메시지 및 모니터링 이벤트를 전달하여 Claude가 자리를 비웠을 때 반응할 수 있도록 합니다.7> 채널을 사용하여 MCP 서버에서 실행 중인 Claude Code 세션으로 메시지, 알림 및 웹훅을 푸시합니다. CI 결과, 채팅 메시지 및 모니터링 이벤트를 전달하여 Claude가 자리를 비웠을 때 반응할 수 있도록 합니다.

8 8 

9<Note>9<Note>

10 채널은 [연구 미리보기](#research-preview)에 있으며 Claude Code v2.1.80 이상이 필요합니다. Anthropic 인증이 필요하며 claude.ai 또는 Console API 키를 통해 인증합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. Team 및 Enterprise 조직은 [명시적으로 활성화](#enterprise-controls)해야 합니다.10 채널은 [연구 미리보기](#research-preview)에 있으며 Anthropic 인증이 필요합니다(claude.ai 또는 Console API 키를 통해). Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다. Team 및 Enterprise 조직은 [명시적으로 활성화](#enterprise-controls)해야 합니다.

11</Note>11</Note>

12 12 

13채널은 실행 중인 Claude Code 세션으로 이벤트를 푸시하는 MCP 서버이므로 Claude는 터미널에 없을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다. Claude는 이벤트를 읽고 동일한 채널을 통해 다시 회신합니다(채팅 브리지처럼). 이벤트는 세션이 열려 있는 동안에만 도착하므로 항상 켜진 설정의 경우 Claude를 백그라운드 프로세스 또는 지속적인 터미널에서 실행합니다.13채널은 실행 중인 Claude Code 세션으로 이벤트를 푸시하는 MCP 서버이므로 Claude는 터미널에 없을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다. Claude는 이벤트를 읽고 동일한 채널을 통해 다시 회신합니다(채팅 브리지처럼). 이벤트는 세션이 열려 있는 동안에만 도착하므로 항상 켜진 설정의 경우 Claude를 백그라운드 프로세스 또는 지속적인 터미널에서 실행합니다.

7> 웹훅, 알림, 채팅 메시지를 Claude Code 세션으로 푸시하는 MCP 서버를 구축합니다. 채널 계약 참조: 기능 선언, 알림 이벤트, 회신 도구, 발신자 게이팅, 권한 릴레이.7> 웹훅, 알림, 채팅 메시지를 Claude Code 세션으로 푸시하는 MCP 서버를 구축합니다. 채널 계약 참조: 기능 선언, 알림 이벤트, 회신 도구, 발신자 게이팅, 권한 릴레이.

8 8 

9<Note>9<Note>

10 채널은 [연구 미리보기](/ko/channels#research-preview)에 있으며 Claude Code v2.1.80 이상이 필요합니다. 팀 및 엔터프라이즈 조직은 [명시적으로 활성화](/ko/channels#enterprise-controls)해야 합니다.10 채널은 [연구 미리보기](/ko/channels#research-preview)에 있습니다. 팀 및 엔터프라이즈 조직은 [명시적으로 활성화](/ko/channels#enterprise-controls)해야 합니다.

11</Note>11</Note>

12 12 

13채널은 Claude Code 세션으로 이벤트를 푸시하는 MCP 서버이므로 Claude는 터미널 외부에서 발생하는 일에 반응할 수 있습니다.13채널은 Claude Code 세션으로 이벤트를 푸시하는 MCP 서버이므로 Claude는 터미널 외부에서 발생하는 일에 반응할 수 있습니다.

453 권한 프롬프트 릴레이453 권한 프롬프트 릴레이

454</h2>454</h2>

455 455 

456<Note>

457 권한 릴레이는 Claude Code v2.1.81 이상이 필요합니다. 이전 버전은 `claude/channel/permission` 기능을 무시합니다.

458</Note>

459 

460Claude가 승인이 필요한 도구를 호출할 때 로컬 터미널 대화가 열리고 세션이 대기합니다. 양방향 채널은 동일한 프롬프트를 병렬로 수신하고 다른 장치의 사용자에게 릴레이하도록 선택할 수 있습니다. 둘 다 활성 상태로 유지됩니다: 터미널 또는 휴대폰에서 답변할 수 있으며 Claude Code는 먼저 도착하는 답변을 적용하고 다른 답변을 닫습니다.456Claude가 승인이 필요한 도구를 호출할 때 로컬 터미널 대화가 열리고 세션이 대기합니다. 양방향 채널은 동일한 프롬프트를 병렬로 수신하고 다른 장치의 사용자에게 릴레이하도록 선택할 수 있습니다. 둘 다 활성 상태로 유지됩니다: 터미널 또는 휴대폰에서 답변할 수 있으며 Claude Code는 먼저 도착하는 답변을 적용하고 다른 답변을 닫습니다.

461 457 

462릴레이는 `Bash`, `Write` 및 `Edit`과 같은 도구 사용 승인을 다룹니다. 프로젝트 신뢰 및 MCP 서버 동의 대화는 릴레이되지 않습니다. 이들은 로컬 터미널에만 나타납니다.458릴레이는 `Bash`, `Write` 및 `Edit`과 같은 도구 사용 승인을 다룹니다. 프로젝트 신뢰 및 MCP 서버 동의 대화는 릴레이되지 않습니다. 이들은 로컬 터미널에만 나타납니다.

12 Checkpoint의 작동 방식12 Checkpoint의 작동 방식

13</h2>13</h2>

14 14 

15Claude와 함께 작업할 때 checkpointing은 각 편집 전에 코드의 상태를 자동으로 캡처합니다. 이 안전장치를 통해 언제든지 이전 코드 상태로 돌아갈 수 있다는 확신을 가지고 야심 찬 대규모 작업을 수행할 수 있습니다.15Claude와 함께 작업할 때 checkpointing은 각 사용자 프롬프트 전에 코드의 상태를 자동으로 캡처합니다. 이 안전장치를 통해 언제든지 이전 코드 상태로 돌아갈 수 있다는 확신을 가지고 야심 찬 대규모 작업을 수행할 수 있습니다.

16 16 

17<h3 id="automatic-tracking">17<h3 id="automatic-tracking">

18 자동 추적18 자동 추적

21Claude Code는 파일 편집 도구로 수행된 모든 변경 사항을 추적합니다:21Claude Code는 파일 편집 도구로 수행된 모든 변경 사항을 추적합니다:

22 22 

23* 모든 사용자 프롬프트는 새로운 checkpoint를 생성합니다23* 모든 사용자 프롬프트는 새로운 checkpoint를 생성합니다

24* Checkpoint는 세션 전체에 걸쳐 유지되므로 재개된 대화에서 액세스할 수 있습니다24* Checkpoint는 세션과 함께 저장되므로 재개된 세션에서도 `/rewind`를 사용할 수 있습니다

25* 30일 후 세션과 함께 자동으로 정리됩니다(구성 가능)25* 30일 후 세션과 함께 자동으로 정리됩니다(구성 가능)

26 26 

27<h3 id="rewind-and-summarize">27<h3 id="rewind-and-summarize">

36 36 

37* [Google Chrome](https://www.google.com/chrome/) 또는 [Microsoft Edge](https://www.microsoft.com/edge) 브라우저37* [Google Chrome](https://www.google.com/chrome/) 또는 [Microsoft Edge](https://www.microsoft.com/edge) 브라우저

38* [Claude in Chrome 확장 프로그램](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 버전 1.0.36 이상(Chrome 웹 스토어에서 두 브라우저 모두에 사용 가능)38* [Claude in Chrome 확장 프로그램](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 버전 1.0.36 이상(Chrome 웹 스토어에서 두 브라우저 모두에 사용 가능)

39* [Claude Code](/ko/quickstart#step-1-install-claude-code) 버전 2.0.73 이상39* [Claude Code](/ko/quickstart#step-1-install-claude-code)

40* 직접 Anthropic 플랜 (Pro, Max, Team 또는 Enterprise)40* 직접 Anthropic 플랜 (Pro, Max, Team 또는 Enterprise)

41 41 

42<Note>42<Note>

59| 플래그 | 설명 | 예시 |59| 플래그 | 설명 | 예시 |

60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |60| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

61| `--add-dir` | Claude가 파일을 읽고 편집할 수 있는 추가 작업 디렉토리를 추가합니다. 파일 액세스를 부여합니다. 대부분의 `.claude/` 구성은 이러한 디렉토리에서 [검색되지 않습니다](/ko/permissions#additional-directories-grant-file-access-not-configuration). 각 경로가 디렉토리로 존재하는지 검증합니다. 이러한 디렉토리를 세션 간에 유지하려면 설정에서 [`permissions.additionalDirectories`](/ko/settings#permission-settings)를 설정합니다 | `claude --add-dir ../apps ../lib` |61| `--add-dir` | Claude가 파일을 읽고 편집할 수 있는 추가 작업 디렉토리를 추가합니다. 파일 액세스를 부여합니다. 대부분의 `.claude/` 구성은 이러한 디렉토리에서 [검색되지 않습니다](/ko/permissions#additional-directories-grant-file-access-not-configuration). 각 경로가 디렉토리로 존재하는지 검증합니다. 이러한 디렉토리를 세션 간에 유지하려면 설정에서 [`permissions.additionalDirectories`](/ko/settings#permission-settings)를 설정합니다 | `claude --add-dir ../apps ../lib` |

62| `--advisor <model>` | {/* min-version: 2.1.98 */}이 세션에 대해 서버 측 [advisor 도구](/ko/advisor)를 활성화합니다. 모델 별칭 사용: `opus`, `sonnet` 또는 `fable` ({/* min-version: 2.1.170 */}v2.1.170+) 또는 전체 모델 ID입니다. `advisorModel` 설정보다 우선합니다. Claude Code v2.1.98 이상이 필요합니다 | `claude --advisor opus` |62| `--advisor <model>` | 이 세션에 대해 서버 측 [advisor 도구](/ko/advisor)를 활성화합니다. 모델 별칭 사용: `opus`, `sonnet` 또는 `fable` ({/* min-version: 2.1.170 */}v2.1.170+) 또는 전체 모델 ID입니다. `advisorModel` 설정보다 우선합니다 | `claude --advisor opus` |

63| `--agent` | 현재 세션에 대한 에이전트를 지정합니다(`agent` 설정 재정의) | `claude --agent my-custom-agent` |63| `--agent` | 현재 세션에 대한 에이전트를 지정합니다(`agent` 설정 재정의) | `claude --agent my-custom-agent` |

64| `--agents` | JSON을 통해 사용자 정의 subagents를 동적으로 정의합니다. subagent [frontmatter](/ko/sub-agents#supported-frontmatter-fields)와 동일한 필드 이름과 에이전트의 지시사항에 대한 `prompt` 필드를 사용합니다 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | JSON을 통해 사용자 정의 subagents를 동적으로 정의합니다. subagent [frontmatter](/ko/sub-agents#supported-frontmatter-fields)와 동일한 필드 이름과 에이전트의 지시사항에 대한 `prompt` 필드를 사용합니다 | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

65| `--allow-dangerously-skip-permissions` | `Shift+Tab` 모드 사이클에 `bypassPermissions`를 추가합니다. 이를 통해 `plan`과 같은 다른 모드에서 시작하고 나중에 `bypassPermissions`로 전환할 수 있습니다. [권한 모드](/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode) 참조 | `claude --permission-mode plan --allow-dangerously-skip-permissions` |65| `--allow-dangerously-skip-permissions` | `Shift+Tab` 모드 사이클에 `bypassPermissions`를 추가합니다. 이를 통해 `plan`과 같은 다른 모드에서 시작하고 나중에 `bypassPermissions`로 전환할 수 있습니다. [권한 모드](/ko/permission-modes#skip-all-checks-with-bypasspermissions-mode) 참조 | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}모든 [subagent](/ko/sub-agents)의 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다. 중첩된 subagents를 포함합니다. `-p`를 사용한 비대화형 모드에만 적용됩니다. Claude Code v2.1.205 이상이 필요합니다 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}모든 [subagent](/ko/sub-agents)의 시스템 프롬프트 끝에 사용자 정의 텍스트를 추가합니다. 중첩된 subagents를 포함합니다. `-p`를 사용한 비대화형 모드에만 적용됩니다. Claude Code v2.1.205 이상이 필요합니다 | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

68| `--append-system-prompt` | 기본 시스템 프롬프트의 끝에 사용자 정의 텍스트를 추가합니다 | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | 기본 시스템 프롬프트의 끝에 사용자 정의 텍스트를 추가합니다 | `claude --append-system-prompt "Always use TypeScript"` |

69| `--append-system-prompt-file` | 파일에서 추가 시스템 프롬프트 텍스트를 로드하고 기본 프롬프트에 추가합니다 | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | 파일에서 추가 시스템 프롬프트 텍스트를 로드하고 기본 프롬프트에 추가합니다 | `claude --append-system-prompt-file ./extra-rules.txt` |

70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}스크린 리더 친화적 출력을 렌더링합니다: 장식용 테두리나 애니메이션 없는 평문입니다. 클래식 렌더러를 강제하므로 이 세션에 대해 [`tui`](/ko/settings#available-settings) 설정은 효과가 없습니다. [`CLAUDE_AX_SCREEN_READER`](/ko/env-vars) 및 [`axScreenReader`](/ko/settings#available-settings) 설정보다 우선합니다. Claude Code v2.1.181 이상이 필요합니다 | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}스크린 리더 친화적 출력을 렌더링합니다: 장식용 테두리나 애니메이션 없는 평문입니다. 클래식 렌더러를 강제하므로 이 세션에 대해 [`tui`](/ko/settings#available-settings) 설정은 효과가 없습니다. 연결된 [백그라운드 세션](/ko/agent-view)은 여전히 전체 화면으로 렌더링됩니다. [`CLAUDE_AX_SCREEN_READER`](/ko/env-vars) 및 [`axScreenReader`](/ko/settings#available-settings) 설정보다 우선합니다. Claude Code v2.1.181 이상이 필요합니다 | `claude --ax-screen-reader` |

71| `--bare` | 최소 모드: hooks, skills, plugins, MCP 서버, 자동 메모리 및 CLAUDE.md의 자동 검색을 건너뜁니다. 스크립트된 호출이 더 빠르게 시작됩니다. Claude는 Bash, 파일 읽기 및 파일 편집 도구에 액세스할 수 있습니다. [`CLAUDE_CODE_SIMPLE`](/ko/env-vars)을 설정합니다. [bare 모드](/ko/headless#start-faster-with-bare-mode) 참조 | `claude --bare -p "query"` |71| `--bare` | 최소 모드: hooks, skills, plugins, MCP 서버, 자동 메모리 및 CLAUDE.md의 자동 검색을 건너뜁니다. 스크립트된 호출이 더 빠르게 시작됩니다. Claude는 Bash, 파일 읽기 및 파일 편집 도구에 액세스할 수 있습니다. [`CLAUDE_CODE_SIMPLE`](/ko/env-vars)을 설정합니다. [bare 모드](/ko/headless#start-faster-with-bare-mode) 참조 | `claude --bare -p "query"` |

72| `--betas` | API 요청에 포함할 베타 헤더(API 키 사용자만 해당) | `claude --betas interleaved-thinking` |72| `--betas` | API 요청에 포함할 베타 헤더(API 키 사용자만 해당) | `claude --betas interleaved-thinking` |

73| `--bg`, `--background` | 세션을 [백그라운드 에이전트](/ko/agent-view)로 시작하고 즉시 반환합니다. 세션 ID와 관리 명령어를 인쇄합니다. `--exec`과 결합하여 Claude 세션 대신 셸 명령어를 백그라운드 작업으로 실행하거나, `--agent`와 결합하여 특정 subagent를 실행합니다. {/* min-version: 2.1.198 */}`-p`/`--print`와 결합할 수 없습니다. [오류 참조](/ko/errors#command-line-errors) 참조 | `claude --bg "investigate the flaky test"` |73| `--bg`, `--background` | 세션을 [백그라운드 에이전트](/ko/agent-view)로 시작하고 즉시 반환합니다. 세션 ID와 관리 명령어를 인쇄합니다. `--exec`과 결합하여 Claude 세션 대신 셸 명령어를 백그라운드 작업으로 실행하거나, `--agent`와 결합하여 특정 subagent를 실행합니다. {/* min-version: 2.1.198 */}`-p`/`--print`와 결합할 수 없습니다. [오류 참조](/ko/errors#command-line-errors) 참조 | `claude --bg "investigate the flaky test"` |

50| 명령어 | 목적 |50| 명령어 | 목적 |

51| :--------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

52| `/add-dir <path>` | 현재 세션 중에 파일 액세스를 위한 작업 디렉토리를 추가합니다. 대부분의 `.claude/` 구성은 추가된 디렉토리에서 [발견되지 않습니다](/ko/permissions#additional-directories-grant-file-access-not-configuration). 나중에 `--continue` 또는 `--resume`을 사용하여 추가된 디렉토리에서 세션을 재개할 수 있습니다 |52| `/add-dir <path>` | 현재 세션 중에 파일 액세스를 위한 작업 디렉토리를 추가합니다. 대부분의 `.claude/` 구성은 추가된 디렉토리에서 [발견되지 않습니다](/ko/permissions#additional-directories-grant-file-access-not-configuration). 나중에 `--continue` 또는 `--resume`을 사용하여 추가된 디렉토리에서 세션을 재개할 수 있습니다 |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}[advisor tool](/ko/advisor)을 활성화 또는 비활성화합니다. 이 도구는 작업 중 주요 순간에 두 번째 모델에 지침을 요청합니다. `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) 또는 전체 모델 ID를 허용합니다. 인수 없이 선택기를 엽니다. Claude Code v2.1.98 이상이 필요합니다 |53| `/advisor [model\|off]` | [advisor tool](/ko/advisor)을 활성화 또는 비활성화합니다. 이 도구는 작업 중 주요 순간에 두 번째 모델에 지침을 요청합니다. `opus`, `sonnet`, `fable` ({/* min-version: 2.1.170 */}v2.1.170+) 또는 전체 모델 ID를 허용합니다. 인수 없이 선택기를 엽니다 |

54| `/agents` | {/* min-version: 2.1.198 */}v2.1.198부터 `/agents`를 실행하면 Claude에 [subagents](/ko/sub-agents)를 만들거나 관리하도록 요청하거나, `.claude/agents/` 또는 `~/.claude/agents/`를 직접 편집하도록 상기시키는 메시지를 인쇄합니다. {/* max-version: 2.1.197 */}v2.1.197 이전에는 subagent 구성을 만들고 관리하기 위한 대화형 인터페이스를 엽니다 |54| `/agents` | {/* min-version: 2.1.198 */}v2.1.198부터 `/agents`를 실행하면 Claude에 [subagents](/ko/sub-agents)를 만들거나 관리하도록 요청하거나, `.claude/agents/` 또는 `~/.claude/agents/`를 직접 편집하도록 상기시키는 메시지를 인쇄합니다. {/* max-version: 2.1.197 */}v2.1.197 이전에는 subagent 구성을 만들고 관리하기 위한 대화형 인터페이스를 엽니다 |

55| `/autofix-pr [prompt]` | 현재 브랜치의 PR을 감시하고 CI가 실패하거나 검토자가 댓글을 남길 때 수정 사항을 푸시하는 [Claude Code on the web](/ko/claude-code-on-the-web#auto-fix-pull-requests) 세션을 생성합니다. `gh pr view`를 사용하여 체크아웃된 브랜치에서 열린 PR을 감지합니다. 다른 PR을 감시하려면 먼저 해당 브랜치를 체크아웃하세요. 기본적으로 클라우드 세션은 모든 CI 실패 및 검토 댓글을 수정하도록 지시받습니다. 프롬프트를 전달하여 다른 지침을 제공합니다. 예를 들어 `/autofix-pr only fix lint and type errors`. `gh` CLI 및 [Claude Code on the web](/ko/claude-code-on-the-web)에 대한 액세스가 필요합니다 |55| `/autofix-pr [prompt]` | 현재 브랜치의 PR을 감시하고 CI가 실패하거나 검토자가 댓글을 남길 때 수정 사항을 푸시하는 [Claude Code on the web](/ko/claude-code-on-the-web#auto-fix-pull-requests) 세션을 생성합니다. `gh pr view`를 사용하여 체크아웃된 브랜치에서 열린 PR을 감지합니다. 다른 PR을 감시하려면 먼저 해당 브랜치를 체크아웃하세요. 기본적으로 클라우드 세션은 모든 CI 실패 및 검토 댓글을 수정하도록 지시받습니다. 프롬프트를 전달하여 다른 지침을 제공합니다. 예를 들어 `/autofix-pr only fix lint and type errors`. `gh` CLI 및 [Claude Code on the web](/ko/claude-code-on-the-web)에 대한 액세스가 필요합니다 |

56| `/background [prompt]` | 현재 세션을 [background agent](/ko/agent-view)로 분리하여 실행하고 이 터미널을 해제합니다. 분리하기 전에 한 가지 더 지침을 보내려면 프롬프트를 전달합니다. `claude agents`로 세션을 모니터링합니다. 별칭: `/bg` |56| `/background [prompt]` | 현재 세션을 [background agent](/ko/agent-view)로 분리하여 실행하고 이 터미널을 해제합니다. 분리하기 전에 한 가지 더 지침을 보내려면 프롬프트를 전달합니다. `claude agents`로 세션을 모니터링합니다. 별칭: `/bg` |

324 다음 방법 중 하나를 사용할 수 있습니다:324 다음 방법 중 하나를 사용할 수 있습니다:

325 325 

326 1. Claude Code 창으로 이미지를 드래그 앤 드롭하기326 1. Claude Code 창으로 이미지를 드래그 앤 드롭하기

327 2. 이미지를 복사하고 ctrl+v로 CLI에 붙여넣기 (cmd+v 사용하지 않기)327 2. 이미지를 복사하고 Ctrl+V로 CLI에 붙여넣기. macOS에서는 iTerm2에서도 Cmd+V가 작동합니다.

328 3. Claude에 이미지 경로 제공하기. 예: "Analyze this image: /path/to/your/image.png"328 3. Claude에 이미지 경로 제공하기. 예: "Analyze this image: /path/to/your/image.png"

329 </Step>329 </Step>

330 330 

7> Claude Code CLI에서 컴퓨터 사용을 활성화하여 Claude가 macOS에서 앱을 열고, 클릭하고, 입력하고, 화면을 볼 수 있도록 합니다. 터미널을 떠나지 않고 네이티브 앱을 테스트하고, 시각적 문제를 디버깅하고, GUI 전용 도구를 자동화합니다.7> Claude Code CLI에서 컴퓨터 사용을 활성화하여 Claude가 macOS에서 앱을 열고, 클릭하고, 입력하고, 화면을 볼 수 있도록 합니다. 터미널을 떠나지 않고 네이티브 앱을 테스트하고, 시각적 문제를 디버깅하고, GUI 전용 도구를 자동화합니다.

8 8 

9<Note>9<Note>

10 {/* plan-availability: feature=computer-use plans=pro,max */}10 컴퓨터 사용은 Pro 또는 Max 플랜이 필요한 macOS의 연구 미리보기입니다. Team 또는 Enterprise 플랜에서는 사용할 수 없습니다. 대화형 세션이 필요하므로 `-p` 플래그를 사용한 비대화형 모드에서는 사용할 수 없습니다.

11 

12 컴퓨터 사용은 Pro 또는 Max 플랜이 필요한 macOS의 연구 미리보기입니다. Team 또는 Enterprise 플랜에서는 사용할 수 없습니다. Claude Code v2.1.85 이상이 필요하며 대화형 세션이 필요하므로 `-p` 플래그를 사용한 비대화형 모드에서는 사용할 수 없습니다.

13</Note>11</Note>

14 12 

15컴퓨터 사용을 통해 Claude는 앱을 열고, 화면을 제어하고, 사용자가 하는 방식으로 컴퓨터에서 작업할 수 있습니다. CLI에서 Claude는 Swift 앱을 컴파일하고, 실행하고, 모든 버튼을 클릭하고, 결과를 스크린샷하는 모든 작업을 코드를 작성한 동일한 대화에서 수행할 수 있습니다.13컴퓨터 사용을 통해 Claude는 앱을 열고, 화면을 제어하고, 사용자가 하는 방식으로 컴퓨터에서 작업할 수 있습니다. CLI에서 Claude는 Swift 앱을 컴파일하고, 실행하고, 모든 버튼을 클릭하고, 결과를 스크린샷하는 모든 작업을 코드를 작성한 동일한 대화에서 수행할 수 있습니다.

238서버는 적격 설정에서만 나타납니다. 다음을 확인합니다.236서버는 적격 설정에서만 나타납니다. 다음을 확인합니다.

239 237 

240* macOS를 사용 중입니다. 컴퓨터 사용은 Linux 또는 Windows에서 사용할 수 없습니다. Windows에서는 [Desktop의 컴퓨터 사용](/ko/desktop#let-claude-use-your-computer)을 대신 사용합니다.238* macOS를 사용 중입니다. 컴퓨터 사용은 Linux 또는 Windows에서 사용할 수 없습니다. Windows에서는 [Desktop의 컴퓨터 사용](/ko/desktop#let-claude-use-your-computer)을 대신 사용합니다.

241* Claude Code v2.1.85 이상을 실행 중입니다. `claude --version`을 실행하여 확인합니다.

242* Pro 또는 Max 플랜을 사용 중입니다. `/status`를 실행하여 구독을 확인합니다.239* Pro 또는 Max 플랜을 사용 중입니다. `/status`를 실행하여 구독을 확인합니다.

243* claude.ai를 통해 인증되었습니다. 컴퓨터 사용은 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry와 같은 타사 제공자에서 사용할 수 없습니다. 타사 제공자를 통해서만 Claude에 액세스하는 경우 이 기능을 사용하려면 별도의 claude.ai 계정이 필요합니다.240* claude.ai를 통해 인증되었습니다. 컴퓨터 사용은 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry와 같은 타사 제공자에서 사용할 수 없습니다. 타사 제공자를 통해서만 Claude에 액세스하는 경우 이 기능을 사용하려면 별도의 claude.ai 계정이 필요합니다.

244* 대화형 세션에 있습니다. 컴퓨터 사용은 `-p` 플래그를 사용한 비대화형 모드에서 사용할 수 없습니다.241* 대화형 세션에 있습니다. 컴퓨터 사용은 `-p` 플래그를 사용한 비대화형 모드에서 사용할 수 없습니다.

10 10 

11엔터프라이즈 배포 전반에 걸쳐 평균 비용은 개발자당 활성 일일 약 $13이며, 개발자당 월 $150-250이고, 90%의 사용자는 활성 일일 비용이 \$30 이하로 유지됩니다. 팀의 지출을 추정하려면 작은 파일럿 그룹으로 시작하고 아래의 추적 도구를 사용하여 더 광범위한 롤아웃 전에 기준선을 설정하십시오.11엔터프라이즈 배포 전반에 걸쳐 평균 비용은 개발자당 활성 일일 약 $13이며, 개발자당 월 $150-250이고, 90%의 사용자는 활성 일일 비용이 \$30 이하로 유지됩니다. 팀의 지출을 추정하려면 작은 파일럿 그룹으로 시작하고 아래의 추적 도구를 사용하여 더 광범위한 롤아웃 전에 기준선을 설정하십시오.

12 12 

13이 페이지에서는 [비용 추적 방법](#track-your-costs), [팀 비용 관리](#managing-costs-for-teams), [토큰 사용량 감소](#reduce-token-usage) 방법을 다룹니다.13이 페이지에서는 [비용 추적 방법](#track-your-costs), [팀 비용 관리](#manage-costs-for-your-organization), [토큰 사용량 감소](#reduce-token-usage) 방법을 다룹니다.

14 14 

15<h2 id="track-your-costs">15<h2 id="track-your-costs">

16 비용 추적16 비용 추적

37 37 

38[VS Code 확장](/ko/vs-code#check-account-and-usage)에서 동일한 분석이 Day 및 Week 토글이 있는 Account & usage 대화 상자에 나타납니다. Claude Code v2.1.174 이상이 필요합니다.38[VS Code 확장](/ko/vs-code#check-account-and-usage)에서 동일한 분석이 Day 및 Week 토글이 있는 Account & usage 대화 상자에 나타납니다. Claude Code v2.1.174 이상이 필요합니다.

39 39 

40<h2 id="managing-costs-for-teams">40<h3 id="set-a-spend-limit-on-pro-and-max">

41 팀 비용 관리41 Pro 및 Max에서 지출 한도 설정

42</h3>

43 

44Pro 및 Max 요금제에서는 `/usage-credits` 명령으로 사용량 크레딧에 대한 월간 지출 한도를 설정할 수 있습니다. 사용량 크레딧이 아직 남아 있는 상태에서 해당 한도에 도달하면 Claude Code는 한도를 높이거나 제거하라는 메시지를 표시하여 CLI를 떠나지 않고 계속 진행할 수 있습니다. 한도 변경에는 계정의 청구 액세스 권한이 필요합니다.

45 

46<h2 id="manage-costs-for-your-organization">

47 조직의 비용 관리

42</h2>48</h2>

43 49 

44Claude API를 사용할 때, 전체 Claude Code 워크스페이스 지출에 대해 [워크스페이스 지출 한도를 설정](https://platform.claude.com/docs/ko/build-with-claude/workspaces#workspace-limits)할 수 있습니다. 관리자는 Console에서 [비용 및 사용량 보고서를 볼 수 있습니다](https://platform.claude.com/docs/ko/build-with-claude/workspaces#usage-and-cost-tracking).50조직이 Claude Code에 액세스하는 방식에 따라 사용할 수 있는 제어 기능이 달라집니다: Claude for Teams 또는 Enterprise 플랜, Claude Console 또는 클라우드 제공자입니다. Teams 및 Enterprise 플랜에서는 사용량이 각 멤버의 시트 할당량에서 차감됩니다. Console 및 클라우드 제공자에서는 사용량이 토큰당 조직에 청구됩니다. 조직이 여러 로그인 방법을 혼합하는 경우, 각 개발자는 인증한 방법에 따라 측정됩니다.

51 

52표는 각 설정을 지출 확인 위치, 지출 상한선 위치 및 사용자별 수치 추출 방법에 매핑합니다.

53 

54| 설정 | 지출 확인 | 지출 상한선 | 사용자별 보고 |

55| :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------ | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

56| [Claude for Teams 또는 Enterprise](#claude-for-teams-and-enterprise) | [조직 분석의 지출 보고서](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans) | 관리자 설정의 지출 한도 | [지출 보고서 CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans); Enterprise의 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide) |

57| [Claude Console (API)](#claude-console) | [Console 사용량 페이지](https://platform.claude.com/usage) | 워크스페이스 지출 한도 | [Console 대시보드](https://platform.claude.com/claude-code), [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) |

58| [Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry](#cloud-providers) | 클라우드 청구 콘솔 | 클라우드의 예산 제어 | [OpenTelemetry](/ko/monitoring-usage) 또는 [LLM gateway](/ko/llm-gateway) |

59 

60[OpenTelemetry 내보내기](/ko/monitoring-usage)는 모든 설정에서 작동하며 사용자별 토큰 및 비용 메트릭을 거의 실시간으로 자체 관찰성 스택으로 스트리밍하는 유일한 옵션입니다.

45 61 

46Pro 및 Max 플랜에서는 `/usage-credits` 명령어를 사용하여 사용 크레딧에 대한 월간 지출 한도를 설정할 수 있습니다. 사용 크레딧이 아직 남아 있는 상태에서 해당 한도에 도달하면, Claude Code는 한도를 높이거나 제거하도록 요청하여 CLI를 떠나지 않고 계속 진행할 수 있도록 합니다. 한도를 변경하려면 계정에 대한 청구 액세스 권한이 필요합니다.62<h3 id="claude-for-teams-and-enterprise">

63 Claude for Teams 및 Enterprise

64</h3>

65 

66Claude for Teams 및 Enterprise 플랜에서 각 멤버의 Claude Code 사용량은 5시간 롤링 윈도우 및 주간 윈도우에서 재설정되는 시트당 할당량에서 차감됩니다. 할당량은 Claude 채팅 및 Cowork와 공유되며, 크기는 [시트 계층](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan)에 따라 달라집니다. 제어 기능은 Claude Console이 아닌 claude.ai 관리자 콘솔에 있습니다.

67 

68* **지출 확인**: [조직 분석의 지출 보고서](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)는 사용자별 및 모델별 예상 지출을 CSV 내보내기와 함께 매일 업데이트되는 형태로 표시합니다. 보고서는 사용 크레딧 지출을 포함하며 사용 크레딧이 활성화된 후에 나타납니다. 시트 할당량 내의 사용량은 달러로 측정되지 않습니다.

69* **채택 확인**: [분석 대시보드](https://claude.ai/analytics/claude-code)는 일일 활성 사용자, 세션 및 기여 메트릭을 CSV 내보내기와 함께 표시합니다. [분석으로 팀 사용량 추적](/ko/analytics)을 참조하십시오.

70* **지출 상한선**: 시트 할당량이 기본 상한선입니다. 멤버가 이를 초과하여 계속하도록 허용하려면 [사용 크레딧](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)을 활성화하고 조직, 그룹 또는 개별 멤버 수준에서 지출 한도를 설정하십시오.

71* **사용자별 수치 추출**: Enterprise 플랜에서 [Enterprise Analytics API](https://support.claude.com/en/articles/13703965-claude-enterprise-analytics-api-reference-guide)는 Claude Code를 포함한 Claude 전체 표면에서 사용자별 사용량 및 비용 보고서를 반환합니다. Primary Owner는 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys)에서 `read:analytics` 범위를 가진 키를 생성합니다. Teams 플랜에서는 [지출 보고서 CSV](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans)를 내보내십시오. 이는 사용자별 및 모델별 토큰 사용량 및 예상 지출을 나열합니다.

72 

73[Claude Enterprise 소비 가이드](https://support.claude.com/en/articles/14782391-claude-enterprise-consumption-guide)는 관리자를 위한 계획 참고 자료입니다. Claude 채팅, Claude Code 및 Cowork 전체에서 소비가 어떻게 다른지 설명하고 예산 책정을 위한 사용자별 달러 시작점을 제공합니다. 채팅 시트보다 코딩 시트에 더 많은 예산을 할당하십시오: 각 Claude Code 턴은 파일 내용, 도구 호출 및 다단계 추론을 포함하므로 하나의 디버깅 세션이 하루의 채팅보다 더 많이 소비할 수 있습니다.

74 

75<h3 id="claude-console">

76 Claude Console

77</h3>

78 

79API 조직은 [워크스페이스](https://platform.claude.com/docs/en/build-with-claude/workspaces)를 통해 Claude Code 지출을 관리합니다. [워크스페이스 지출 한도를 설정](https://platform.claude.com/docs/en/build-with-claude/workspaces#workspace-limits)하여 전체 Claude Code 지출을 제한하고 [Console에서 비용 및 사용량 보고서를 볼 수 있습니다](https://platform.claude.com/docs/en/build-with-claude/workspaces#usage-and-cost-tracking).

47 80 

48<Note>81<Note>

49 Claude Code를 Claude Console 계정으로 처음 인증할 때, "Claude Code"라는 워크스페이스가 자동으로 생성됩니다. 이 워크스페이스는 조직의 모든 Claude Code 사용에 대한 중앙 집중식 비용 추적 및 관리를 제공합니다. 이 워크스페이스에 대해 API 키를 생성할 수 없습니다. 이는 Claude Code 인증 및 사용 전용입니다.82 Claude Code를 Claude Console 계정으로 처음 인증할 때, "Claude Code"라는 워크스페이스가 자동으로 생성됩니다. 이 워크스페이스는 조직의 모든 Claude Code 사용에 대한 중앙 집중식 비용 추적 및 관리를 제공합니다. 이 워크스페이스에 대해 API 키를 생성할 수 없습니다. 이는 Claude Code 인증 및 사용 전용입니다.

51 사용자 정의 속도 제한이 있는 조직의 경우, 이 워크스페이스의 Claude Code 트래픽은 조직의 전체 API 속도 제한에 포함됩니다. Claude Console의 이 워크스페이스의 한도 페이지에서 [워크스페이스 속도 제한](https://platform.claude.com/docs/ko/api/rate-limits#setting-lower-limits-for-workspaces)을 설정하여 Claude Code의 할당량을 제한하고 다른 프로덕션 워크로드를 보호할 수 있습니다.84 사용자 정의 속도 제한이 있는 조직의 경우, 이 워크스페이스의 Claude Code 트래픽은 조직의 전체 API 속도 제한에 포함됩니다. Claude Console의 이 워크스페이스의 한도 페이지에서 [워크스페이스 속도 제한](https://platform.claude.com/docs/ko/api/rate-limits#setting-lower-limits-for-workspaces)을 설정하여 Claude Code의 할당량을 제한하고 다른 프로덕션 워크로드를 보호할 수 있습니다.

52</Note>85</Note>

53 86 

54Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry에서 Claude Code는 클라우드에서 메트릭을 전송하지 않습니다. 자체 호스팅된 [Claude apps gateway](/ko/claude-apps-gateway)는 사용자별 사용량 귀속, 토큰 수를 포함한 OTLP 메트릭, 그리고 이러한 제공자에 대한 [사용자별 지출 한도](/ko/claude-apps-gateway-spend-limits)를 제공합니다. 다른 [LLM gateway](/ko/llm-gateway)를 통해 Claude Code를 라우팅하는 조직은 게이트웨이가 모든 요청을 보기 때문에 그곳에서 지출을 추적할 수 있습니다.87사용자별 보고의 경우, [Console 대시보드](https://platform.claude.com/claude-code)는 멤버별 지출 및 수락된 라인을 표시하고, [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api)는 [Admin API 키](https://platform.claude.com/settings/admin-keys)를 사용하여 동일한 일일 사용자별 메트릭을 프로그래밍 방식으로 반환합니다. [API 고객을 위한 분석](/ko/analytics#access-analytics-for-api-customers)을 참조하십시오.

55 88 

56<h3 id="rate-limit-recommendations">89<h4 id="rate-limit-recommendations">

57 속도 제한 권장사항90 속도 제한 권장사항

58</h3>91</h4>

59 92 

60팀을 위해 Claude Code를 설정할 때, 조직 규모에 따른 다음 분당 토큰(TPM) 및 분당 요청(RPM) 사용자당 권장사항을 고려하십시오:93팀을 위해 Claude Code를 설정할 때, 조직 규모에 따른 다음 분당 토큰(TPM) 및 분당 요청(RPM) 사용자당 권장사항을 고려하십시오:

61 94 

76 대규모 그룹과의 라이브 교육 세션과 같이 비정상적으로 높은 동시 사용 시나리오를 예상하는 경우, 사용자당 더 높은 TPM 할당이 필요할 수 있습니다.109 대규모 그룹과의 라이브 교육 세션과 같이 비정상적으로 높은 동시 사용 시나리오를 예상하는 경우, 사용자당 더 높은 TPM 할당이 필요할 수 있습니다.

77</Note>110</Note>

78 111 

112<h3 id="cloud-providers">

113 클라우드 제공자

114</h3>

115 

116Amazon Bedrock, Google Cloud의 Agent Platform 및 Microsoft Foundry에서 Claude Code는 클라우드 계정에 토큰당 청구되며, 지출 제어는 클라우드 제공자의 청구 콘솔에 있습니다. Claude Code는 클라우드에서 Anthropic으로 메트릭을 전송하지 않으므로, [분석 대시보드](/ko/analytics) 및 Claude Code Analytics API는 이 사용량을 포함하지 않습니다.

117 

118사용자별 비용 귀속의 경우 세 가지 옵션이 있습니다:

119 

120* **OpenTelemetry**: 각 개발자의 머신에서 자체 관찰성 스택으로 [메트릭을 내보냅니다](/ko/monitoring-usage). 이는 제공자와 관계없이 사용자별 토큰 수, 비용 및 도구 활동을 제공합니다.

121* **Claude apps gateway**: 자체 호스팅된 [Claude apps gateway](/ko/claude-apps-gateway)는 사용자별 사용량 귀속, 토큰 수를 포함한 OTLP 메트릭 및 이러한 제공자에 대한 [사용자별 지출 한도](/ko/claude-apps-gateway-spend-limits)를 제공합니다.

122* **LLM gateway**: 모든 Claude Code 트래픽을 키별 지출을 추적하는 프록시를 통해 라우팅합니다. 여러 대규모 엔터프라이즈는 [LiteLLM](/ko/llm-gateway)을 사용하고 있으며, 이는 [키별 지출을 추적](https://docs.litellm.ai/docs/proxy/virtual_keys#tracking-spend)하는 오픈 소스 도구입니다. 이 프로젝트는 Anthropic과 무관하며 보안 감사를 받지 않았습니다.

123 

124<h3 id="when-a-developer-asks-about-a-limit">

125 개발자가 한도에 대해 질문할 때

126</h3>

127 

128개발자는 일반적으로 한도 질문을 관리자에게 가져오므로, 어떤 상한선에 도달했는지 아는 것이 도움이 됩니다. 세 가지 상황은 다른 의미를 가집니다:

129 

130* **"세션 한도에 도달했습니다" 또는 "주간 한도에 도달했습니다"**: 구독 플랜의 시트 기반 사용 윈도우입니다. 이러한 윈도우는 모든 모델에서 공유되므로 `/model`로 모델을 전환해도 액세스가 복원되지 않지만, 모델별 "Opus 한도에 도달했습니다" 메시지 후에도 개발자가 계속 작업할 수 있습니다. 메시지는 윈도우가 재설정될 때를 표시하며, 개발자는 [사용 크레딧](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)이 활성화된 경우 `/usage-credits`를 실행하여 할당량을 초과하는 사용을 요청할 수 있습니다. [사용 한도 오류](/ko/errors#youve-hit-your-session-limit)를 참조하십시오.

131* **컨텍스트 또는 자동 압축 경고**: 사용 한도가 아닙니다. 대화가 모델의 최대 입력 크기에 가까워졌으며, Claude Code는 공간을 확보하기 위해 이전 기록을 요약합니다. 개발자를 [토큰 사용량 감소](#reduce-token-usage)로 안내하십시오.

132* **API 또는 클라우드 제공자 플랜에서 예상치 못한 높은 지출**: 일반적으로 절대 지워지지 않은 긴 세션 또는 기본 모델로 남겨진 Opus로 추적됩니다. 공유할 가장 영향력 있는 습관은 관련 없는 작업 간 지우기 및 작업에 맞는 모델 선택이며, 둘 다 [토큰 사용량 감소](#reduce-token-usage)에서 다룹니다.

133 

79<h3 id="agent-team-token-costs">134<h3 id="agent-team-token-costs">

80 에이전트 팀 토큰 비용135 에이전트 팀 토큰 비용

81</h3>136</h3>

19 19 

20이 페이지에서는 [링크를 빌드하는 방법](#build-a-link), [런북에 포함하거나 셸에서 트리거하는 방법](#examples), 그리고 [각 플랫폼에서 핸들러 등록을 관리하거나 비활성화하는 방법](#registration-and-supported-platforms)을 다룹니다.20이 페이지에서는 [링크를 빌드하는 방법](#build-a-link), [런북에 포함하거나 셸에서 트리거하는 방법](#examples), 그리고 [각 플랫폼에서 핸들러 등록을 관리하거나 비활성화하는 방법](#registration-and-supported-platforms)을 다룹니다.

21 21 

22<Note>

23 딥 링크는 Claude Code v2.1.91 이상이 필요합니다.

24</Note>

25 

26<h2 id="how-it-works">22<h2 id="how-it-works">

27 작동 방식23 작동 방식

28</h2>24</h2>

44 44 

45첫 번째 메시지를 보내기 전에 프롬프트 영역에서 네 가지를 구성하세요:45첫 번째 메시지를 보내기 전에 프롬프트 영역에서 네 가지를 구성하세요:

46 46 

47* **환경**: Claude가 실행되는 위치를 선택합니다. 자신의 머신의 경우 **Local**, Anthropic 호스팅 클라우드 세션의 경우 **Remote**, 관리하는 원격 머신의 경우 [**SSH 연결**](#ssh-sessions)을 선택합니다. [환경 구성](#environment-configuration)을 참조하세요.47* **환경**: Claude가 실행되는 위치를 선택합니다. 자신의 머신의 경우 **Local**, Anthropic 호스팅 클라우드 세션의 경우 **Remote**, 관리하는 원격 머신의 경우 [**SSH 연결**](#ssh-sessions)을 선택하거나, Windows의 경우 [**WSL 배포판**](/ko/desktop-wsl)을 선택합니다. [환경 구성](#environment-configuration)을 참조하세요.

48* **프로젝트 폴더**: Claude가 작업할 폴더 또는 저장소를 선택합니다. 원격 세션의 경우 [여러 저장소](#run-long-running-tasks-remotely)를 추가할 수 있습니다.48* **프로젝트 폴더**: Claude가 작업할 폴더 또는 저장소를 선택합니다. 원격 세션의 경우 [여러 저장소](#run-long-running-tasks-remotely)를 추가할 수 있습니다.

49* **모델**: 전송 버튼 옆의 드롭다운에서 [모델](/ko/model-config#available-models)을 선택합니다. 세션 중에 이를 변경할 수 있습니다.49* **모델**: 전송 버튼 옆의 드롭다운에서 [모델](/ko/model-config#available-models)을 선택합니다. 세션 중에 이를 변경할 수 있습니다.

50* **권한 모드**: [모드 선택기](#choose-a-permission-mode)에서 Claude가 가질 자율성을 선택합니다. 세션 중에 이를 변경할 수 있습니다.50* **권한 모드**: [모드 선택기](#choose-a-permission-mode)에서 Claude가 가질 자율성을 선택합니다. 세션 중에 이를 변경할 수 있습니다.

71 71 

72프롬프트 상자는 외부 컨텍스트를 가져오는 두 가지 방법을 지원합니다:72프롬프트 상자는 외부 컨텍스트를 가져오는 두 가지 방법을 지원합니다:

73 73 

74* **@mention 파일**: `@` 다음에 파일 이름을 입력하여 파일을 대화 컨텍스트에 추가합니다. Claude는 그 파일을 읽고 참조할 수 있습니다. @mention은 클라우드 세션에서 사용할 수 없습니다.74* **@mention 파일**: `@` 다음에 파일 이름을 입력하여 파일을 대화 컨텍스트에 추가합니다. Claude는 그 파일을 읽고 참조할 수 있습니다. @mention은 클라우드 또는 WSL 세션에서 사용할 수 없습니다.

75* **파일 첨부**: 첨부 버튼을 사용하여 이미지, PDF 및 기타 파일을 프롬프트에 첨부하거나, 파일을 프롬프트에 직접 드래그 앤 드롭합니다. 이는 버그 스크린샷, 디자인 목업 또는 참고 문서를 공유하는 데 유용합니다.75* **파일 첨부**: 첨부 버튼을 사용하여 이미지, PDF 및 기타 파일을 프롬프트에 첨부하거나, 파일을 프롬프트에 직접 드래그 앤 드롭합니다. 이는 버그 스크린샷, 디자인 목업 또는 참고 문서를 공유하는 데 유용합니다.

76 76 

77<h3 id="choose-a-permission-mode">77<h3 id="choose-a-permission-mode">

385 385 

386사이드 채팅을 사용하면 세션의 컨텍스트를 사용하지만 메인 대화에 아무것도 추가하지 않고 Claude에게 질문할 수 있습니다. 코드 조각을 이해하거나, 가정을 확인하거나, 세션을 벗어나지 않고 아이디어를 탐색하려고 할 때 사용합니다.386사이드 채팅을 사용하면 세션의 컨텍스트를 사용하지만 메인 대화에 아무것도 추가하지 않고 Claude에게 질문할 수 있습니다. 코드 조각을 이해하거나, 가정을 확인하거나, 세션을 벗어나지 않고 아이디어를 탐색하려고 할 때 사용합니다.

387 387 

388macOS에서 \*\*Cmd+;\*\*를 누르거나 Windows에서 \*\*Ctrl+;\*\*를 누르거나 프롬프트 상자에 `/btw`를 입력하여 사이드 채팅을 엽니다. 사이드 채팅은 그 지점까지 메인 스레드의 모든 것을 읽을 수 있습니다. 완료되면 사이드 채팅을 닫고 중단한 곳에서 메인 세션을 계속합니다. 사이드 채팅은 로컬 및 SSH 세션에서 사용 가능합니다.388macOS에서 \*\*Cmd+;\*\*를 누르거나 Windows에서 \*\*Ctrl+;\*\*를 누르거나 프롬프트 상자에 `/btw`를 입력하여 사이드 채팅을 엽니다. 사이드 채팅은 그 지점까지 메인 스레드의 모든 것을 읽을 수 있습니다. 완료되면 사이드 채팅을 닫고 중단한 곳에서 메인 세션을 계속합니다. 사이드 채팅은 로컬, SSH 및 WSL 세션에서 사용 가능합니다.

389 389 

390<h3 id="watch-background-tasks">390<h3 id="watch-background-tasks">

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

440 외부 도구 연결하기440 외부 도구 연결하기

441</h3>441</h3>

442 442 

443로컬 및 [SSH](#ssh-sessions) 세션의 경우 프롬프트 상자 옆의 **+** 버튼을 클릭하고 **Connectors**를 선택하여 Google Calendar, Slack, GitHub, Linear, Notion 등과 같은 통합을 추가합니다. 세션 전이나 중에 커넥터를 추가할 수 있습니다. **+** 버튼은 클라우드 세션에서 사용할 수 없지만 [루틴](/ko/routines)은 루틴 생성 시 커넥터를 구성합니다.443로컬 및 [SSH](#ssh-sessions) 세션의 경우 프롬프트 상자 옆의 **+** 버튼을 클릭하고 **Connectors**를 선택하여 Google Calendar, Slack, GitHub, Linear, Notion 등과 같은 통합을 추가합니다. 세션 전이나 중에 커넥터를 추가할 수 있습니다. **+** 버튼은 클라우드 또는 WSL 세션에서 사용할 수 없지만 [루틴](/ko/routines)은 루틴 생성 시 커넥터를 구성합니다.

444 444 

445커넥터를 관리하거나 연결을 해제하려면 데스크톱 앱의 Settings → Connectors로 이동하거나 프롬프트 상자의 Connectors 메뉴에서 **Manage connectors**를 선택합니다.445커넥터를 관리하거나 연결을 해제하려면 데스크톱 앱의 Settings → Connectors로 이동하거나 프롬프트 상자의 Connectors 메뉴에서 **Manage connectors**를 선택합니다.

446 446 

462 462 

463로컬 및 [SSH](#ssh-sessions) 세션의 경우 프롬프트 상자 옆의 **+** 버튼을 클릭하고 **Plugins**를 선택하여 설치된 플러그인과 해당 skills를 봅니다. 플러그인을 추가하려면 서브메뉴에서 **Add plugin**을 선택하여 플러그인 브라우저를 열면 공식 Anthropic marketplace를 포함한 구성된 [marketplaces](/ko/plugin-marketplaces)의 사용 가능한 플러그인이 표시됩니다. **Manage plugins**를 선택하여 플러그인을 활성화, 비활성화 또는 제거합니다.463로컬 및 [SSH](#ssh-sessions) 세션의 경우 프롬프트 상자 옆의 **+** 버튼을 클릭하고 **Plugins**를 선택하여 설치된 플러그인과 해당 skills를 봅니다. 플러그인을 추가하려면 서브메뉴에서 **Add plugin**을 선택하여 플러그인 브라우저를 열면 공식 Anthropic marketplace를 포함한 구성된 [marketplaces](/ko/plugin-marketplaces)의 사용 가능한 플러그인이 표시됩니다. **Manage plugins**를 선택하여 플러그인을 활성화, 비활성화 또는 제거합니다.

464 464 

465플러그인은 사용자 계정, 특정 프로젝트 또는 로컬 전용으로 범위를 지정할 수 있습니다. 조직이 플러그인을 중앙에서 관리하는 경우 해당 플러그인은 CLI에서와 동일한 방식으로 데스크톱 세션에서 사용 가능합니다. 플러그인은 클라우드 세션에는 사용할 수 없습니다. 자신의 플러그인을 만드는 것을 포함한 전체 플러그인 참조는 [plugins](/ko/plugins)를 참조하세요.465플러그인은 사용자 계정, 특정 프로젝트 또는 로컬 전용으로 범위를 지정할 수 있습니다. 조직이 플러그인을 중앙에서 관리하는 경우 해당 플러그인은 CLI에서와 동일한 방식으로 데스크톱 세션에서 사용 가능합니다. 플러그인은 클라우드 또는 WSL 세션에는 사용할 수 없습니다. 자신의 플러그인을 만드는 것을 포함한 전체 플러그인 참조는 [plugins](/ko/plugins)를 참조하세요.

466 466 

467<h3 id="configure-preview-servers">467<h3 id="configure-preview-servers">

468 미리보기 서버 구성하기468 미리보기 서버 구성하기

628* **Local**: 머신에서 실행되며 파일에 직접 액세스합니다628* **Local**: 머신에서 실행되며 파일에 직접 액세스합니다

629* **Remote**: Anthropic의 클라우드 인프라에서 실행됩니다. 앱을 닫아도 세션이 계속됩니다.629* **Remote**: Anthropic의 클라우드 인프라에서 실행됩니다. 앱을 닫아도 세션이 계속됩니다.

630* **SSH**: SSH를 통해 연결하는 원격 머신(예: 자신의 서버, 클라우드 VM 또는 개발 컨테이너)에서 실행됩니다630* **SSH**: SSH를 통해 연결하는 원격 머신(예: 자신의 서버, 클라우드 VM 또는 개발 컨테이너)에서 실행됩니다

631* **WSL** (Windows): 머신의 [WSL 2 배포판](/ko/desktop-wsl)에서 실행되며, Linux 도구 모음 및 기본 경로를 사용합니다

631 632 

632<h3 id="local-sessions">633<h3 id="local-sessions">

633 로컬 세션634 로컬 세션

72 72 

73 * **Remote**: Anthropic의 클라우드 인프라에서 세션을 실행하며, 앱을 닫아도 계속됩니다. 클라우드 세션은 [웹의 Claude Code](/ko/claude-code-on-the-web)와 동일한 인프라를 사용합니다.73 * **Remote**: Anthropic의 클라우드 인프라에서 세션을 실행하며, 앱을 닫아도 계속됩니다. 클라우드 세션은 [웹의 Claude Code](/ko/claude-code-on-the-web)와 동일한 인프라를 사용합니다.

74 * **SSH**: SSH를 통해 원격 머신(자신의 서버, 클라우드 VM 또는 dev 컨테이너)에 연결합니다. Desktop은 처음 연결할 때 원격 머신에 Claude Code를 자동으로 설치합니다.74 * **SSH**: SSH를 통해 원격 머신(자신의 서버, 클라우드 VM 또는 dev 컨테이너)에 연결합니다. Desktop은 처음 연결할 때 원격 머신에 Claude Code를 자동으로 설치합니다.

75 * **WSL** (Windows): [WSL 2 배포판](/ko/desktop-wsl) 내에서 세션을 실행합니다. Claude Code, 도구 및 git은 Linux 측에서 기본 경로로 실행됩니다.

75 </Step>76 </Step>

76 77 

77 <Step title="모델 선택">78 <Step title="모델 선택">

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# WSL의 Claude Code Desktop

6 

7> WSL 2 배포판 내에서 Code 세션 실행

8 

9Windows에서 Code 탭은 Windows 자체가 아닌 WSL 2 배포판 내에서 세션을 실행할 수 있습니다. 세션의 Claude Code 프로세스, 해당 도구 및 git은 모두 배포판 내에서 실행되며, 해당 배포판의 Linux 도구 체인과 기본 Linux 경로를 사용하여 프로젝트가 대상으로 하는 동일한 환경에서 실행됩니다.

10 

11저장소가 배포판의 파일 시스템 내에 있을 때 WSL 세션을 사용합니다. Windows에서 해당 파일을 작업하면 네트워크 파일 시스템을 통해 진행되므로 속도가 느리고 파일 감시가 중단됩니다. 배포판 내에서 세션을 실행하면 둘 다 피할 수 있습니다.

12 

13<h2 id="requirements">

14 요구 사항

15</h2>

16 

17* [WSL 2](https://learn.microsoft.com/windows/wsl/install)가 설치된 Windows 10 또는 11. WSL 1은 지원되지 않습니다.

18* 설치된 배포판이 최소 하나 이상 필요합니다(예: Ubuntu).

19* 배포판 내에 `git`이 설치되어 있어야 합니다.

20 

21<h2 id="start-a-wsl-session">

22 WSL 세션 시작

23</h2>

24 

25<Steps>

26 <Step title="배포판 선택">

27 Code 탭에서 새 세션을 시작하고 환경 선택기를 엽니다. 설치된 WSL 2 배포판이 **WSL** 섹션에 나타납니다. 하나를 선택합니다.

28 </Step>

29 

30 <Step title="폴더 선택">

31 세션은 배포판의 홈 디렉터리에서 시작됩니다. 폴더 선택기를 사용하여 프로젝트 폴더를 선택합니다. 검색은 배포판 내에서 진행되며 `/home/you/project`와 같은 Linux 경로를 사용합니다.

32 </Step>

33 

34 <Step title="폴더 신뢰">

35 폴더의 첫 번째 세션에는 작업 영역 신뢰 대화 상자가 표시됩니다. 신뢰는 배포판 및 폴더별로 부여됩니다. 한 배포판의 폴더를 신뢰하는 것이 다른 배포판이나 Windows의 동일한 경로에 적용되지는 않습니다.

36 </Step>

37</Steps>

38 

39배포판의 첫 번째 세션은 Claude가 내부에 설정되는 동안 약간 더 오래 걸립니다. 일반 폴더 선택기에서 `\\wsl.localhost\...` 폴더를 열 수도 있으며, 해당 배포판 내에서 다시 열립니다.

40 

41최근에 사용한 폴더는 배포판별로 선택기에 나타나므로 프로젝트에 다시 연결하는 것은 한 번의 클릭입니다.

42 

43<h2 id="what-works-in-a-wsl-session">

44 WSL 세션에서 작동하는 기능

45</h2>

46 

47병렬 세션, 측면 채팅, 시각적 diff 검토, 분기 및 풀 요청 상태, worktrees는 모두 배포판 내의 git 및 도구 체인으로 지원됩니다. "편집기에서 열기"는 [Remote - WSL](https://code.visualstudio.com/docs/remote/wsl)을 통해 배포판에 연결된 VS Code를 엽니다.

48 

49WSL 세션에서 아직 사용할 수 없는 몇 가지 기능이 있습니다. 통합 터미널, 커넥터 및 플러그인, 세션 포킹, 파일 브라우저 창, 그리고 작성기에서 `@`를 입력할 때의 파일 제안입니다.

50 

51<h2 id="managed-devices">

52 관리되는 디바이스

53</h2>

54 

55조직에서 관리하는 디바이스에서는 WSL 세션을 사용할 수 없을 수 있습니다. 세션 시작이 디바이스가 관리된다는 메시지와 함께 실패하면 이는 관리자가 제어합니다. 관리자: 배포 가이드의 [설정이 디바이스에 도달하는 방식 결정](/ko/admin-setup#decide-how-settings-reach-devices)을 참조하세요.

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

177| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M 컨텍스트 윈도우](/ko/model-config#extended-context) 지원을 비활성화하려면 `1`로 설정합니다. 설정하면 1M 모델 변형을 모델 선택기에서 사용할 수 없습니다. [Sonnet 5](/ko/model-config#sonnet-5-context-window) 세션은 200K 윈도우를 가진 것으로 취급됩니다. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. |177| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M 컨텍스트 윈도우](/ko/model-config#extended-context) 지원을 비활성화하려면 `1`로 설정합니다. 설정하면 1M 모델 변형을 모델 선택기에서 사용할 수 없습니다. [Sonnet 5](/ko/model-config#sonnet-5-context-window) 세션은 200K 윈도우를 가진 것으로 취급됩니다. 규정 준수 요구 사항이 있는 엔터프라이즈 환경에 유용합니다. |

178| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 및 Sonnet 4.6에 대해 [적응형 추론](/ko/model-config#adjust-effort-level)을 비활성화하려면 `1`로 설정합니다. `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 돌아갑니다. {/* min-version: 2.1.111 */}v2.1.111부터 Fable 5, Sonnet 5, Opus 4.7 이상에는 효과가 없으며, 항상 적응형 추론을 사용합니다. |178| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 및 Sonnet 4.6에 대해 [적응형 추론](/ko/model-config#adjust-effort-level)을 비활성화하려면 `1`로 설정합니다. `MAX_THINKING_TOKENS`로 제어되는 고정 사고 예산으로 돌아갑니다. {/* min-version: 2.1.111 */}v2.1.111부터 Fable 5, Sonnet 5, Opus 4.7 이상에는 효과가 없으며, 항상 적응형 추론을 사용합니다. |

179| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}[어드바이저 도구](/ko/advisor)를 비활성화하려면 `1`로 설정합니다. `/advisor` 명령 및 `--advisor` 플래그를 사용할 수 없게 되고 구성된 `advisorModel`은 무시됩니다. Claude Code v2.1.98 이상이 필요합니다. |179| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [어드바이저 도구](/ko/advisor)를 비활성화하려면 `1`로 설정합니다. `/advisor` 명령을 사용할 수 없게 되고 구성된 `advisorModel`은 무시되며, `--advisor` 플래그는 허용되지만 효과가 없으므로 기존 스크립트가 오류 없이 계속 작동합니다. |

180| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [백그라운드 에이전트 및 에이전트 보기](/ko/agent-view)를 끄려면 `1`로 설정합니다: `claude agents`, `--bg`, `/background`, 온디맨드 감독자. [`disableAgentView`](/ko/settings#available-settings) 설정과 동일합니다. |180| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [백그라운드 에이전트 및 에이전트 보기](/ko/agent-view)를 끄려면 `1`로 설정합니다: `claude agents`, `--bg`, `/background`, 온디맨드 감독자. [`disableAgentView`](/ko/settings#available-settings) 설정과 동일합니다. |

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

182| `CLAUDE_CODE_DISABLE_ARTIFACT` | [아티팩트](/ko/artifacts) 도구를 비활성화하려면 `1`로 설정합니다. 이는 세션 출력을 claude.ai의 비공개 웹 페이지로 게시합니다. [`disableArtifact`](/ko/settings#available-settings) 설정과 동일합니다. |182| `CLAUDE_CODE_DISABLE_ARTIFACT` | [아티팩트](/ko/artifacts) 도구를 비활성화하려면 `1`로 설정합니다. 이는 세션 출력을 claude.ai의 비공개 웹 페이지로 게시합니다. [`disableArtifact`](/ko/settings#available-settings) 설정과 동일합니다. |

185| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Bash 및 subagent 도구의 `run_in_background` 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화하려면 `1`로 설정합니다. |185| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Bash 및 subagent 도구의 `run_in_background` 매개변수, 자동 백그라운드 처리, Ctrl+B 단축키를 포함한 모든 백그라운드 작업 기능을 비활성화하려면 `1`로 설정합니다. |

186| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}[백그라운드 세션](/ko/agent-view)의 실행 중인 백그라운드 셸 명령, 동적 워크플로우, {/* min-version: 2.1.198 */}v2.1.198부터 백그라운드 subagent를 [감독자](/ko/agent-view#the-supervisor-process)가 중지, 재시작 또는 해당 세션의 프로세스를 업데이트할 때 중지하려면 `1`로 설정합니다. 대신 다음 프로세스로 전달하는 대신입니다. 이 핸드오프에만 영향을 줍니다: `←` 또는 [`/background`](/ko/agent-view#from-inside-a-session)로 세션을 백그라운드 처리하면 여전히 진행 중인 작업을 수행하고, `CLAUDE_DISABLE_ADOPT`는 둘 다 끕니다. Claude Code v2.1.196 이상이 필요합니다. |186| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | {/* min-version: 2.1.196 */}[백그라운드 세션](/ko/agent-view)의 실행 중인 백그라운드 셸 명령, 동적 워크플로우, {/* min-version: 2.1.198 */}v2.1.198부터 백그라운드 subagent를 [감독자](/ko/agent-view#the-supervisor-process)가 중지, 재시작 또는 해당 세션의 프로세스를 업데이트할 때 중지하려면 `1`로 설정합니다. 대신 다음 프로세스로 전달하는 대신입니다. 이 핸드오프에만 영향을 줍니다: `←` 또는 [`/background`](/ko/agent-view#from-inside-a-session)로 세션을 백그라운드 처리하면 여전히 진행 중인 작업을 수행하고, `CLAUDE_DISABLE_ADOPT`는 둘 다 끕니다. Claude Code v2.1.196 이상이 필요합니다. |

187| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}운영 체제가 메모리 압력을 보고할 때 Claude Code가 [백그라운드 셸 명령](/ko/interactive-mode#background-bash-commands)을 종료하지 않도록 하려면 `1`로 설정합니다. 기본적으로 macOS 및 Linux에서 Claude Code는 세션이 30분 동안 유휴 상태이고 턴 또는 subagent가 실행 중이 아닐 때 메모리 압력 신호에서 주 세션에서 시작된 백그라운드 셸을 종료합니다. Windows에는 메모리 압력 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다. |187| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | {/* min-version: 2.1.193 */}운영 체제가 메모리 압력을 보고할 때 Claude Code가 [백그라운드 셸 명령](/ko/interactive-mode#background-bash-commands)을 종료하지 않도록 하려면 `1`로 설정합니다. 기본적으로 macOS 및 Linux에서 Claude Code는 세션이 30분 동안 유휴 상태이고 턴 또는 subagent가 실행 중이 아닐 때 메모리 압력 신호에서 주 세션에서 시작된 백그라운드 셸을 종료합니다. Windows에는 메모리 압력 신호가 없으므로 이 변수는 효과가 없습니다. Claude Code v2.1.193 이상이 필요합니다. |

188| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code와 함께 제공되는 [skill](/ko/skills) 및 워크플로우를 비활성화하려면 `1`로 설정합니다: 번들 skill 및 워크플로우는 완전히 제거되고, `/init`과 같은 기본 제공 슬래시 명령은 입력 가능하지만 모델에서 숨겨집니다. `/doctor`는 기본 제공 명령처럼 입력 가능하지만 `DISABLE_DOCTOR_COMMAND`로 숨길 수 있습니다. 플러그인, `.claude/skills/`, `.claude/commands/`의 skill은 영향을 받지 않습니다. [`disableBundledSkills`](/ko/settings#available-settings) 설정과 동일합니다. `0`은 이를 재정의하지 않습니다. |188| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code와 함께 제공되는 [skill](/ko/skills) 및 워크플로우를 비활성화하려면 `1`로 설정합니다: 번들 skill 및 워크플로우는 완전히 제거되고, `/init`과 같은 기본 제공 명령은 입력 가능하지만 모델에서 숨겨집니다. `/doctor`는 기본 제공 명령처럼 입력 가능하지만 `DISABLE_DOCTOR_COMMAND`로 숨길 수 있습니다. 플러그인, `.claude/skills/`, `.claude/commands/`의 skill은 영향을 받지 않습니다. [`disableBundledSkills`](/ko/settings#available-settings) 설정과 동일합니다. `0`은 이를 재정의하지 않습니다. |

189| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 사용자, 프로젝트, 자동 메모리 파일을 포함한 모든 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않으려면 `1`로 설정합니다. |189| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | 사용자, 프로젝트, 자동 메모리 파일을 포함한 모든 CLAUDE.md 메모리 파일을 컨텍스트에 로드하지 않으려면 `1`로 설정합니다. |

190| `CLAUDE_CODE_DISABLE_CRON` | [예약된 작업](/ko/scheduled-tasks)을 비활성화하려면 `1`로 설정합니다. `/loop` skill과 cron 도구를 사용할 수 없게 되고 이미 예약된 모든 작업이 중지되며, 세션 중에 이미 실행 중인 작업을 포함한 모든 작업이 실행되지 않습니다. |190| `CLAUDE_CODE_DISABLE_CRON` | [예약된 작업](/ko/scheduled-tasks)을 비활성화하려면 `1`로 설정합니다. `/loop` skill과 cron 도구를 사용할 수 없게 되고 이미 예약된 모든 작업이 중지되며, 세션 중에 이미 실행 중인 작업을 포함한 모든 작업이 실행되지 않습니다. |

191| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 특정 `anthropic-beta` 요청 헤더 및 베타 도구 스키마 필드(`defer_loading` 및 `eager_input_streaming` 등)를 API 요청에서 제거하려면 `1`로 설정합니다. 프록시 게이트웨이가 "Unexpected value(s) for the `anthropic-beta` header" 또는 "Extra inputs are not permitted"와 같은 오류로 요청을 거부할 때 사용합니다. 표준 필드(`name`, `description`, `input_schema`, `cache_control`)는 유지됩니다. |191| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 특정 `anthropic-beta` 요청 헤더 및 베타 도구 스키마 필드(`defer_loading` 및 `eager_input_streaming` 등)를 API 요청에서 제거하려면 `1`로 설정합니다. 프록시 게이트웨이가 "Unexpected value(s) for the `anthropic-beta` header" 또는 "Extra inputs are not permitted"와 같은 오류로 요청을 거부할 때 사용합니다. 표준 필드(`name`, `description`, `input_schema`, `cache_control`)는 유지됩니다. |

222| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [에이전트 팀](/ko/agent-teams)을 활성화하려면 `1`로 설정합니다. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다. |222| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [에이전트 팀](/ko/agent-teams)을 활성화하려면 `1`로 설정합니다. 에이전트 팀은 실험적이며 기본적으로 비활성화됩니다. |

223| `CLAUDE_CODE_EXTRA_BODY` | 모든 API 요청 본문의 최상위 수준으로 병합할 JSON 객체입니다. Claude Code가 직접 노출하지 않는 공급자 특정 매개변수를 전달하는 데 유용합니다. |223| `CLAUDE_CODE_EXTRA_BODY` | 모든 API 요청 본문의 최상위 수준으로 병합할 JSON 객체입니다. Claude Code가 직접 노출하지 않는 공급자 특정 매개변수를 전달하는 데 유용합니다. |

224| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다. |224| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | 파일 읽기의 기본 토큰 제한을 재정의합니다. 전체 파일을 읽어야 할 때 유용합니다. |

225| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {{/* min-version: 2.1.172 */}}이 `claude`가 다른 Claude Code 세션 내부에서 시작되었을 때에도 트랜스크립트 지속성, 프롬프트 기록, `claude agents` 등록을 강제하려면 `1`로 설정합니다. 예를 들어 Claude Code의 Bash 도구에서 처음 시작된 tmux 서버에서 상속된 `CLAUDE_CODE_CHILD_SESSION` 값이 진정한 최상위 세션을 중첩으로 잘못 분류할 때 사용합니다. {{/* min-version: 2.1.178 */}}v2.1.178부터 Claude Code는 tmux 경우를 자동으로 감지하고 상속된 마커를 무시하므로 tmux는 더 이상 이 변수가 필요하지 않습니다. v2.1.169 이상에서도 인정됩니다. v2.1.170 및 v2.1.171에서는 효과가 없으며, 이를 재정의한 중첩 세션 감지가 제거되었습니다. |225| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}이 `claude`가 다른 Claude Code 세션 내부에서 시작되었을 때에도 트랜스크립트 지속성, 프롬프트 기록, `claude agents` 등록을 강제하려면 `1`로 설정합니다. 예를 들어 Claude Code의 Bash 도구에서 처음 시작된 tmux 서버에서 상속된 `CLAUDE_CODE_CHILD_SESSION` 값이 진정한 최상위 세션을 중첩으로 잘못 분류할 때 사용합니다. {/* min-version: 2.1.178 */}v2.1.178부터 Claude Code는 tmux 경우를 자동으로 감지하고 상속된 마커를 무시하므로 tmux는 더 이상 이 변수가 필요하지 않습니다. v2.1.169 이상에서도 인정됩니다. v2.1.170 및 v2.1.171에서는 효과가 없으며, 이를 재정의한 중첩 세션 감지가 제거되었습니다. |

226| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {{/* min-version: 2.1.186 */}}터미널이 지원하지만 자동 감지되지 않을 때 Claude의 응답에서 `~~text~~`에 대한 취소선 렌더링을 강제하려면 `1`로 설정합니다. SSH를 통해 `TERM_PROGRAM`이 전달되지 않는 경우와 같습니다. 이 없으면 감지되지 않은 터미널은 취소선으로 렌더링하는 대신 리터럴 `~~` 마커를 표시합니다. Claude Code v2.1.186 이상이 필요합니다. |226| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}터미널이 지원하지만 자동 감지되지 않을 때 Claude의 응답에서 `~~text~~`에 대한 취소선 렌더링을 강제하려면 `1`로 설정합니다. SSH를 통해 `TERM_PROGRAM`이 전달되지 않는 경우와 같습니다. 이 없으면 감지되지 않은 터미널은 취소선으로 렌더링하는 대신 리터럴 `~~` 마커를 표시합니다. Claude Code v2.1.186 이상이 필요합니다. |

227| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 터미널이 지원하지만 자동 감지되지 않을 때 DEC 개인 모드 2026 [동기화된 출력](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)을 강제로 활성화하려면 `1`로 설정합니다. Emacs `eat`과 같은 BSU/ESU를 구현하지만 기능 프로브에 응답하지 않는 에뮬레이터에 유용합니다. tmux에서는 효과가 없습니다. |227| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | 터미널이 지원하지만 자동 감지되지 않을 때 DEC 개인 모드 2026 [동기화된 출력](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036)을 강제로 활성화하려면 `1`로 설정합니다. Emacs `eat`과 같은 BSU/ESU를 구현하지만 기능 프로브에 응답하지 않는 에뮬레이터에 유용합니다. tmux에서는 효과가 없습니다. |

228| `CLAUDE_CODE_FORK_SUBAGENT` | [포크된 subagent](/ko/sub-agents#fork-the-current-conversation)를 모델의 기본값으로 만들려면 `1`로 설정하거나, 비활성화하려면 `0`으로 설정합니다. 서버 측 롤아웃을 재정의합니다. 활성화되면 Claude는 일반 목적 subagent를 사용하는 대신 포크를 생성합니다. 포크는 새로 시작하는 대신 전체 대화 컨텍스트를 상속하는 subagent이며, 모든 subagent 생성은 백그라운드에서 실행됩니다. 명시적 [`/fork`](/ko/commands) 명령은 이 변수 없이도 작동합니다. 대화형 모드와 SDK 또는 `claude -p`를 통해 작동합니다. |228| `CLAUDE_CODE_FORK_SUBAGENT` | [포크된 subagent](/ko/sub-agents#fork-the-current-conversation)를 모델의 기본값으로 만들려면 `1`로 설정하거나, 비활성화하려면 `0`으로 설정합니다. 서버 측 롤아웃을 재정의합니다. 활성화되면 Claude는 일반 목적 subagent를 사용하는 대신 포크를 생성합니다. 포크는 새로 시작하는 대신 전체 대화 컨텍스트를 상속하는 subagent이며, 모든 subagent 생성은 백그라운드에서 실행됩니다. 명시적 [`/fork`](/ko/commands) 명령은 이 변수 없이도 작동합니다. 대화형 모드와 SDK 또는 `claude -p`를 통해 작동합니다. |

229| `CLAUDE_CODE_GIT_BASH_PATH` | Windows 전용: Git Bash 실행 파일(`bash.exe`)의 경로입니다. Git Bash가 설치되었지만 PATH에 없을 때 사용합니다. [Windows 설정](/ko/setup#set-up-on-windows) 참조 |229| `CLAUDE_CODE_GIT_BASH_PATH` | Windows 전용: Git Bash 실행 파일(`bash.exe`)의 경로입니다. Git Bash가 설치되었지만 PATH에 없을 때 사용합니다. [Windows 설정](/ko/setup#set-up-on-windows) 참조 |

234| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 확장에 연결하는 데 사용되는 호스트 주소를 재정의합니다. 기본적으로 Claude Code는 WSL-to-Windows 라우팅을 포함한 올바른 주소를 자동 감지합니다. |234| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 확장에 연결하는 데 사용되는 호스트 주소를 재정의합니다. 기본적으로 Claude Code는 WSL-to-Windows 라우팅을 포함한 올바른 주소를 자동 감지합니다. |

235| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 확장의 자동 설치를 건너뜁니다. [`autoInstallIdeExtension`](/ko/settings#global-config-settings)을 `false`로 설정하는 것과 동일합니다. |235| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 확장의 자동 설치를 건너뜁니다. [`autoInstallIdeExtension`](/ko/settings#global-config-settings)을 `false`로 설정하는 것과 동일합니다. |

236| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 연결 중 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정합니다. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다. |236| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | 연결 중 IDE 잠금 파일 항목의 유효성 검사를 건너뛰려면 `1`로 설정합니다. 자동 연결이 실행 중인 IDE를 찾지 못할 때 사용합니다. |

237| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code가 활성 모델에 대해 가정하는 컨텍스트 윈도우 크기를 재정의합니다. {{/* min-version: 2.1.193 */}}v2.1.193부터 Claude Code가 Claude 모델로 인식하는 모델 이름에 대해 직접 적용됩니다. 인식된 Claude 모델의 경우 `DISABLE_COMPACT`도 설정되어 있을 때만 적용됩니다. `ANTHROPIC_BASE_URL`을 통해 이름의 기본 제공 크기와 일치하지 않는 컨텍스트 윈도우를 가진 모델로 라우팅할 때 사용합니다. |237| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code가 활성 모델에 대해 가정하는 컨텍스트 윈도우 크기를 재정의합니다. {/* min-version: 2.1.193 */}v2.1.193부터 Claude Code가 Claude 모델로 인식하는 모델 이름에 대해 직접 적용됩니다. 인식된 Claude 모델의 경우 `DISABLE_COMPACT`도 설정되어 있을 때만 적용됩니다. `ANTHROPIC_BASE_URL`을 통해 이름의 기본 제공 크기와 일치하지 않는 컨텍스트 윈도우를 가진 모델로 라우팅할 때 사용합니다. |

238| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 참조. 이 값을 증가시키면 [자동 압축](/ko/costs#reduce-token-usage)이 트리거되기 전에 사용 가능한 효과적인 컨텍스트 윈도우가 감소합니다. |238| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 대부분의 요청에 대한 최대 출력 토큰 수를 설정합니다. 기본값 및 상한은 모델에 따라 다릅니다. [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) 참조. 이 값을 증가시키면 [자동 압축](/ko/costs#reduce-token-usage)이 트리거되기 전에 사용 가능한 효과적인 컨텍스트 윈도우가 감소합니다. |

239| `CLAUDE_CODE_MAX_RETRIES` | 실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). {{/* min-version: 2.1.186 */}}v2.1.186부터 최대 15로 제한됩니다. {{/* min-version: 2.1.199 */}}v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 제한을 제거합니다. 더 긴 중단을 기다려야 하는 무인 세션의 경우 `CLAUDE_CODE_RETRY_WATCHDOG`을 대신 설정합니다. |239| `CLAUDE_CODE_MAX_RETRIES` | 실패한 API 요청을 재시도할 횟수를 재정의합니다(기본값: 10). {/* min-version: 2.1.186 */}v2.1.186부터 최대 15로 제한됩니다. {/* min-version: 2.1.199 */}v2.1.199부터 `CLAUDE_CODE_RETRY_WATCHDOG`이 기본값을 올리고 제한을 제거합니다. 더 긴 중단을 기다려야 하는 무인 세션의 경우 `CLAUDE_CODE_RETRY_WATCHDOG`을 대신 설정합니다. |

240| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 병렬로 실행할 수 있는 읽기 전용 도구 및 subagent의 최대 수(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다. |240| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | 병렬로 실행할 수 있는 읽기 전용 도구 및 subagent의 최대 수(기본값: 10). 더 높은 값은 병렬 처리를 증가시키지만 더 많은 리소스를 소비합니다. |

241| `CLAUDE_CODE_MAX_TURNS` | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. [`--max-turns`](/ko/cli-reference#cli-flags) 전달과 동일하며, 둘 다 설정되면 우선합니다. 양의 정수가 아닌 값은 제한이 없는 것으로 취급되지 않고 오류와 함께 시작 시 거부됩니다. |241| `CLAUDE_CODE_MAX_TURNS` | 명시적 제한이 전달되지 않을 때 에이전트 턴 수를 제한합니다. [`--max-turns`](/ko/cli-reference#cli-flags) 전달과 동일하며, 둘 다 설정되면 우선합니다. 양의 정수가 아닌 값은 제한이 없는 것으로 취급되지 않고 오류와 함께 시작 시 거부됩니다. |

242| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정합니다. 셸 환경을 상속하지 않습니다. |242| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | stdio MCP 서버를 안전한 기본 환경과 서버의 구성된 `env`만으로 생성하려면 `1`로 설정합니다. 셸 환경을 상속하지 않습니다. |

243| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {{/* min-version: 2.1.187 */}}MCP 도구 호출의 유휴 타임아웃(밀리초). stdio, HTTP, SSE, WebSocket 또는 [claude.ai 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) MCP 서버가 이 기간 동안 응답 및 진행 알림을 보내지 않으면 도구 호출이 오류로 중단됩니다. 네트워크 서버의 기본값은 300000(5분)이고 stdio 서버의 기본값은 1800000(30분)입니다. 유휴 확인을 비활성화하려면 `0`으로 설정합니다. 1000 미만의 값은 1초로 올라갑니다. 값은 유효한 `MCP_TOOL_TIMEOUT`으로 제한됩니다. `.mcp.json`의 서버별 `timeout`이 최소 1000이면 해당 서버의 유휴 윈도우를 최소 `timeout` 값으로 올립니다. IDE 서버 또는 SDK 인프로세스 서버에는 적용되지 않습니다. Claude Code v2.1.187 이상이 필요합니다. {{/* min-version: 2.1.203 */}}v2.1.203 이전에는 stdio 서버가 유휴 타임아웃에서 제외되었습니다. |243| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | {/* min-version: 2.1.187 */}MCP 도구 호출의 유휴 타임아웃(밀리초). stdio, HTTP, SSE, WebSocket 또는 [claude.ai 커넥터](/ko/mcp#use-mcp-servers-from-claude-ai) MCP 서버가 이 기간 동안 응답 및 진행 알림을 보내지 않으면 도구 호출이 오류로 중단됩니다. 네트워크 서버의 기본값은 300000(5분)이고 stdio 서버의 기본값은 1800000(30분)입니다. 유휴 확인을 비활성화하려면 `0`으로 설정합니다. 1000 미만의 값은 1초로 올라갑니다. 값은 유효한 `MCP_TOOL_TIMEOUT`으로 제한됩니다. `.mcp.json`의 서버별 `timeout`이 최소 1000이면 해당 서버의 유휴 윈도우를 최소 `timeout` 값으로 올립니다. IDE 서버 또는 SDK 인프로세스 서버에는 적용되지 않습니다. Claude Code v2.1.187 이상이 필요합니다. {/* min-version: 2.1.203 */}v2.1.203 이전에는 stdio 서버가 유휴 타임아웃에서 제외되었습니다. |

244| `CLAUDE_CODE_NATIVE_CURSOR` | 터미널의 자체 커서를 입력 캐럿에서 그려진 블록 대신 표시하려면 `1`로 설정합니다. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다. |244| `CLAUDE_CODE_NATIVE_CURSOR` | 터미널의 자체 커서를 입력 캐럿에서 그려진 블록 대신 표시하려면 `1`로 설정합니다. 커서는 터미널의 깜박임, 모양, 포커스 설정을 존중합니다. |

245| `CLAUDE_CODE_NEW_INIT` | `/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 `/init`은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다. |245| `CLAUDE_CODE_NEW_INIT` | `/init`이 대화형 설정 흐름을 실행하도록 하려면 `1`로 설정합니다. 흐름은 코드베이스를 탐색하고 작성하기 전에 CLAUDE.md, skill 및 훅을 포함하여 생성할 파일을 묻습니다. 이 변수가 없으면 `/init`은 프롬프트 없이 자동으로 CLAUDE.md를 생성합니다. |

246| `CLAUDE_CODE_NO_FLICKER` | [전체 화면 렌더링](/ko/fullscreen)을 활성화하려면 `1`로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다. [`tui`](/ko/settings#available-settings) 설정과 동일합니다. `/tui fullscreen`으로도 전환할 수 있습니다. |246| `CLAUDE_CODE_NO_FLICKER` | [전체 화면 렌더링](/ko/fullscreen)을 활성화하려면 `1`로 설정합니다. 이는 깜박임을 줄이고 긴 대화에서 메모리를 평탄하게 유지하는 연구 미리보기입니다. [`tui`](/ko/settings#available-settings) 설정과 동일합니다. `/tui fullscreen`으로도 전환할 수 있습니다. |

247| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 인증용 OAuth 새로 고침 토큰입니다. 설정하면 `claude auth login`이 브라우저를 열지 않고 이 토큰을 직접 교환합니다. `CLAUDE_CODE_OAUTH_SCOPES`가 필요합니다. 자동화된 환경에서 인증을 프로비저닝하는 데 유용합니다. |247| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 인증용 OAuth 새로 고침 토큰입니다. 설정하면 `claude auth login`이 브라우저를 열지 않고 이 토큰을 직접 교환합니다. `CLAUDE_CODE_OAUTH_SCOPES`가 필요합니다. 자동화된 환경에서 인증을 프로비저닝하는 데 유용합니다. |

248| `CLAUDE_CODE_OAUTH_SCOPES` | 새로 고침 토큰이 발급된 공백으로 구분된 OAuth 범위(예: `"user:profile user:inference user:sessions:claude_code"`). `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`이 설정되면 필수입니다. |248| `CLAUDE_CODE_OAUTH_SCOPES` | 새로 고침 토큰이 발급된 공백으로 구분된 OAuth 범위(예: `"user:profile user:inference user:sessions:claude_code"`). `CLAUDE_CODE_OAUTH_REFRESH_TOKEN`이 설정되면 필수입니다. |

249| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 인증용 OAuth 액세스 토큰입니다. `/login`의 대안으로 SDK 및 자동화된 환경에 사용됩니다. 키체인 저장 자격 증명보다 우선합니다. [`claude setup-token`](/ko/authentication#generate-a-long-lived-token)으로 생성합니다. |249| `CLAUDE_CODE_OAUTH_TOKEN` | Claude.ai 인증용 OAuth 액세스 토큰입니다. `/login`의 대안으로 SDK 및 자동화된 환경에 사용됩니다. 키체인 저장 자격 증명보다 우선합니다. [`claude setup-token`](/ko/authentication#generate-a-long-lived-token)으로 생성합니다. |

250| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {{/* max-version: 2.1.159 */}}v2.1.160에서 제거되었으며 이제 작동하지 않습니다. 이전에는 [빠른 모드](/ko/fast-mode)를 Claude Opus 4.6에 고정했습니다. Opus 4.6은 더 이상 빠른 모드를 지원하지 않습니다. |250| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}v2.1.160에서 제거되었으며 이제 작동하지 않습니다. 이전에는 [빠른 모드](/ko/fast-mode)를 Claude Opus 4.6에 고정했습니다. Opus 4.6은 더 이상 빠른 모드를 지원하지 않습니다. |

251| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {{/* min-version: 2.1.179 */}}OpenTelemetry 내보내기 진단 오류를 stderr에 쓰려면 `1`로 설정합니다. 기본적으로 이러한 오류는 `--debug`에서만 나타나므로 Prometheus 포트 충돌과 같은 잘못 구성된 내보내기는 그렇지 않으면 자동으로 실패합니다. Claude Code v2.1.179 이상이 필요합니다. [모니터링](/ko/monitoring-usage) 참조 |251| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}OpenTelemetry 내보내기 진단 오류를 stderr에 쓰려면 `1`로 설정합니다. 기본적으로 이러한 오류는 `--debug`에서만 나타나므로 Prometheus 포트 충돌과 같은 잘못 구성된 내보내기는 그렇지 않으면 자동으로 실패합니다. Claude Code v2.1.179 이상이 필요합니다. [모니터링](/ko/monitoring-usage) 참조 |

252| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 보류 중인 OpenTelemetry 스팬을 플러시하는 타임아웃(밀리초)(기본값: 5000). [모니터링](/ko/monitoring-usage) 참조 |252| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 보류 중인 OpenTelemetry 스팬을 플러시하는 타임아웃(밀리초)(기본값: 5000). [모니터링](/ko/monitoring-usage) 참조 |

253| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 동적 OpenTelemetry 헤더를 새로 고치는 간격(밀리초)(기본값: 1740000 / 29분). [동적 헤더](/ko/monitoring-usage#dynamic-headers) 참조 |253| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 동적 OpenTelemetry 헤더를 새로 고치는 간격(밀리초)(기본값: 1740000 / 29분). [동적 헤더](/ko/monitoring-usage#dynamic-headers) 참조 |

254| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | 종료 시 OpenTelemetry 내보내기가 완료되는 타임아웃(밀리초)(기본값: 2000). 메트릭이 종료 시 삭제되면 증가시킵니다. [모니터링](/ko/monitoring-usage) 참조 |254| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | 종료 시 OpenTelemetry 내보내기가 완료되는 타임아웃(밀리초)(기본값: 2000). 메트릭이 종료 시 삭제되면 증가시킵니다. [모니터링](/ko/monitoring-usage) 참조 |

260| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 플러그인 소스를 SSH 대신 HTTPS를 통해 복제하려면 `1`로 설정합니다. CI 러너, 컨테이너 또는 `github.com`에 대해 구성된 SSH 키가 없는 모든 환경에서 유용합니다. |260| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` 플러그인 소스를 SSH 대신 HTTPS를 통해 복제하려면 `1`로 설정합니다. CI 러너, 컨테이너 또는 `github.com`에 대해 구성된 SSH 키가 없는 모든 환경에서 유용합니다. |

261| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로이며, Unix에서는 `:`로, Windows에서는 `;`로 구분됩니다. 이를 사용하여 사전 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 제공합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 사전 캐시된 플러그인을 사용합니다. [컨테이너용 플러그인 사전 채우기](/ko/plugin-marketplaces#pre-populate-plugins-for-containers) 참조 |261| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 하나 이상의 읽기 전용 플러그인 시드 디렉토리의 경로이며, Unix에서는 `:`로, Windows에서는 `;`로 구분됩니다. 이를 사용하여 사전 채워진 플러그인 디렉토리를 컨테이너 이미지에 번들로 제공합니다. Claude Code는 시작 시 이러한 디렉토리에서 마켓플레이스를 등록하고 다시 복제하지 않고 사전 캐시된 플러그인을 사용합니다. [컨테이너용 플러그인 사전 채우기](/ko/plugin-marketplaces#pre-populate-plugins-for-containers) 참조 |

262| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Claude Code가 PowerShell을 생성할 때 `-ExecutionPolicy Bypass`를 전달하지 않으려면 `1`로 설정합니다. 도구 호출, 훅, 상태 줄 명령의 경우 대신 머신의 효과적인 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위에서 실행 정책을 우회하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정과 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다. |262| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Claude Code가 PowerShell을 생성할 때 `-ExecutionPolicy Bypass`를 전달하지 않으려면 `1`로 설정합니다. 도구 호출, 훅, 상태 줄 명령의 경우 대신 머신의 효과적인 실행 정책을 존중합니다. 기본적으로 Claude Code는 프로세스 범위에서 실행 정책을 우회하므로 `.ps1` 스크립트 및 모듈 가져오기가 기본 제한 Windows 설치에서 작동합니다. 프로세스 범위 우회는 이 설정과 관계없이 Group Policy `MachinePolicy` 또는 `UserPolicy`를 재정의하지 않습니다. |

263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {{/* min-version: 2.1.182 */}}[비대화형 모드](/ko/headless#background-tasks-at-exit)에서 `-p` 플래그를 사용하여 최종 턴 후 결과가 출력의 일부인 백그라운드 subagent 및 워크플로우를 기다리는 최대 시간(밀리초). 기본값: `600000`, 또는 10분. 제한을 초과하면 남은 백그라운드 작업이 종료되고 프로세스가 종료됩니다. 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. `0`으로 설정하여 무한정 대기합니다. |263| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}}[비대화형 모드](/ko/headless#background-tasks-at-exit)에서 `-p` 플래그를 사용하여 최종 턴 후 결과가 출력의 일부인 백그라운드 subagent 및 워크플로우를 기다리는 최대 시간(밀리초). 기본값: `600000`, 또는 10분. 제한을 초과하면 남은 백그라운드 작업이 종료되고 프로세스가 종료됩니다. 일반 백그라운드 셸에 적용되는 5초 유예 기간과는 별개입니다. `0`으로 설정하여 무한정 대기합니다. |

264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {{/* min-version: 2.1.152 */}}`ANTHROPIC_BASE_URL`이 사용자 정의 프록시를 가리킬 때 W3C 추적 컨텍스트를 전파하려면 `1`로 설정합니다. 전파는 모델 및 HTTP MCP 요청의 `traceparent` 헤더와 Bash, PowerShell, 훅 subprocess의 `TRACEPARENT` 환경 변수를 포함합니다. 기본적으로 전파는 Anthropic API에 직접 연결할 때만 활성화됩니다. v2.1.152에서 추가됨. [추적(베타)](/ko/monitoring-usage#traces-beta) 참조 |264| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}}`ANTHROPIC_BASE_URL`이 사용자 정의 프록시를 가리킬 때 W3C 추적 컨텍스트를 전파하려면 `1`로 설정합니다. 전파는 모델 및 HTTP MCP 요청의 `traceparent` 헤더와 Bash, PowerShell, 훅 subprocess의 `TRACEPARENT` 환경 변수를 포함합니다. 기본적으로 전파는 Anthropic API에 직접 연결할 때만 활성화됩니다. v2.1.152에서 추가됨. [추적(베타)](/ko/monitoring-usage#traces-beta) 참조 |

265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code를 포함하고 대신 모델 공급자 라우팅을 관리하는 호스트 플랫폼에서 설정합니다. 설정하면 설정 파일의 `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`와 같은 공급자 선택, 엔드포인트, 인증 변수가 무시되므로 사용자 설정이 호스트의 라우팅을 재정의할 수 없습니다. Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에 대한 자동 원격 분석 옵트아웃도 건너뛰므로 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. [API 공급자별 기본 동작](/ko/data-usage#default-behaviors-by-api-provider) 참조 |265| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code를 포함하고 대신 모델 공급자 라우팅을 관리하는 호스트 플랫폼에서 설정합니다. 설정하면 설정 파일의 `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`와 같은 공급자 선택, 엔드포인트, 인증 변수가 무시되므로 사용자 설정이 호스트의 라우팅을 재정의할 수 없습니다. Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry에 대한 자동 원격 분석 옵트아웃도 건너뛰므로 원격 분석은 표준 `DISABLE_TELEMETRY` 옵트아웃을 따릅니다. [API 공급자별 기본 동작](/ko/data-usage#default-behaviors-by-api-provider) 참조 |

266| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 호출자 대신 프록시가 DNS 해석을 수행하도록 허용하려면 `1`로 설정합니다. 프록시가 호스트명 해석을 처리해야 하는 환경에 대해 옵트인합니다. |266| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | 호출자 대신 프록시가 DNS 해석을 수행하도록 허용하려면 `1`로 설정합니다. 프록시가 호스트명 해석을 처리해야 하는 환경에 대해 옵트인합니다. |

267| `CLAUDE_CODE_REMOTE` | Claude Code가 [클라우드 세션](/ko/claude-code-on-the-web)으로 실행 중일 때 자동으로 `true`로 설정됩니다. 훅 또는 설정 스크립트에서 이를 읽어 클라우드 환경에 있는지 감지합니다. |267| `CLAUDE_CODE_REMOTE` | Claude Code가 [클라우드 세션](/ko/claude-code-on-the-web)으로 실행 중일 때 자동으로 `true`로 설정됩니다. 훅 또는 설정 스크립트에서 이를 읽어 클라우드 환경에 있는지 감지합니다. |

268| `CLAUDE_CODE_REMOTE_SESSION_ID` | [클라우드 세션](/ko/claude-code-on-the-web)에서 현재 세션의 ID로 자동으로 설정됩니다. 세션 트랜스크립트로 다시 연결하는 링크를 구성하려면 이를 읽습니다. [세션으로 출력 다시 연결](/ko/claude-code-on-the-web#link-output-back-to-the-session) 참조 |268| `CLAUDE_CODE_REMOTE_SESSION_ID` | [클라우드 세션](/ko/claude-code-on-the-web)에서 현재 세션의 ID로 자동으로 설정됩니다. 세션 트랜스크립트로 다시 연결하는 링크를 구성하려면 이를 읽습니다. [세션으로 출력 다시 연결](/ko/claude-code-on-the-web#link-output-back-to-the-session) 참조 |

269| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 이전 세션이 중간에 끝난 경우 자동으로 재개하려면 `1`로 설정합니다. SDK 모드에서 사용되므로 모델이 SDK가 프롬프트를 다시 전송할 필요 없이 계속됩니다. |269| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 이전 세션이 중간에 끝난 경우 자동으로 재개하려면 `1`로 설정합니다. SDK 모드에서 사용되므로 모델이 SDK가 프롬프트를 다시 전송할 필요 없이 계속됩니다. |

270| `CLAUDE_CODE_RESUME_PROMPT` | 세션이 중간에 끝난 후 재개할 때 주입되는 계속 메시지를 재정의합니다. 기본값은 `Continue from where you left off.`입니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 더 지시적인 부팅 메시지로 설정할 수 있습니다. 빈 문자열은 기본값을 사용합니다. |270| `CLAUDE_CODE_RESUME_PROMPT` | 세션이 중간에 끝난 후 재개할 때 주입되는 계속 메시지를 재정의합니다. 기본값은 `Continue from where you left off.`입니다. 장시간 실행되는 에이전트의 스폰 스크립트는 이를 더 지시적인 부팅 메시지로 설정할 수 있습니다. 빈 문자열은 기본값을 사용합니다. |

271| `CLAUDE_CODE_RETRY_WATCHDOG` | {{/* min-version: 2.1.186 */}}평가 하네스, CI 작업 또는 원격 작업자와 같은 무인 세션의 경우 `1`로 설정합니다. `429` 및 `529` 용량 오류를 `CLAUDE_CODE_MAX_RETRIES` 시도 후 실패하는 대신 무한정 재시도합니다. 감시견은 시도 사이에 최대 5분까지 백오프하거나 응답이 속도 제한 재설정 시간을 전달할 때 제한이 재설정될 때까지 대기합니다. 사용량 제한에 도달한 세션은 남은 윈도우를 기다립니다. {{/* min-version: 2.1.199 */}}v2.1.199부터 서버 오류, 타임아웃, 끊어진 연결과 같은 다른 일시적 오류에 대한 기본 재시도 횟수를 약 3시간의 백오프인 300으로 올리고 `CLAUDE_CODE_MAX_RETRIES`를 명시적으로 설정하면 15의 제한을 제거합니다. Claude Code v2.1.186 이상이 필요합니다. |271| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}평가 하네스, CI 작업 또는 원격 작업자와 같은 무인 세션의 경우 `1`로 설정합니다. `429` 및 `529` 용량 오류를 `CLAUDE_CODE_MAX_RETRIES` 시도 후 실패하는 대신 무한정 재시도합니다. 감시견은 시도 사이에 최대 5분까지 백오프하거나 응답이 속도 제한 재설정 시간을 전달할 때 제한이 재설정될 때까지 대기합니다. 사용량 제한에 도달한 세션은 남은 윈도우를 기다립니다. {/* min-version: 2.1.199 */}v2.1.199부터 서버 오류, 타임아웃, 끊어진 연결과 같은 다른 일시적 오류에 대한 기본 재시도 횟수를 약 3시간의 백오프인 300으로 올리고 `CLAUDE_CODE_MAX_RETRIES`를 명시적으로 설정하면 15의 제한을 제거합니다. Claude Code v2.1.186 이상이 필요합니다. |

272| `CLAUDE_CODE_SAFE_MODE` | 안전 모드에서 시작하려면 `1`로 설정합니다: CLAUDE.md, skill, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버, 자동 메모리는 로드되지 않습니다. 손상된 구성을 문제 해결하기 위해. 관리 설정 정책은 여전히 적용되며, 정책 구성 훅, 상태 줄, 파일 제안 명령을 포함합니다. 관리 플러그인, 관리 skill, 관리 CLAUDE.md, 정책 구성 MCP 서버는 로드되지 않습니다. [`--safe-mode`](/ko/cli-reference#cli-flags) 전달과 동일합니다. 직접 생성된 자식 프로세스는 변수를 상속합니다. |272| `CLAUDE_CODE_SAFE_MODE` | 안전 모드에서 시작하려면 `1`로 설정합니다: CLAUDE.md, skill, 플러그인, 훅, MCP 서버, 사용자 정의 명령 및 에이전트, 출력 스타일, 워크플로우, 사용자 정의 테마, 사용자 정의 키 바인딩, 상태 줄 및 파일 제안 명령, LSP 서버, 자동 메모리는 로드되지 않습니다. 손상된 구성을 문제 해결하기 위해. 관리 설정 정책은 여전히 적용되며, 정책 구성 훅, 상태 줄, 파일 제안 명령을 포함합니다. 관리 플러그인, 관리 skill, 관리 CLAUDE.md, 정책 구성 MCP 서버는 로드되지 않습니다. [`--safe-mode`](/ko/cli-reference#cli-flags) 전달과 동일합니다. 직접 생성된 자식 프로세스는 변수를 상속합니다. |

273| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`이 설정되었을 때 세션당 특정 스크립트를 호출할 수 있는 횟수를 제한하는 JSON 객체입니다. 키는 명령 텍스트에 대해 일치하는 부분 문자열입니다. 값은 정수 호출 제한입니다. 예를 들어 `{"deploy.sh": 2}`는 `deploy.sh`를 최대 2번 호출할 수 있습니다. 일치는 부분 문자열 기반이므로 `./scripts/deploy.sh $(evil)`과 같은 셸 확장 트릭도 여전히 제한에 포함됩니다. `xargs` 또는 `find -exec`을 통한 런타임 팬아웃은 감지되지 않습니다. 이는 심층 방어 제어입니다. |273| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`이 설정되었을 때 세션당 특정 스크립트를 호출할 수 있는 횟수를 제한하는 JSON 객체입니다. 키는 명령 텍스트에 대해 일치하는 부분 문자열입니다. 값은 정수 호출 제한입니다. 예를 들어 `{"deploy.sh": 2}`는 `deploy.sh`를 최대 2번 호출할 수 있습니다. 일치는 부분 문자열 기반이므로 `./scripts/deploy.sh $(evil)`과 같은 셸 확장 트릭도 여전히 제한에 포함됩니다. `xargs` 또는 `find -exec`을 통한 런타임 팬아웃은 감지되지 않습니다. 이는 심층 방어 제어입니다. |

274| `CLAUDE_CODE_SCROLL_SPEED` | [전체 화면 렌더링](/ko/fullscreen#mouse-wheel-scrolling)에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 그리고 `0.5`와 같은 1 미만의 분수 값을 허용하여 터미널의 기본 스크롤 경로에서 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시되며, Claude Code는 자체 스크롤 처리를 사용합니다. |274| `CLAUDE_CODE_SCROLL_SPEED` | [전체 화면 렌더링](/ko/fullscreen#mouse-wheel-scrolling)에서 마우스 휠 스크롤 배수를 설정합니다. 1부터 20까지의 값을 허용합니다. 그리고 `0.5`와 같은 1 미만의 분수 값을 허용하여 터미널의 기본 스크롤 경로에서 가속 트랙패드 및 휠 스크롤을 느리게 합니다. 터미널이 증폭 없이 노치당 하나의 휠 이벤트를 보내는 경우 `vim`과 일치하도록 `3`으로 설정합니다. JetBrains IDE 터미널에서는 무시되며, Claude Code는 자체 스크롤 처리를 사용합니다. |

280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 모든 모델에서 더 짧은 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 `1`로 설정합니다. `0`, `false`, `no`, 또는 `off`로 설정하여 실험 또는 서버 구성이 그렇지 않으면 활성화할 때에도 옵트아웃합니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다. |280| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 모든 모델에서 더 짧은 시스템 프롬프트 및 축소된 도구 설명을 사용하려면 `1`로 설정합니다. `0`, `false`, `no`, 또는 `off`로 설정하여 실험 또는 서버 구성이 그렇지 않으면 활성화할 때에도 옵트아웃합니다. 전체 도구 세트, 훅, MCP 서버, CLAUDE.md 검색은 계속 활성화됩니다. |

281| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/ko/claude-platform-on-aws)에 대한 클라이언트 측 인증을 건너뜁니다. 게이트웨이가 요청에 자체 서명하는 경우 |281| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/ko/claude-platform-on-aws)에 대한 클라이언트 측 인증을 건너뜁니다. 게이트웨이가 요청에 자체 서명하는 경우 |

282| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |282| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Amazon Bedrock에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |

283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry에 대한 Azure 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). Claude Code는 요청을 Azure 자격 증명 없이 전송하고 `ANTHROPIC_CUSTOM_HEADERS`를 통해 제공하는 것과 같은 `Authorization` 헤더를 유지합니다. `ANTHROPIC_FOUNDRY_API_KEY` 또는 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`이 설정되면 무시됩니다. {{/* min-version: 2.1.203 */}}v2.1.203 이전에는 이 변수가 API 키도 설정되지 않으면 Microsoft Foundry 클라이언트가 요청을 보낼 수 없게 했습니다. |283| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry에 대한 Azure 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). Claude Code는 요청을 Azure 자격 증명 없이 전송하고 `ANTHROPIC_CUSTOM_HEADERS`를 통해 제공하는 것과 같은 `Authorization` 헤더를 유지합니다. `ANTHROPIC_FOUNDRY_API_KEY` 또는 `ANTHROPIC_FOUNDRY_AUTH_TOKEN`이 설정되면 무시됩니다. {/* min-version: 2.1.203 */}v2.1.203 이전에는 이 변수가 API 키도 설정되지 않으면 Microsoft Foundry 클라이언트가 요청을 보낼 수 없게 했습니다. |

284| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |284| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle에 대한 AWS 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |

285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 프롬프트 기록 및 세션 트랜스크립트를 디스크에 쓰지 않으려면 `1`로 설정합니다. 이 변수로 시작된 세션은 `--resume`, `--continue` 또는 위쪽 화살표 기록에 나타나지 않습니다. 임시 스크립트 세션에 유용합니다. |285| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | 프롬프트 기록 및 세션 트랜스크립트를 디스크에 쓰지 않으려면 `1`로 설정합니다. 이 변수로 시작된 세션은 `--resume`, `--continue` 또는 위쪽 화살표 기록에 나타나지 않습니다. 임시 스크립트 세션에 유용합니다. |

286| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud's Agent Platform에 대한 Google 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |286| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud's Agent Platform에 대한 Google 인증을 건너뜁니다(예: LLM 게이트웨이를 사용할 때). |

287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/ko/hooks#stop) 또는 [SubagentStop](/ko/hooks#subagentstop) 훅이 턴 종료를 차단할 수 있는 최대 연속 횟수입니다(기본값: 8). Claude Code가 턴을 어쨌든 종료하기 전입니다. `0`으로 설정하여 제한을 비활성화합니다. 훅이 해결하기 위해 더 많은 반복이 필요하면 이를 올립니다. |287| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/ko/hooks#stop) 또는 [SubagentStop](/ko/hooks#subagentstop) 훅이 턴 종료를 차단할 수 있는 최대 연속 횟수입니다(기본값: 8). Claude Code가 턴을 어쨌든 종료하기 전입니다. `0`으로 설정하여 제한을 비활성화합니다. 훅이 해결하기 위해 더 많은 반복이 필요하면 이를 올립니다. |

288| `CLAUDE_CODE_SUBAGENT_MODEL` | [모델 구성](/ko/model-config) 참조 {{/* min-version: 2.1.196 */}}v2.1.196부터 `inherit`로 설정하는 것은 설정하지 않은 것과 동일합니다. 이전 버전은 `inherit`를 모든 subagent를 주 대화의 모델로 강제하는 재정의로 취급했습니다. |288| `CLAUDE_CODE_SUBAGENT_MODEL` | [모델 구성](/ko/model-config) 참조 {/* min-version: 2.1.196 */}v2.1.196부터 `inherit`로 설정하는 것은 설정하지 않은 것과 동일합니다. 이전 버전은 `inherit`를 모든 subagent를 주 대화의 모델로 강제하는 재정의로 취급했습니다. |

289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Anthropic 및 클라우드 공급자 자격 증명을 subprocess 환경(Bash 도구, 훅, MCP stdio 서버)에서 제거하려면 `1`로 설정합니다. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 이를 읽을 수 없으므로 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. Linux에서는 Bash subprocess를 격리된 PID 네임스페이스에서도 실행하므로 `/proc`을 통해 호스트 프로세스 환경을 읽을 수 없습니다. 부작용으로 `ps`, `pgrep`, `kill`은 호스트 프로세스를 보거나 신호할 수 없습니다. `allowed_non_write_users`가 구성되면 `claude-code-action`이 자동으로 이를 설정합니다. |289| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Anthropic 및 클라우드 공급자 자격 증명을 subprocess 환경(Bash 도구, 훅, MCP stdio 서버)에서 제거하려면 `1`로 설정합니다. 부모 Claude 프로세스는 API 호출을 위해 이러한 자격 증명을 유지하지만 자식 프로세스는 이를 읽을 수 없으므로 셸 확장을 통해 비밀을 유출하려는 프롬프트 주입 공격에 대한 노출을 줄입니다. Linux에서는 Bash subprocess를 격리된 PID 네임스페이스에서도 실행하므로 `/proc`을 통해 호스트 프로세스 환경을 읽을 수 없습니다. 부작용으로 `ps`, `pgrep`, `kill`은 호스트 프로세스를 보거나 신호할 수 없습니다. `allowed_non_write_users`가 구성되면 `claude-code-action`이 자동으로 이를 설정합니다. |

290| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 비대화형 모드(`-p` 플래그)에서 첫 번째 쿼리 전에 플러그인 설치가 완료될 때까지 대기하려면 `1`로 설정합니다. 이 없으면 플러그인이 백그라운드에서 설치되고 첫 번째 턴에서 사용하지 못할 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 제한합니다. |290| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 비대화형 모드(`-p` 플래그)에서 첫 번째 쿼리 전에 플러그인 설치가 완료될 때까지 대기하려면 `1`로 설정합니다. 이 없으면 플러그인이 백그라운드에서 설치되고 첫 번째 턴에서 사용하지 못할 수 있습니다. `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS`와 결합하여 대기를 제한합니다. |

291| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 동기 플러그인 설치의 타임아웃(밀리초). 초과되면 Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치는 완료될 때까지 대기합니다. |291| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 동기 플러그인 설치의 타임아웃(밀리초). 초과되면 Claude Code는 플러그인 없이 진행하고 오류를 기록합니다. 기본값 없음: 이 변수가 없으면 동기 설치는 완료될 때까지 대기합니다. |

295| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 출력에서 구문 강조를 비활성화하려면 `false`로 설정합니다. 색상이 터미널 설정을 방해할 때 유용합니다. 코드 블록 및 파일 미리보기에서 강조를 비활성화하려면 [`syntaxHighlightingDisabled`](/ko/settings) 설정을 사용합니다. |295| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 출력에서 구문 강조를 비활성화하려면 `false`로 설정합니다. 색상이 터미널 설정을 방해할 때 유용합니다. 코드 블록 및 파일 미리보기에서 강조를 비활성화하려면 [`syntaxHighlightingDisabled`](/ko/settings) 설정을 사용합니다. |

296| `CLAUDE_CODE_TASK_LIST_ID` | 세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 공유 작업 목록에서 조정합니다. [작업 목록](/ko/interactive-mode#task-list) 참조 |296| `CLAUDE_CODE_TASK_LIST_ID` | 세션 간에 작업 목록을 공유합니다. 여러 Claude Code 인스턴스에서 동일한 ID를 설정하여 공유 작업 목록에서 조정합니다. [작업 목록](/ko/interactive-mode#task-list) 참조 |

297| `CLAUDE_CODE_TEAM_NAME` | 이 팀원이 속한 에이전트 팀의 이름입니다. [에이전트 팀](/ko/agent-teams) 멤버에서 자동으로 설정됩니다. |297| `CLAUDE_CODE_TEAM_NAME` | 이 팀원이 속한 에이전트 팀의 이름입니다. [에이전트 팀](/ko/agent-teams) 멤버에서 자동으로 설정됩니다. |

298| `CLAUDE_CODE_TMPDIR` | 내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 이 경로에 `/claude-{uid}/`(Unix) 또는 `/claude/`(Windows)를 추가합니다. 기본값: macOS의 경우 `/tmp`, Linux/Windows의 경우 `os.tmpdir()`. {{/* min-version: 2.1.161 */}}v2.1.161부터 macOS 및 Linux에서 [샌드박스](/ko/sandboxing) Bash subprocess는 경로가 너무 길어지면 일부 도구가 실패하므로 시스템 기본값 아래에 짧은 폴백 `$TMPDIR`을 받습니다. 샌드박스되지 않은 Bash 명령은 셸의 `$TMPDIR`을 변경되지 않고 상속합니다. Claude Code의 자체 임시 파일은 항상 재정의를 사용합니다. |298| `CLAUDE_CODE_TMPDIR` | 내부 임시 파일에 사용되는 임시 디렉토리를 재정의합니다. Claude Code는 이 경로에 `/claude-{uid}/`(Unix) 또는 `/claude/`(Windows)를 추가합니다. 기본값: macOS의 경우 `/tmp`, Linux/Windows의 경우 `os.tmpdir()`. {/* min-version: 2.1.161 */}v2.1.161부터 macOS 및 Linux에서 [샌드박스](/ko/sandboxing) Bash subprocess는 경로가 너무 길어지면 일부 도구가 실패하므로 시스템 기본값 아래에 짧은 폴백 `$TMPDIR`을 받습니다. 샌드박스되지 않은 Bash 명령은 셸의 `$TMPDIR`을 변경되지 않고 상속합니다. Claude Code의 자체 임시 파일은 항상 재정의를 사용합니다. |

299| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 내에서 24비트 truecolor 출력을 허용하려면 `1`로 설정합니다. 기본적으로 `$TMUX`가 설정되면 Claude Code는 256색으로 제한합니다. tmux는 구성되지 않으면 truecolor 이스케이프 시퀀스를 통과하지 않기 때문입니다. `~/.tmux.conf`에 `set -ga terminal-overrides ',*:Tc'`를 추가한 후 이를 설정합니다. [터미널 구성](/ko/terminal-config)에서 다른 tmux 설정을 참조합니다. |299| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 내에서 24비트 truecolor 출력을 허용하려면 `1`로 설정합니다. 기본적으로 `$TMUX`가 설정되면 Claude Code는 256색으로 제한합니다. tmux는 구성되지 않으면 truecolor 이스케이프 시퀀스를 통과하지 않기 때문입니다. `~/.tmux.conf`에 `set -ga terminal-overrides ',*:Tc'`를 추가한 후 이를 설정합니다. [터미널 구성](/ko/terminal-config)에서 다른 tmux 설정을 참조합니다. |

300| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/ko/claude-platform-on-aws) 사용 |300| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/ko/claude-platform-on-aws) 사용 |

301| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/ko/amazon-bedrock) 사용 |301| `CLAUDE_CODE_USE_BEDROCK` | [Amazon Bedrock](/ko/amazon-bedrock) 사용 |

305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell 도구를 제어합니다. Windows에서 Git Bash가 없으면 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Windows에 Git Bash가 설치되어 있으면 도구가 점진적으로 롤아웃됩니다: 옵트인하려면 `1`로 설정하거나 옵트아웃하려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면 Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. [PowerShell 도구](/ko/tools-reference#powershell-tool) 참조 |305| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell 도구를 제어합니다. Windows에서 Git Bash가 없으면 도구가 자동으로 활성화됩니다. `0`으로 설정하여 비활성화합니다. Windows에 Git Bash가 설치되어 있으면 도구가 점진적으로 롤아웃됩니다: 옵트인하려면 `1`로 설정하거나 옵트아웃하려면 `0`으로 설정합니다. Linux, macOS, WSL에서는 `1`로 설정하여 활성화합니다. PATH에 `pwsh`가 필요합니다. Windows에서 활성화되면 Claude는 Git Bash를 통해 라우팅하는 대신 PowerShell 명령을 기본적으로 실행할 수 있습니다. [PowerShell 도구](/ko/tools-reference#powershell-tool) 참조 |

306| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/ko/google-vertex-ai) 사용 |306| `CLAUDE_CODE_USE_VERTEX` | [Google Cloud's Agent Platform](/ko/google-vertex-ai) 사용 |

307| `CLAUDE_CONFIG_DIR` | 구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 자격 증명, 세션 기록 및 플러그인이 이 경로 아래에 저장됩니다. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |307| `CLAUDE_CONFIG_DIR` | 구성 디렉토리를 재정의합니다(기본값: `~/.claude`). 모든 설정, 자격 증명, 세션 기록 및 플러그인이 이 경로 아래에 저장됩니다. 여러 계정을 나란히 실행하는 데 유용합니다: 예를 들어 `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

308| `CLAUDE_DISABLE_ADOPT` | {{/* min-version: 2.1.195 */}}세션을 백그라운드 처리할 때 `←` 또는 [`/background`](/ko/agent-view#from-inside-a-session)를 눌러 진행 중인 백그라운드 작업을 수행하는 대신 중지하려면 `1`로 설정합니다. Claude Code는 백그라운드 처리 전에 확인을 요청한 다음 그렇지 않으면 수행할 작업을 중지합니다. Claude Code v2.1.195 이상이 필요합니다. |308| `CLAUDE_DISABLE_ADOPT` | {/* min-version: 2.1.195 */}세션을 백그라운드 처리할 때 `←` 또는 [`/background`](/ko/agent-view#from-inside-a-session)를 눌러 진행 중인 백그라운드 작업을 수행하는 대신 중지하려면 `1`로 설정합니다. Claude Code는 백그라운드 처리 전에 확인을 요청한 다음 그렇지 않으면 수행할 작업을 중지합니다. Claude Code v2.1.195 이상이 필요합니다. |

309| `CLAUDE_EFFORT` | Bash 도구 subprocess 및 훅 명령에서 활성 [노력 수준](/ko/model-config#adjust-effort-level)으로 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. Ultracode는 별개의 수준이 아니며 `xhigh`로 보고됩니다. [훅](/ko/hooks)에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다. |309| `CLAUDE_EFFORT` | Bash 도구 subprocess 및 훅 명령에서 활성 [노력 수준](/ko/model-config#adjust-effort-level)으로 자동으로 설정됩니다: `low`, `medium`, `high`, `xhigh`, 또는 `max`. Ultracode는 별개의 수준이 아니며 `xhigh`로 보고됩니다. [훅](/ko/hooks)에 전달된 `effort.level` 필드와 일치합니다. 현재 모델이 노력 매개변수를 지원할 때만 설정됩니다. |

310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 직접 Anthropic API 및 [Claude Platform on AWS](/ko/claude-platform-on-aws) 연결에 대해 기본적으로 활성화됩니다. 바이트 감시견은 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 설정된 기간 동안 와이어에 바이트가 도착하지 않으면 연결을 중단합니다. 최소 5분이며 이벤트 수준 감시견과 독립적입니다. |310| `CLAUDE_ENABLE_BYTE_WATCHDOG` | 바이트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. 설정하지 않으면 감시견은 직접 Anthropic API 및 [Claude Platform on AWS](/ko/claude-platform-on-aws) 연결에 대해 기본적으로 활성화됩니다. 바이트 감시견은 `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 설정된 기간 동안 와이어에 바이트가 도착하지 않으면 연결을 중단합니다. 최소 5분이며 이벤트 수준 감시견과 독립적입니다. |

311| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 응답에서 바이트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정합니다. 기본적으로 꺼져 있습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |311| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 응답에서 바이트 수준 스트리밍 유휴 감시견을 활성화하려면 `1`로 설정합니다. 기본적으로 꺼져 있습니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |

312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 이벤트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. {{/* min-version: 2.1.196 */}}설정하지 않으면 감시견은 모든 공급자에 대해 기본적으로 켜져 있습니다. v2.1.196 이전에는 설정하지 않은 기본값이 직접 Anthropic API에서 서버 제어이고 다른 공급자에서는 꺼져 있었습니다. {{/* min-version: 2.1.169 */}}v2.1.169부터 직접 Anthropic API 및 Claude Platform on AWS 이외의 공급자도 `API_FORCE_IDLE_TIMEOUT`에 설명된 독립적인 5분 본문 유휴 타임아웃을 가집니다. Amazon Bedrock에서는 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`로 독립적인 바이트 수준 감시견을 활성화할 수도 있습니다. 둘 다 설정하면 함께 실행됩니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |312| `CLAUDE_ENABLE_STREAM_WATCHDOG` | 이벤트 수준 스트리밍 유휴 감시견을 강제로 활성화하려면 `1`로 설정하거나, 강제로 비활성화하려면 `0`으로 설정합니다. {/* min-version: 2.1.196 */}설정하지 않으면 감시견은 모든 공급자에 대해 기본적으로 켜져 있습니다. v2.1.196 이전에는 설정하지 않은 기본값이 직접 Anthropic API에서 서버 제어이고 다른 공급자에서는 꺼져 있었습니다. {/* min-version: 2.1.169 */}v2.1.169부터 직접 Anthropic API 및 Claude Platform on AWS 이외의 공급자도 `API_FORCE_IDLE_TIMEOUT`에 설명된 독립적인 5분 본문 유휴 타임아웃을 가집니다. Amazon Bedrock에서는 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`로 독립적인 바이트 수준 감시견을 활성화할 수도 있습니다. 둘 다 설정하면 함께 실행됩니다. `CLAUDE_STREAM_IDLE_TIMEOUT_MS`로 타임아웃을 구성합니다. |

313| `CLAUDE_ENV_FILE` | Claude Code가 각 Bash 명령 전에 같은 셸 프로세스에서 실행하는 셸 스크립트의 경로이므로 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. [SessionStart](/ko/hooks#persist-environment-variables), [Setup](/ko/hooks#setup), [CwdChanged](/ko/hooks#cwdchanged), [FileChanged](/ko/hooks#filechanged) 훅으로도 동적으로 채워집니다. |313| `CLAUDE_ENV_FILE` | Claude Code가 각 Bash 명령 전에 같은 셸 프로세스에서 실행하는 셸 스크립트의 경로이므로 파일의 내보내기가 명령에 표시됩니다. virtualenv 또는 conda 활성화를 명령 간에 유지하는 데 사용합니다. [SessionStart](/ko/hooks#persist-environment-variables), [Setup](/ko/hooks#setup), [CwdChanged](/ko/hooks#cwdchanged), [FileChanged](/ko/hooks#filechanged) 훅으로도 동적으로 채워집니다. |

314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 명시적 이름이 제공되지 않을 때 자동 생성된 [Remote Control](/ko/remote-control) 세션 이름의 접두사입니다. 기본값은 머신의 호스트명이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. `--remote-control-session-name-prefix` CLI 플래그는 단일 호출에 대해 동일한 값을 설정합니다. |314| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 명시적 이름이 제공되지 않을 때 자동 생성된 [Remote Control](/ko/remote-control) 세션 이름의 접두사입니다. 기본값은 머신의 호스트명이며, `myhost-graceful-unicorn`과 같은 이름을 생성합니다. `--remote-control-session-name-prefix` CLI 플래그는 단일 호출에 대해 동일한 값을 설정합니다. |

315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 스트리밍 유휴 감시견이 정체된 연결을 닫기 전의 타임아웃(밀리초). 설정하지 않으면 이벤트 수준 감시견은 기본값 300초이고 바이트 수준 감시견은 직접 Anthropic API 연결에서 기본값 180초입니다(Claude Platform on AWS 및 다른 공급자에서 300초). 설정하지 않은 180초 바이트 감시견 기본값은 별개의 값이며 5분 제한을 받지 않습니다. `API_FORCE_IDLE_TIMEOUT`에 설명된 본문 유휴 타임아웃은 독립적으로 적용됩니다. Amazon Bedrock에서는 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`일 때도 적용됩니다. |315| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | 스트리밍 유휴 감시견이 정체된 연결을 닫기 전의 타임아웃(밀리초). 설정하지 않으면 이벤트 수준 감시견은 기본값 300초이고 바이트 수준 감시견은 직접 Anthropic API 연결에서 기본값 180초입니다(Claude Platform on AWS 및 다른 공급자에서 300초). 설정하지 않은 180초 바이트 감시견 기본값은 별개의 값이며 5분 제한을 받지 않습니다. `API_FORCE_IDLE_TIMEOUT`에 설명된 본문 유휴 타임아웃은 독립적으로 적용됩니다. Amazon Bedrock에서는 `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`일 때도 적용됩니다. |

318| `DISABLE_AUTO_COMPACT` | 컨텍스트 제한에 접근할 때 자동 압축을 비활성화하려면 `1`로 설정합니다. 수동 `/compact` 명령은 계속 사용 가능합니다. 압축이 발생하는 시기를 명시적으로 제어하려는 경우 사용합니다. |318| `DISABLE_AUTO_COMPACT` | 컨텍스트 제한에 접근할 때 자동 압축을 비활성화하려면 `1`로 설정합니다. 수동 `/compact` 명령은 계속 사용 가능합니다. 압축이 발생하는 시기를 명시적으로 제어하려는 경우 사용합니다. |

319| `DISABLE_COMPACT` | 자동 압축과 수동 `/compact` 명령을 포함한 모든 압축을 비활성화하려면 `1`로 설정합니다. |319| `DISABLE_COMPACT` | 자동 압축과 수동 `/compact` 명령을 포함한 모든 압축을 비활성화하려면 `1`로 설정합니다. |

320| `DISABLE_COST_WARNINGS` | 비용 경고 메시지를 비활성화하려면 `1`로 설정합니다. |320| `DISABLE_COST_WARNINGS` | 비용 경고 메시지를 비활성화하려면 `1`로 설정합니다. |

321| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/ko/commands#all-commands) 설정 점검 skill 및 `/checkup` 별칭을 숨기려면 `1`로 설정합니다. 사용자가 설치 진단을 실행하지 않아야 하는 관리형 배포에 유용합니다. `claude doctor` 터미널 명령에는 영향을 주지 않습니다. {{/* min-version: 2.1.205 */}}v2.1.205 이전에는 이 변수가 `/doctor` 진단 화면 명령을 숨겼습니다. |321| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/ko/commands#all-commands) 설정 점검 skill 및 `/checkup` 별칭을 숨기려면 `1`로 설정합니다. 사용자가 설치 진단을 실행하지 않아야 하는 관리형 배포에 유용합니다. `claude doctor` 터미널 명령에는 영향을 주지 않습니다. {/* min-version: 2.1.205 */}v2.1.205 이전에는 이 변수가 `/doctor` 진단 화면 명령을 숨겼습니다. |

322| `DISABLE_ERROR_REPORTING` | Sentry 오류 보고를 거부하려면 `1`로 설정합니다. |322| `DISABLE_ERROR_REPORTING` | Sentry 오류 보고를 거부하려면 `1`로 설정합니다. |

323| `DISABLE_EXTRA_USAGE_COMMAND` | 사용자가 속도 제한을 초과하여 추가 사용량을 구매할 수 있는 `/usage-credits` 명령을 숨기려면 `1`로 설정합니다. |323| `DISABLE_EXTRA_USAGE_COMMAND` | 사용자가 속도 제한을 초과하여 추가 사용량을 구매할 수 있는 `/usage-credits` 명령을 숨기려면 `1`로 설정합니다. |

324| `DISABLE_FEEDBACK_COMMAND` | `/feedback` 명령을 비활성화하려면 `1`로 설정합니다. 이전 이름 `DISABLE_BUG_COMMAND`도 허용됩니다. |324| `DISABLE_FEEDBACK_COMMAND` | `/feedback` 명령을 비활성화하려면 `1`로 설정합니다. 이전 이름 `DISABLE_BUG_COMMAND`도 허용됩니다. |

341| `ENABLE_PROMPT_CACHING_1H` | API 키, [Amazon Bedrock](/ko/amazon-bedrock), [Google Cloud's Agent Platform](/ko/google-vertex-ai), [Microsoft Foundry](/ko/microsoft-foundry), [Claude Platform on AWS](/ko/claude-platform-on-aws) 사용자를 위해 기본 5분 대신 1시간 [프롬프트 캐시 TTL](/ko/prompt-caching#cache-lifetime)을 요청하려면 `1`로 설정합니다. 구독 사용자는 자동으로 1시간 TTL을 받습니다. 1시간 캐시 쓰기는 더 높은 요금으로 청구됩니다. |341| `ENABLE_PROMPT_CACHING_1H` | API 키, [Amazon Bedrock](/ko/amazon-bedrock), [Google Cloud's Agent Platform](/ko/google-vertex-ai), [Microsoft Foundry](/ko/microsoft-foundry), [Claude Platform on AWS](/ko/claude-platform-on-aws) 사용자를 위해 기본 5분 대신 1시간 [프롬프트 캐시 TTL](/ko/prompt-caching#cache-lifetime)을 요청하려면 `1`로 설정합니다. 구독 사용자는 자동으로 1시간 TTL을 받습니다. 1시간 캐시 쓰기는 더 높은 요금으로 청구됩니다. |

342| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 더 이상 사용되지 않음. 대신 `ENABLE_PROMPT_CACHING_1H` 사용 |342| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 더 이상 사용되지 않음. 대신 `ENABLE_PROMPT_CACHING_1H` 사용 |

343| `ENABLE_TOOL_SEARCH` | [MCP 도구 검색](/ko/mcp#scale-with-mcp-tool-search)을 제어합니다. 설정 해제: 모든 MCP 도구는 기본적으로 연기되지만 Google Cloud's Agent Platform에서 또는 `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때 미리 로드됩니다. 값: `true`(항상 연기 및 베타 헤더 전송, Google Cloud's Agent Platform 모델 Sonnet 4.5 또는 Opus 4.5보다 이전 또는 `tool_reference`를 지원하지 않는 프록시에서 요청 실패), `auto`(임계값 모드: 도구가 컨텍스트의 10% 이내에 맞으면 미리 로드), `auto:N`(사용자 정의 임계값, 예: 5%의 경우 `auto:5`), `false`(모두 미리 로드) |343| `ENABLE_TOOL_SEARCH` | [MCP 도구 검색](/ko/mcp#scale-with-mcp-tool-search)을 제어합니다. 설정 해제: 모든 MCP 도구는 기본적으로 연기되지만 Google Cloud's Agent Platform에서 또는 `ANTHROPIC_BASE_URL`이 비자사 호스트를 가리킬 때 미리 로드됩니다. 값: `true`(항상 연기 및 베타 헤더 전송, Google Cloud's Agent Platform 모델 Sonnet 4.5 또는 Opus 4.5보다 이전 또는 `tool_reference`를 지원하지 않는 프록시에서 요청 실패), `auto`(임계값 모드: 도구가 컨텍스트의 10% 이내에 맞으면 미리 로드), `auto:N`(사용자 정의 임계값, 예: 5%의 경우 `auto:5`), `false`(모두 미리 로드) |

344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 모든 기본 모델에서 반복된 과부하 오류 후 폴백을 트리거하려면 비어 있지 않은 값으로 설정합니다. {{/* min-version: 2.1.160 */}}v2.1.160부터 구성된 [폴백 모델 체인](/ko/model-config#fallback-model-chains)은 모든 기본 모델에 대해 반복된 과부하 오류에서 트리거되므로 이 변수는 폴백 모델로 전환하는 데 영향을 주지 않습니다. |344| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 모든 기본 모델에서 반복된 과부하 오류 후 폴백을 트리거하려면 비어 있지 않은 값으로 설정합니다. {/* min-version: 2.1.160 */}v2.1.160부터 구성된 [폴백 모델 체인](/ko/model-config#fallback-model-chains)은 모든 기본 모델에 대해 반복된 과부하 오류에서 트리거되므로 이 변수는 폴백 모델로 전환하는 데 영향을 주지 않습니다. |

345| `FORCE_AUTOUPDATE_PLUGINS` | `DISABLE_AUTOUPDATER`를 통해 주 자동 업데이터가 비활성화된 경우에도 플러그인 자동 업데이트를 강제하려면 `1`로 설정합니다. |345| `FORCE_AUTOUPDATE_PLUGINS` | `DISABLE_AUTOUPDATER`를 통해 주 자동 업데이터가 비활성화된 경우에도 플러그인 자동 업데이트를 강제하려면 `1`로 설정합니다. |

346| `FORCE_PROMPT_CACHING_5M` | 1시간 TTL이 적용되는 경우에도 5분 프롬프트 캐시 TTL을 강제하려면 `1`로 설정합니다. `ENABLE_PROMPT_CACHING_1H` 재정의 |346| `FORCE_PROMPT_CACHING_5M` | 1시간 TTL이 적용되는 경우에도 5분 프롬프트 캐시 TTL을 강제하려면 `1`로 설정합니다. `ENABLE_PROMPT_CACHING_1H` 재정의 |

347| `HTTP_PROXY` | 네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다. |347| `HTTP_PROXY` | 네트워크 연결을 위한 HTTP 프록시 서버를 지정합니다. |

351| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드(`-p` 플래그)에서 모델의 응답이 [`--json-schema`](/ko/cli-reference#cli-flags)에 대한 유효성 검사에 실패할 때 재시도할 횟수입니다. 기본값은 5입니다. |351| `MAX_STRUCTURED_OUTPUT_RETRIES` | 비대화형 모드(`-p` 플래그)에서 모델의 응답이 [`--json-schema`](/ko/cli-reference#cli-flags)에 대한 유효성 검사에 실패할 때 재시도할 횟수입니다. 기본값은 5입니다. |

352| `MAX_THINKING_TOKENS` | [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 토큰 예산을 재정의합니다. 상한은 모델의 [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)에서 1을 뺀 값입니다. `0`으로 설정하여 Anthropic API에서 사고를 비활성화합니다. Fable 5는 사고를 끌 수 없으므로 이는 효과가 없습니다. [타사 공급자](/ko/third-party-integrations)에서 `0`은 마찬가지로 매개변수를 생략하므로 [적응형 추론](/ko/model-config#adjust-effort-level)이 있는 모델은 여전히 생각할 수 있습니다. 0이 아닌 값의 경우 적응형 추론 모델에서 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 통해 적응형 추론이 비활성화되지 않으면 예산이 무시됩니다. |352| `MAX_THINKING_TOKENS` | [확장 사고](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) 토큰 예산을 재정의합니다. 상한은 모델의 [최대 출력 토큰](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison)에서 1을 뺀 값입니다. `0`으로 설정하여 Anthropic API에서 사고를 비활성화합니다. Fable 5는 사고를 끌 수 없으므로 이는 효과가 없습니다. [타사 공급자](/ko/third-party-integrations)에서 `0`은 마찬가지로 매개변수를 생략하므로 [적응형 추론](/ko/model-config#adjust-effort-level)이 있는 모델은 여전히 생각할 수 있습니다. 0이 아닌 값의 경우 적응형 추론 모델에서 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`을 통해 적응형 추론이 비활성화되지 않으면 예산이 무시됩니다. |

353| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 방지합니다. |353| `MCP_CLIENT_SECRET` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)이 필요한 MCP 서버의 OAuth 클라이언트 시크릿입니다. `--client-secret`으로 서버를 추가할 때 대화형 프롬프트를 방지합니다. |

354| `MCP_CONNECTION_NONBLOCKING` | 시작이 첫 번째 쿼리 전에 MCP 서버 연결을 기다리는지 여부를 제어합니다. {{/* min-version: 2.1.142 */}}Claude Code v2.1.142부터 MCP 시작은 기본적으로 비블로킹입니다: 서버는 백그라운드에서 연결되고 완료되면 도구를 사용할 수 있게 됩니다. `0`으로 설정하여 블로킹 5초 연결 대기를 복원합니다. [`alwaysLoad: true`](/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 도구가 첫 번째 프롬프트를 빌드할 때 존재해야 하므로 이 변수와 관계없이 항상 시작을 차단합니다. |354| `MCP_CONNECTION_NONBLOCKING` | 시작이 첫 번째 쿼리 전에 MCP 서버 연결을 기다리는지 여부를 제어합니다. {/* min-version: 2.1.142 */}Claude Code v2.1.142부터 MCP 시작은 기본적으로 비블로킹입니다: 서버는 백그라운드에서 연결되고 완료되면 도구를 사용할 수 있게 됩니다. `0`으로 설정하여 블로킹 5초 연결 대기를 복원합니다. [`alwaysLoad: true`](/ko/mcp#exempt-a-server-from-deferral)로 구성된 서버는 도구가 첫 번째 프롬프트를 빌드할 때 존재해야 하므로 이 변수와 관계없이 항상 시작을 차단합니다. |

355| `MCP_CONNECT_TIMEOUT_MS` | 블로킹 MCP 시작이 연결 배치를 기다리는 시간(밀리초)을 설정하고 도구 목록을 스냅샷하기 전입니다(기본값: 5000). [`alwaysLoad: true`](/ko/mcp#exempt-a-server-from-deferral)로 표시된 서버에 적용됩니다. 마감 시점에 여전히 보류 중인 서버는 백그라운드에서 계속 연결되지만 다음 쿼리까지 나타나지 않습니다. `MCP_TIMEOUT`과 다르며, 이는 개별 서버의 연결 시도를 제한합니다. |355| `MCP_CONNECT_TIMEOUT_MS` | 블로킹 MCP 시작이 연결 배치를 기다리는 시간(밀리초)을 설정하고 도구 목록을 스냅샷하기 전입니다(기본값: 5000). [`alwaysLoad: true`](/ko/mcp#exempt-a-server-from-deferral)로 표시된 서버에 적용됩니다. 마감 시점에 여전히 보류 중인 서버는 백그라운드에서 계속 연결되지만 다음 쿼리까지 나타나지 않습니다. `MCP_TIMEOUT`과 다르며, 이는 개별 서버의 연결 시도를 제한합니다. |

356| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다. |356| `MCP_OAUTH_CALLBACK_PORT` | [사전 구성된 자격 증명](/ko/mcp#use-pre-configured-oauth-credentials)으로 MCP 서버를 추가할 때 `--callback-port`의 대안으로 OAuth 리디렉션 콜백의 고정 포트입니다. |

357| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 수(기본값: 20) |357| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 원격 MCP 서버(HTTP/SSE)의 최대 수(기본값: 20) |

358| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 수(기본값: 3) |358| `MCP_SERVER_CONNECTION_BATCH_SIZE` | 시작 중에 병렬로 연결할 로컬 MCP 서버(stdio)의 최대 수(기본값: 3) |

359| `MCP_TIMEOUT` | MCP 서버 시작의 타임아웃(밀리초)(기본값: 30000, 또는 30초) |359| `MCP_TIMEOUT` | MCP 서버 시작의 타임아웃(밀리초)(기본값: 30000, 또는 30초) |

360| `MCP_TOOL_TIMEOUT` | MCP 도구 실행의 타임아웃(밀리초)(기본값: 100000000, 약 28시간). 서버별 `.mcp.json`의 `timeout` 필드가 해당 서버에 대해 이를 재정의합니다. {{/* min-version: 2.1.203 */}}서버별 `timeout`이 최소 1000이면 해당 서버의 도구 호출에 대한 최소 유휴 윈도우를 설정하므로 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`이 더 빨리 중단하지 않습니다. 이 하한은 Claude Code v2.1.203 이상이 필요합니다. 환경 변수의 경우 1000 미만의 값은 1초로 내림됩니다. 서버별 필드의 경우 1000 미만의 값은 무시됩니다. |360| `MCP_TOOL_TIMEOUT` | MCP 도구 실행의 타임아웃(밀리초)(기본값: 100000000, 약 28시간). 서버별 `.mcp.json`의 `timeout` 필드가 해당 서버에 대해 이를 재정의합니다. {/* min-version: 2.1.203 */}서버별 `timeout`이 최소 1000이면 해당 서버의 도구 호출에 대한 최소 유휴 윈도우를 설정하므로 `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`이 더 빨리 중단하지 않습니다. 이 하한은 Claude Code v2.1.203 이상이 필요합니다. 환경 변수의 경우 1000 미만의 값은 1초로 내림됩니다. 서버별 필드의 경우 1000 미만의 값은 무시됩니다. |

361| `NO_PROXY` | 프록시를 우회하여 직접 발급될 요청의 도메인 및 IP 목록 |361| `NO_PROXY` | 프록시를 우회하여 직접 발급될 요청의 도메인 및 IP 목록 |

362| `OTEL_LOG_ASSISTANT_RESPONSES` | {{/* min-version: 2.1.193 */}}모델의 응답 텍스트를 `assistant_response` OpenTelemetry 로그 이벤트에 포함하려면 `1`로 설정합니다. 설정하지 않으면 `OTEL_LOG_USER_PROMPTS`의 값이 사용됩니다. `OTEL_LOG_USER_PROMPTS`가 설정된 경우에도 응답을 수정된 상태로 유지하려면 `0`으로 설정합니다. Claude Code v2.1.193 이상이 필요합니다. [모니터링](/ko/monitoring-usage#assistant-response-event) 참조 |362| `OTEL_LOG_ASSISTANT_RESPONSES` | {/* min-version: 2.1.193 */}모델의 응답 텍스트를 `assistant_response` OpenTelemetry 로그 이벤트에 포함하려면 `1`로 설정합니다. 설정하지 않으면 `OTEL_LOG_USER_PROMPTS`의 값이 사용됩니다. `OTEL_LOG_USER_PROMPTS`가 설정된 경우에도 응답을 수정된 상태로 유지하려면 `0`으로 설정합니다. Claude Code v2.1.193 이상이 필요합니다. [모니터링](/ko/monitoring-usage#assistant-response-event) 참조 |

363| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API 요청 및 응답 JSON을 `api_request_body` / `api_response_body` 로그 이벤트로 내보냅니다. 60KB에서 잘린 인라인 본문의 경우 `1`로 설정하거나, 잘리지 않은 본문을 디스크에 쓰고 `body_ref` 경로를 내보내려면 `file:<dir>`로 설정합니다. 기본적으로 비활성화됩니다. 본문에는 전체 대화 기록이 포함됩니다. [모니터링](/ko/monitoring-usage#api-request-body-event) 참조 |363| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API 요청 및 응답 JSON을 `api_request_body` / `api_response_body` 로그 이벤트로 내보냅니다. 60KB에서 잘린 인라인 본문의 경우 `1`로 설정하거나, 잘리지 않은 본문을 디스크에 쓰고 `body_ref` 경로를 내보내려면 `file:<dir>`로 설정합니다. 기본적으로 비활성화됩니다. 본문에는 전체 대화 기록이 포함됩니다. [모니터링](/ko/monitoring-usage#api-request-body-event) 참조 |

364| `OTEL_LOG_TOOL_CONTENT` | 도구 입력 및 출력 내용을 OpenTelemetry 스팬 이벤트에 포함하려면 `1`로 설정합니다. 민감한 데이터를 보호하기 위해 기본적으로 비활성화됩니다. [모니터링](/ko/monitoring-usage) 참조 |364| `OTEL_LOG_TOOL_CONTENT` | 도구 입력 및 출력 내용을 OpenTelemetry 스팬 이벤트에 포함하려면 `1`로 설정합니다. 민감한 데이터를 보호하기 위해 기본적으로 비활성화됩니다. [모니터링](/ko/monitoring-usage) 참조 |

365| `OTEL_LOG_TOOL_DETAILS` | 도구 입력 인수, MCP 서버 이름, 사용자 작성 워크플로우 이름, 도구 실패 시 원본 오류 문자열, `api_refusal` 이벤트의 거부 `category`, 기타 도구 세부 정보를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. PII를 보호하기 위해 기본적으로 비활성화됩니다. [모니터링](/ko/monitoring-usage) 참조 |365| `OTEL_LOG_TOOL_DETAILS` | 도구 입력 인수, MCP 서버 이름, 사용자 작성 워크플로우 이름, 도구 실패 시 원본 오류 문자열, `api_refusal` 이벤트의 거부 `category`, 기타 도구 세부 정보를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. PII를 보호하기 위해 기본적으로 비활성화됩니다. [모니터링](/ko/monitoring-usage) 참조 |

366| `OTEL_LOG_USER_PROMPTS` | 사용자 프롬프트 텍스트를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. 기본적으로 비활성화됩니다(프롬프트는 수정됨). [모니터링](/ko/monitoring-usage) 참조 |366| `OTEL_LOG_USER_PROMPTS` | 사용자 프롬프트 텍스트를 OpenTelemetry 추적 및 로그에 포함하려면 `1`로 설정합니다. 기본적으로 비활성화됩니다(프롬프트는 수정됨). [모니터링](/ko/monitoring-usage) 참조 |

367| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 메트릭 속성에서 계정 UUID를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/ko/monitoring-usage) 참조 |367| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 메트릭 속성에서 계정 UUID를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/ko/monitoring-usage) 참조 |

368| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {{/* min-version: 2.1.152 */}}메트릭 속성에 세션 진입점을 포함하려면 `true`로 설정합니다(기본값: 제외). v2.1.152에서 추가됨. [모니터링](/ko/monitoring-usage) 참조 |368| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}메트릭 속성에 세션 진입점을 포함하려면 `true`로 설정합니다(기본값: 제외). v2.1.152에서 추가됨. [모니터링](/ko/monitoring-usage) 참조 |

369| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {{/* min-version: 2.1.161 */}}v2.1.161부터 Claude Code는 `OTEL_RESOURCE_ATTRIBUTES` 키를 메트릭 데이터포인트 레이블에 첨부합니다. 이를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/ko/monitoring-usage#multi-team-organization-support) 참조 |369| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | {/* min-version: 2.1.161 */}v2.1.161부터 Claude Code는 `OTEL_RESOURCE_ATTRIBUTES` 키를 메트릭 데이터포인트 레이블에 첨부합니다. 이를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/ko/monitoring-usage#multi-team-organization-support) 참조 |

370| `OTEL_METRICS_INCLUDE_SESSION_ID` | 메트릭 속성에서 세션 ID를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/ko/monitoring-usage) 참조 |370| `OTEL_METRICS_INCLUDE_SESSION_ID` | 메트릭 속성에서 세션 ID를 제외하려면 `false`로 설정합니다(기본값: 포함). [모니터링](/ko/monitoring-usage) 참조 |

371| `OTEL_METRICS_INCLUDE_VERSION` | 메트릭 속성에 Claude Code 버전을 포함하려면 `true`로 설정합니다(기본값: 제외). [모니터링](/ko/monitoring-usage) 참조 |371| `OTEL_METRICS_INCLUDE_VERSION` | 메트릭 속성에 Claude Code 버전을 포함하려면 `true`로 설정합니다(기본값: 제외). [모니터링](/ko/monitoring-usage) 참조 |

372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill 도구](/ko/skills#control-who-invokes-a-skill)에 표시되는 skill 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 윈도우의 1%에서 동적으로 확장되며, 8,000자의 폴백이 있습니다. 이전 버전과의 호환성을 위해 레거시 이름이 유지됩니다. |372| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill 도구](/ko/skills#control-who-invokes-a-skill)에 표시되는 skill 메타데이터의 문자 예산을 재정의합니다. 예산은 컨텍스트 윈도우의 1%에서 동적으로 확장되며, 8,000자의 폴백이 있습니다. 이전 버전과의 호환성을 위해 레거시 이름이 유지됩니다. |

382| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Google Cloud's Agent Platform 사용 시 Claude Sonnet 4.5의 리전을 재정의합니다. |382| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Google Cloud's Agent Platform 사용 시 Claude Sonnet 4.5의 리전을 재정의합니다. |

383| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Google Cloud's Agent Platform 사용 시 Claude Opus 4.6의 리전을 재정의합니다. |383| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Google Cloud's Agent Platform 사용 시 Claude Opus 4.6의 리전을 재정의합니다. |

384| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Google Cloud's Agent Platform 사용 시 Claude Sonnet 4.6의 리전을 재정의합니다. |384| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Google Cloud's Agent Platform 사용 시 Claude Sonnet 4.6의 리전을 재정의합니다. |

385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {{/* min-version: 2.1.111 */}}Google Cloud's Agent Platform 사용 시 Claude Opus 4.7의 리전을 재정의합니다. v2.1.111에서 추가됨. |385| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Google Cloud's Agent Platform 사용 시 Claude Opus 4.7의 리전을 재정의합니다. v2.1.111에서 추가됨. |

386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {{/* min-version: 2.1.154 */}}Google Cloud's Agent Platform 사용 시 Claude Opus 4.8의 리전을 재정의합니다. v2.1.154에서 추가됨. |386| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Google Cloud's Agent Platform 사용 시 Claude Opus 4.8의 리전을 재정의합니다. v2.1.154에서 추가됨. |

387| `VERTEX_REGION_CLAUDE_5_SONNET` | {{/* min-version: 2.1.197 */}}Google Cloud's Agent Platform 사용 시 Claude Sonnet 5의 리전을 재정의합니다. v2.1.197에서 추가됨. |387| `VERTEX_REGION_CLAUDE_5_SONNET` | {/* min-version: 2.1.197 */}Google Cloud's Agent Platform 사용 시 Claude Sonnet 5의 리전을 재정의합니다. v2.1.197에서 추가됨. |

388| `VERTEX_REGION_CLAUDE_FABLE_5` | {{/* min-version: 2.1.170 */}}Google Cloud's Agent Platform 사용 시 Claude Fable 5의 리전을 재정의합니다. v2.1.170에서 추가됨. |388| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Google Cloud's Agent Platform 사용 시 Claude Fable 5의 리전을 재정의합니다. v2.1.170에서 추가됨. |

389| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Google Cloud's Agent Platform 사용 시 Claude Haiku 4.5의 리전을 재정의합니다. |389| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Google Cloud's Agent Platform 사용 시 Claude Haiku 4.5의 리전을 재정의합니다. |

390 390 

391표준 OpenTelemetry 내보내기 변수(`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` 및 신호별 변형)도 지원됩니다. 구성 세부 정보는 [모니터링](/ko/monitoring-usage)을 참조합니다.391표준 OpenTelemetry 내보내기 변수(`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` 및 신호별 변형)도 지원됩니다. 구성 세부 정보는 [모니터링](/ko/monitoring-usage)을 참조합니다.

283You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

284```284```

285 285 

286Claude Code는 메시지에 표시된 재설정 시간까지 추가 요청을 차단합니다.286Claude Code는 메시지에 표시된 재설정 시간까지 추가 요청을 차단합니다. 세션 및 주간 한도는 모든 모델에서 공유되므로 모델을 전환해도 액세스가 복구되지 않습니다. Opus 한도는 Opus 요청에만 적용되므로 `/model`로 다른 모델로 전환하면 계속 작업할 수 있습니다.

287 287 

288**수행할 작업:**288**수행할 작업:**

289 289 

290* 오류에 표시된 재설정 시간까지 기다립니다290* 오류에 표시된 재설정 시간까지 기다립니다

291* Opus 한도의 경우 `/model`을 실행하고 다른 모델로 전환하여 계속 작업합니다

291* `/usage`를 실행하여 플랜 한도 및 재설정 시간을 확인합니다292* `/usage`를 실행하여 플랜 한도 및 재설정 시간을 확인합니다

292* `/usage-credits`를 실행하여 Pro 및 Max에서 추가 사용량을 구매하거나, Team 및 Enterprise에서 관리자에게 요청합니다. 이 요금이 청구되는 방식에 대해서는 [유료 플랜의 사용 크레딧](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)을 참조하세요.293* `/usage-credits`를 실행하여 Pro 및 Max에서 추가 사용량을 구매하거나, Team 및 Enterprise에서 관리자에게 요청합니다. 이 요금이 청구되는 방식에 대해서는 [유료 플랜의 사용 크레딧](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)을 참조하세요.

293* 더 높은 기본 한도를 위해 플랜을 업그레이드하려면 [claude.com/pricing](https://claude.com/pricing)을 참조하세요.294* 더 높은 기본 한도를 위해 플랜을 업그레이드하려면 [claude.com/pricing](https://claude.com/pricing)을 참조하세요.

18 Opus 4.7의 빠른 모드는 2026년 6월 25일부터 더 이상 사용되지 않으며 2026년 7월 24일에 제거될 예정입니다. 제거 후 Opus 4.7의 빠른 모드 요청은 오류를 반환하며 표준 Opus 4.7로 폴백되지 않습니다. 속도 향상을 유지하려면 Opus 4.8로 마이그레이션하십시오.18 Opus 4.7의 빠른 모드는 2026년 6월 25일부터 더 이상 사용되지 않으며 2026년 7월 24일에 제거될 예정입니다. 제거 후 Opus 4.7의 빠른 모드 요청은 오류를 반환하며 표준 Opus 4.7로 폴백되지 않습니다. 속도 향상을 유지하려면 Opus 4.8로 마이그레이션하십시오.

19</Warning>19</Warning>

20 20 

21<Note>

22 빠른 모드는 Claude Code v2.1.36 이상이 필요합니다. `claude --version`으로 버전을 확인하십시오.

23</Note>

24 

25알아야 할 사항:21알아야 할 사항:

26 22 

27* Claude Code CLI에서 `/fast`를 사용하여 빠른 모드를 전환합니다. 빠른 모드는 VS Code 확장 프로그램에서 지원되지 않습니다.23* Claude Code CLI에서 `/fast`를 사용하여 빠른 모드를 전환합니다. 빠른 모드는 VS Code 확장 프로그램에서 지원되지 않습니다.

38* `/fast`를 입력하고 Tab을 눌러 켜거나 끕니다34* `/fast`를 입력하고 Tab을 눌러 켜거나 끕니다

39* [사용자 설정 파일](/ko/settings)에서 `"fastMode": true`를 설정합니다35* [사용자 설정 파일](/ko/settings)에서 `"fastMode": true`를 설정합니다

40 36 

41기본적으로 빠른 모드는 대화형 세션에서 켜면 세션 간에 유지됩니다. {/* min-version: 2.1.205 */}[비대화형 모드](/ko/headless)에서 `-p` 플래그를 사용하면, `/fast`는 [`--settings`](/ko/cli-reference#cli-flags) 값에 빠른 모드가 켜져 있는 상태로 시작된 세션에서만 작동합니다. 예를 들어 `claude -p --settings '{"fastMode": true}'`와 같이 사용하면, 토글이 해당 세션에만 적용되며 기본값으로 저장되지 않으며, 다른 비대화형 세션에서는 빠른 모드를 사용할 수 없다는 명령 보고가 나타납니다. 관리자는 빠른 모드를 각 세션마다 재설정하도록 구성할 수 있습니다. 자세한 내용은 [세션별 옵트인 필요](#require-per-session-opt-in)를 참조합니다.37기본적으로 빠른 모드는 대화형 세션에서 켜면 세션 간에 유지됩니다. {/* min-version: 2.1.205 */}[비대화형 모드](/ko/headless)에서 `-p` 플래그를 사용하면, `/fast`는 [`--settings`](/ko/cli-reference#cli-flags) 값에 빠른 모드가 켜져 있는 상태로 시작된 세션에서만 작동합니다. 예를 들어 `claude -p --settings '{"fastMode": true}'`와 같이 사용하면, 토글이 해당 세션에만 적용되며 기본값으로 저장되지 않으며, 다른 비대화형 세션에서는 빠른 모드를 사용할 수 없다는 명령 보고가 나타납니다. 빠른 모드를 각 세션마다 재설정하도록 구성할 수 있습니다. 자세한 내용은 [세션별 옵트인 필요](#require-per-session-opt-in)를 참조합니다.

42 38 

43최상의 비용 효율성을 위해 대화 중간에 전환하기보다는 세션 시작 시 빠른 모드를 활성화합니다. 자세한 내용은 [비용 트레이드오프 이해](#understand-the-cost-tradeoff)를 참조합니다.39최상의 비용 효율성을 위해 대화 중간에 전환하기보다는 세션 시작 시 빠른 모드를 활성화합니다. 자세한 내용은 [비용 트레이드오프 이해](#understand-the-cost-tradeoff)를 참조합니다.

44 40 

131 세션별 옵트인 필요127 세션별 옵트인 필요

132</h3>128</h3>

133 129 

134기본적으로 빠른 모드는 세션 간에 유지됩니다: 사용자가 빠른 모드를 활성화하면 향후 세션에서도 켜져 있습니다. [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) 또는 [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) 요금제의 관리자는 [관리되는 설정](/ko/settings#settings-files) 또는 [서버 관리 설정](/ko/server-managed-settings)에서 `fastModePerSessionOptIn`을 `true`로 설정하여 이를 방지할 수 있습니다. 이로 인해 각 세션이 빠른 모드가 꺼진 상태로 시작되며, 사용자가 `/fast`로 명시적으로 활성화해야 합니다.130기본적으로 빠른 모드는 세션 간에 유지됩니다: 사용자가 빠른 모드를 활성화하면 향후 세션에서도 켜져 있습니다. 이를 변경하려면 [설정 파일](/ko/settings#settings-files)에서 `fastModePerSessionOptIn`을 `true`로 설정합니다. 이로 인해 각 세션이 빠른 모드가 꺼진 상태로 시작되며, 사용자가 `/fast`로 명시적으로 활성화해야 합니다. [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) 또는 [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) 요금제의 관리자는 [서버 관리 설정](/ko/server-managed-settings)을 통해 조직 전체에 배포할 수 있습니다.

135 131 

136```json theme={null}132```json theme={null}

137{133{

169 <tbody>169 <tbody>

170 <tr>170 <tr>

171 <td>[분석 대시보드 및 API](/ko/analytics)</td>171 <td>[분석 대시보드 및 API](/ko/analytics)</td>

172 <td>✓ (Team 및 Enterprise)</td>172 <td>✓ (대시보드: Team 및 Enterprise; API: Enterprise)</td>

173 <td>✓ <sup><a href="#fn5">5</a></sup></td>173 <td>✓ <sup><a href="#fn5">5</a></sup></td>

174 <td>✗</td>174 <td>✗</td>

175 <td>✗</td>175 <td>✗</td>

287| Dispatch ([Desktop](/ko/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |287| Dispatch ([Desktop](/ko/desktop#sessions-from-dispatch)) | ✓ | ✓ | ✗ | ✗ |

288| [Code Review](/ko/code-review) | ✗ | ✗ | ✓ | ✓ |288| [Code Review](/ko/code-review) | ✗ | ✗ | ✓ | ✓ |

289| [Artifacts](/ko/artifacts) | ✓ | ✓ | ✓ | 관리자 활성화 |289| [Artifacts](/ko/artifacts) | ✓ | ✓ | ✓ | 관리자 활성화 |

290| [분석 대시보드, API, 기여도 메트릭](/ko/analytics) | ✗ | ✗ | ✓ | ✓ |290| [분석 대시보드 및 기여도 메트릭](/ko/analytics) | ✗ | ✗ | ✓ | ✓ |

291| [Enterprise Analytics API](/ko/analytics#access-data-programmatically) | ✗ | ✗ | ✗ | ✓ |

291| [서버 관리 설정](/ko/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |292| [서버 관리 설정](/ko/server-managed-settings) | ✗ | ✗ | ✓ | ✓ |

292| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |293| [SSO](https://support.claude.com/en/articles/9266767-what-is-the-team-plan) | ✗ | ✗ | ✓ | ✓ |

293| SCIM | ✗ | ✗ | ✗ | ✓ |294| SCIM | ✗ | ✗ | ✗ | ✓ |

7> 마우스 지원과 안정적인 메모리 사용으로 더 부드럽고 깜빡임 없는 렌더링 모드를 활성화합니다.7> 마우스 지원과 안정적인 메모리 사용으로 더 부드럽고 깜빡임 없는 렌더링 모드를 활성화합니다.

8 8 

9<Note>9<Note>

10 전체 화면 렌더링은 선택적 [연구 미리보기](#research-preview)이며 Claude Code v2.1.89 이상이 필요합니다. 현재 대화에서 `/tui fullscreen`을 실행하여 전환하거나, v2.1.110 이전 버전에서 `CLAUDE_CODE_NO_FLICKER=1`을 설정합니다. 피드백에 따라 동작이 변경될 수 있습니다.10 전체 화면 렌더링은 선택적 [연구 미리보기](#research-preview)입니다. 현재 대화에서 `/tui fullscreen`을 실행하여 전환하거나, v2.1.110 이전 버전에서 `CLAUDE_CODE_NO_FLICKER=1`을 설정합니다. 피드백에 따라 동작이 변경될 수 있습니다.

11</Note>11</Note>

12 12 

13전체 화면 렌더링은 Claude Code CLI의 대체 렌더링 경로로, 깜빡임을 제거하고 긴 대화에서 메모리 사용량을 일정하게 유지하며 마우스 지원을 추가합니다. `vim` 또는 `htop`처럼 터미널의 대체 화면 버퍼에 인터페이스를 그리고 현재 표시되는 메시지만 렌더링합니다. 이렇게 하면 각 업데이트 시 터미널로 전송되는 데이터의 양이 줄어듭니다.13전체 화면 렌더링은 Claude Code CLI의 대체 렌더링 경로로, 깜빡임을 제거하고 긴 대화에서 메모리 사용량을 일정하게 유지하며 마우스 지원을 추가합니다. `vim` 또는 `htop`처럼 터미널의 대체 화면 버퍼에 인터페이스를 그리고 현재 표시되는 메시지만 렌더링합니다. 이렇게 하면 각 업데이트 시 터미널로 전송되는 데이터의 양이 줄어듭니다.

213 213 

214클릭이 비활성화되면 Claude Code는 여전히 마우스를 캡처하므로 휠과 터치패드가 대화를 스크롤하지만 Claude Code 내에서 왼쪽 클릭은 아무 작동도 하지 않습니다. 기본 클릭 및 드래그 선택을 위해 터미널의 키를 누른 상태로 유지해야 합니다. 오른쪽 클릭과 중간 클릭 붙여넣기는 이를 지원하는 터미널에서 계속 작동합니다.214클릭이 비활성화되면 Claude Code는 여전히 마우스를 캡처하므로 휠과 터치패드가 대화를 스크롤하지만 Claude Code 내에서 왼쪽 클릭은 아무 작동도 하지 않습니다. 기본 클릭 및 드래그 선택을 위해 터미널의 키를 누른 상태로 유지해야 합니다. 오른쪽 클릭과 중간 클릭 붙여넣기는 이를 지원하는 터미널에서 계속 작동합니다.

215 215 

216<h2 id="troubleshooting">

217 문제 해결

218</h2>

219 

220<h3 id="stale-or-misplaced-text-on-screen">

221 화면에 오래된 텍스트 또는 잘못된 위치의 텍스트

222</h3>

223 

224전체 화면 렌더링은 프레임 간에 변경된 셀만 전송합니다. 가장 일반적으로 Windows Terminal 및 기타 ConPTY 기반 호스트에서 이러한 위치 지정 쓰기를 잘못 병합하여 창 크기를 조정할 때까지 이전 출력의 조각이 화면에 남아 있습니다.

225 

226증분 업데이트를 전송하는 대신 모든 프레임에서 모든 셀을 다시 칠하도록 [`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1`](/ko/env-vars)을 설정합니다.

227 

228Windows PowerShell에서:

229 

230```powershell theme={null}

231$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"

232claude

233```

234 

235macOS 또는 Linux에서:

236 

237```bash theme={null}

238CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 claude

239```

240 

241Windows에서는 Claude Code가 이미 백그라운드 세션 및 [에이전트 보기](/ko/agent-view)에 대해 자동으로 전체 다시 칠하기를 활성화하므로, 직접 시작한 대화형 전체 화면 세션에 대해서만 변수를 설정하면 됩니다.

242 

216<h2 id="research-preview">243<h2 id="research-preview">

217 연구 미리보기244 연구 미리보기

218</h2>245</h2>

104 Checkpoint104 Checkpoint

105</h3>105</h3>

106 106 

107각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 로컬이며, git과 별개이고, Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.107각 프롬프트를 전송할 때마다 생성되는 복원 지점입니다. Claude Code는 모든 편집 전에 파일을 스냅샷하므로 체크포인트가 파일을 되돌릴 수 있습니다. `Esc`를 두 번 누르거나 `/rewind`를 실행하여 코드, 대화 또는 둘 다를 이전 지점으로 복원하거나, 선택한 메시지에서 대화의 일부를 요약합니다. 체크포인트는 세션에 저장되므로 재개된 세션도 여전히 `/rewind`를 사용하여 이들로 돌아갈 수 있습니다. 이들은 git과 별개이며 Bash 도구를 통해 수행된 변경 사항을 추적하지 않습니다.

108 108 

109자세히 알아보기: [체크포인팅](/ko/checkpointing)109자세히 알아보기: [체크포인팅](/ko/checkpointing)

110 110 

236 Non-interactive mode236 Non-interactive mode

237</h3>237</h3>

238 238 

239`-p` 또는 `--print`로 호출되는 단일 프롬프트를 실행하고 대화형 세션 없이 종료하는 모드입니다. CI, 스크립트 및 파이핑에 사용됩니다. [Agent SDK](/ko/agent-sdk/overview)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.239`-p` 또는 `--print`로 호출되는 단일 프롬프트를 실행하고 대화형 프롬프트 없이 종료하는 모드입니다. CI, 스크립트 및 파이핑에 사용됩니다. `--no-session-persistence`를 전달하지 않는 한 실행은 여전히 재개 가능한 세션으로 저장됩니다. [Agent SDK](/ko/agent-sdk/overview)는 Python 및 TypeScript 동등물입니다. 이전에는 headless mode라고 불렸습니다.

240 240 

241자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/ko/headless)241자세히 알아보기: [Claude Code를 프로그래밍 방식으로 실행](/ko/headless)

242 242 

98 98 

99Google Cloud 자격증명이 있고 Google Cloud의 Agent Platform을 통해 Claude Code 사용을 시작하려면 로그인 마법사가 이를 안내합니다. GCP 측 필수 요구사항을 프로젝트당 한 번 완료하면 마법사가 Claude Code 측을 처리합니다.99Google Cloud 자격증명이 있고 Google Cloud의 Agent Platform을 통해 Claude Code 사용을 시작하려면 로그인 마법사가 이를 안내합니다. GCP 측 필수 요구사항을 프로젝트당 한 번 완료하면 마법사가 Claude Code 측을 처리합니다.

100 100 

101<Note>

102 Google Cloud의 Agent Platform 설정 마법사는 Claude Code v2.1.98 이상이 필요합니다. `claude --version`을 실행하여 확인하십시오.

103</Note>

104 

105<Steps>101<Steps>

106 <Step title="GCP 프로젝트에서 Claude 모델 활성화">102 <Step title="GCP 프로젝트에서 Claude 모델 활성화">

107 프로젝트에 대해 [Google Cloud의 Agent Platform API 활성화](#1-enable-agent-platform-api)한 다음 [Google Cloud의 Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)에서 원하는 Claude 모델에 대한 액세스를 요청합니다. 계정에 필요한 권한은 [IAM 구성](#iam-configuration)을 참조하십시오.103 프로젝트에 대해 [Google Cloud의 Agent Platform API 활성화](#1-enable-agent-platform-api)한 다음 [Google Cloud의 Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)에서 원하는 Claude 모델에 대한 액세스를 요청합니다. 계정에 필요한 권한은 [IAM 구성](#iam-configuration)을 참조하십시오.

262 시작 모델 확인258 시작 모델 확인

263</h2>259</h2>

264 260 

265Claude Code가 Google Cloud의 Agent Platform으로 구성되어 시작할 때 사용하려는 모델이 프로젝트에서 액세스 가능한지 확인합니다. 이 확인에는 Claude Code v2.1.98 이상이 필요합니다.261Claude Code가 Google Cloud의 Agent Platform으로 구성되어 시작할 때 사용하려는 모델이 프로젝트에서 액세스 가능한지 확인합니다.

266 262 

267현재 Claude Code 기본값보다 오래된 모델 버전을 고정했고 프로젝트가 최신 버전을 호출할 수 있으면 Claude Code는 고정을 업데이트하라는 메시지를 표시합니다. 수락하면 새 모델 ID를 [사용자 설정 파일](/ko/settings)에 쓰고 Claude Code를 다시 시작합니다. 거절하면 다음 기본 버전 변경까지 기억됩니다.263현재 Claude Code 기본값보다 오래된 모델 버전을 고정했고 프로젝트가 최신 버전을 호출할 수 있으면 Claude Code는 고정을 업데이트하라는 메시지를 표시합니다. 수락하면 새 모델 ID를 [사용자 설정 파일](/ko/settings)에 쓰고 Claude Code를 다시 시작합니다. 거절하면 다음 기본 버전 변경까지 기억됩니다.

268 264 

1650 1650 

1651`"defer"`는 Claude Code를 subprocess로 실행하고 JSON 출력을 읽는 Agent SDK 앱 또는 Claude Code 위에 구축된 사용자 정의 UI와 같은 통합을 위한 것입니다. 이를 통해 호출 프로세스가 Claude를 도구 호출에서 일시 중지하고 자신의 인터페이스를 통해 입력을 수집하고 중단된 위치에서 재개할 수 있습니다. Claude Code는 [비대화형 모드](/ko/headless)에서 `-p` 플래그를 사용할 때만 이 값을 준수합니다. 대화형 세션에서는 경고를 기록하고 hook 결과를 무시합니다.1651`"defer"`는 Claude Code를 subprocess로 실행하고 JSON 출력을 읽는 Agent SDK 앱 또는 Claude Code 위에 구축된 사용자 정의 UI와 같은 통합을 위한 것입니다. 이를 통해 호출 프로세스가 Claude를 도구 호출에서 일시 중지하고 자신의 인터페이스를 통해 입력을 수집하고 중단된 위치에서 재개할 수 있습니다. Claude Code는 [비대화형 모드](/ko/headless)에서 `-p` 플래그를 사용할 때만 이 값을 준수합니다. 대화형 세션에서는 경고를 기록하고 hook 결과를 무시합니다.

1652 1652 

1653<Note>

1654 `defer` 값은 Claude Code v2.1.89 이상이 필요합니다. 이전 버전은 이를 인식하지 못하고 도구는 일반 권한 흐름을 통해 진행됩니다.

1655</Note>

1656 

1657일반적인 경우는 `AskUserQuestion` 도구입니다: Claude가 사용자에게 뭔가를 묻고 싶지만 답변할 터미널이 없습니다. 왕복은 다음과 같이 작동합니다:1653일반적인 경우는 `AskUserQuestion` 도구입니다: Claude가 사용자에게 뭔가를 묻고 싶지만 답변할 터미널이 없습니다. 왕복은 다음과 같이 작동합니다:

1658 1654 

16591. Claude가 `AskUserQuestion`을 호출합니다. `PreToolUse` hook이 발생합니다.16551. Claude가 `AskUserQuestion`을 호출합니다. `PreToolUse` hook이 발생합니다.

695 </Tab>695 </Tab>

696 696 

697 <Tab title="MCP 도구 일치">697 <Tab title="MCP 도구 일치">

698 MCP 도구는 기본 제공 도구와 다른 명명 규칙을 사용합니다: `mcp__<server>__<tool>`. 여기서 `<server>`는 MCP 서버 이름이고 `<tool>`은 제공하는 도구입니다. 예를 들어 `mcp__github__search_repositories` 또는 `mcp__filesystem__read_file`. 정규식 matcher를 사용하여 특정 서버의 모든 도구를 대상으로 하거나 `mcp__.*__write.*`와 같은 패턴으로 서버 전체에서 일치합니다. 참조의 [MCP 도구 일치](/ko/hooks#match-mcp-tools)를 참조하여 전체 예제 목록을 확인하세요.698 MCP 도구는 기본 제공 도구와 다른 명명 규칙을 사용합니다: `mcp__<server>__<tool>`. 여기서 `<server>`는 MCP 서버 이름이고 `<tool>`은 제공하는 도구입니다. 예를 들어 `mcp__github__search_repositories` 또는 `mcp__filesystem__read_file`. [플러그인 번들 서버](/ko/mcp#plugin-provided-mcp-servers)의 도구는 대신 `mcp__plugin_my-plugin_db__query`와 같은 범위가 지정된 서버 세그먼트를 사용합니다. 정규식 matcher를 사용하여 특정 서버의 모든 도구를 대상으로 하거나 `mcp__.*__write.*`와 같은 패턴으로 서버 전체에서 일치합니다. 참조의 [MCP 도구 일치](/ko/hooks#match-mcp-tools)를 참조하여 전체 예제 목록을 확인하세요.

699 699 

700 아래 명령은 hook의 JSON 입력에서 `jq`를 사용하여 도구 이름을 추출하고 stderr에 씁니다. stderr는 stdout을 깨끗하게 유지하고 메시지를 [디버그 로그](/ko/hooks#debug-hooks)로 보냅니다:700 아래 명령은 hook의 JSON 입력에서 `jq`를 사용하여 도구 이름을 추출하고 stderr에 씁니다. stderr는 stdout을 깨끗하게 유지하고 메시지를 [디버그 로그](/ko/hooks#debug-hooks)로 보냅니다:

701 701 

747 도구 이름 및 인수로 `if` 필드를 사용하여 필터링747 도구 이름 및 인수로 `if` 필드를 사용하여 필터링

748</h4>748</h4>

749 749 

750<Note>

751 `if` 필드는 Claude Code v2.1.85 이상이 필요합니다. 이전 버전은 이를 무시하고 일치하는 모든 호출에서 hook을 실행합니다.

752</Note>

753 

754`if` 필드는 [권한 규칙 구문](/ko/permissions)을 사용하여 도구 이름과 인수를 함께 사용하여 hooks를 필터링하므로 hook 프로세스는 도구 호출이 일치할 때만 생성됩니다. 이는 도구 이름만으로 그룹 수준에서 필터링하는 `matcher`를 초과합니다.750`if` 필드는 [권한 규칙 구문](/ko/permissions)을 사용하여 도구 이름과 인수를 함께 사용하여 hooks를 필터링하므로 hook 프로세스는 도구 호출이 일치할 때만 생성됩니다. 이는 도구 이름만으로 그룹 수준에서 필터링하는 `matcher`를 초과합니다.

755 751 

756예를 들어 모든 Bash 명령이 아닌 `git` 명령을 사용할 때만 hook을 실행하려면:752예를 들어 모든 Bash 명령이 아닌 `git` 명령을 사용할 때만 hook을 실행하려면:

178 178 

179**모든 파일 편집은 되돌릴 수 있습니다.** Claude가 파일을 편집하기 전에 현재 콘텐츠를 스냅샷합니다. 문제가 발생하면 `Esc`를 두 번 눌러 이전 상태로 되돌리거나 Claude에게 취소하도록 요청하세요.179**모든 파일 편집은 되돌릴 수 있습니다.** Claude가 파일을 편집하기 전에 현재 콘텐츠를 스냅샷합니다. 문제가 발생하면 `Esc`를 두 번 눌러 이전 상태로 되돌리거나 Claude에게 취소하도록 요청하세요.

180 180 

181체크포인트는 세션에 로컬이며 git과 분리되어 있습니다. 파일 변경만 다룹니다. 원격 시스템(데이터베이스, API, 배포)에 영향을 주는 작업은 체크포인트할 수 없으므로 Claude는 외부 부작용이 있는 명령을 실행하기 전에 요청합니다.181체크포인트는 git과 분리되어 있으며 대화를 재개할 때 계속 사용할 수 있습니다. 파일 변경만 다룹니다. 원격 시스템(데이터베이스, API, 배포)에 영향을 주는 작업은 체크포인트할 수 없으므로 Claude는 외부 부작용이 있는 명령을 실행하기 전에 요청합니다.

182 182 

183<h3 id="control-what-claude-can-do">183<h3 id="control-what-claude-can-do">

184 Claude가 할 수 있는 것 제어184 Claude가 할 수 있는 것 제어

188 188 

189* **기본값**: Claude는 파일 편집 및 셸 명령 전에 요청합니다189* **기본값**: Claude는 파일 편집 및 셸 명령 전에 요청합니다

190* **자동 수락 편집**: Claude는 파일을 편집하고 `mkdir` 및 `mv`와 같은 일반적인 파일시스템 명령을 요청 없이 실행하지만 다른 명령은 여전히 요청합니다190* **자동 수락 편집**: Claude는 파일을 편집하고 `mkdir` 및 `mv`와 같은 일반적인 파일시스템 명령을 요청 없이 실행하지만 다른 명령은 여전히 요청합니다

191* **계획 모드**: Claude는 소스 파일을 편집하지 않고 계획을 탐색하고 제안합니다. 기본 모드처럼 권한 프롬프트가 여전히 적용됩니다191* **Plan**: Claude는 소스 파일을 편집하지 않고 계획을 탐색하고 제안합니다

192* **Auto**: Claude는 백그라운드 안전 검사로 모든 작업을 평가합니다192* **Auto**: Claude는 백그라운드 안전 검사로 모든 작업을 평가합니다

193 193 

194`.claude/settings.json`에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 `npm test` 또는 `git status`와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 [권한](/ko/permissions)을 참조하세요.194`.claude/settings.json`에서 특정 명령을 허용하여 Claude가 매번 요청하지 않도록 할 수 있습니다. 이는 `npm test` 또는 `git status`와 같은 신뢰할 수 있는 명령에 유용합니다. 설정은 조직 전체 정책에서 개인 선호도까지 범위를 지정할 수 있습니다. 자세한 내용은 [권한](/ko/permissions)을 참조하세요.

6 6 

7> keybindings 구성 파일을 사용하여 Claude Code에서 키보드 단축키를 사용자 정의합니다.7> keybindings 구성 파일을 사용하여 Claude Code에서 키보드 단축키를 사용자 정의합니다.

8 8 

9<Note>

10 사용자 정의 가능한 키보드 단축키는 Claude Code v2.1.18 이상이 필요합니다. `claude --version`으로 버전을 확인하세요.

11</Note>

12 

13Claude Code는 사용자 정의 가능한 키보드 단축키를 지원합니다. `/keybindings`를 실행하여 `~/.claude/keybindings.json`에서 구성 파일을 만들거나 열 수 있습니다.9Claude Code는 사용자 정의 가능한 키보드 단축키를 지원합니다. `/keybindings`를 실행하여 `~/.claude/keybindings.json`에서 구성 파일을 만들거나 열 수 있습니다.

14 10 

15<h2 id="configuration-file">11<h2 id="configuration-file">

722}722}

723```723```

724 724 

725URL은 `https://`를 사용해야 합니다. `authServerMetadataUrl`은 Claude Code v2.1.64 이상이 필요합니다. 메타데이터 URL의 `scopes_supported`는 업스트림 서버가 광고하는 범위를 재정의합니다.725URL은 `https://`를 사용해야 합니다. 메타데이터 URL의 `scopes_supported`는 업스트림 서버가 광고하는 범위를 재정의합니다.

726 726 

727<h3 id="restrict-oauth-scopes">727<h3 id="restrict-oauth-scopes">

728 OAuth 범위 제한728 OAuth 범위 제한

365 365 

366자동 메모리를 통해 Claude는 아무것도 작성하지 않고도 세션 간에 지식을 축적할 수 있습니다. Claude는 작업할 때 자신을 위해 노트를 저장합니다: 빌드 명령, 디버깅 인사이트, 아키텍처 노트, 코드 스타일 선호도 및 워크플로우 습관. Claude는 모든 세션마다 뭔가를 저장하지 않습니다. 정보가 향후 대화에서 유용할지 여부에 따라 기억할 가치가 있는지 결정합니다.366자동 메모리를 통해 Claude는 아무것도 작성하지 않고도 세션 간에 지식을 축적할 수 있습니다. Claude는 작업할 때 자신을 위해 노트를 저장합니다: 빌드 명령, 디버깅 인사이트, 아키텍처 노트, 코드 스타일 선호도 및 워크플로우 습관. Claude는 모든 세션마다 뭔가를 저장하지 않습니다. 정보가 향후 대화에서 유용할지 여부에 따라 기억할 가치가 있는지 결정합니다.

367 367 

368<Note>

369 자동 메모리는 Claude Code v2.1.59 이상이 필요합니다. `claude --version`으로 버전을 확인합니다.

370</Note>

371 

372<h3 id="enable-or-disable-auto-memory">368<h3 id="enable-or-disable-auto-memory">

373 자동 메모리 활성화 또는 비활성화369 자동 메모리 활성화 또는 비활성화

374</h3>370</h3>

132 계획 모드로 편집 전에 분석132 계획 모드로 편집 전에 분석

133</h2>133</h2>

134 134 

135계획 모드는 Claude에게 변경 사항을 연구하고 제안하도록 지시하지만 변경하지는 않습니다. Claude는 파일을 읽고, 셸 명령을 실행하여 탐색하고, 계획을 작성하지만 소스를 편집하지는 않습니다. 권한 프롬프트는 기본 모드와 동일하게 적용됩니다.135계획 모드는 Claude에게 변경 사항을 연구하고 제안하도록 지시하지만 변경하지는 않습니다. Claude는 파일을 읽고, 셸 명령을 실행하여 탐색하고, 계획을 작성하지만 소스를 편집하지는 않습니다. 권한 프롬프트는 수동 모드와 동일하게 적용됩니다. [자동 모드](/ko/auto-mode-config)를 사용할 수 있고 `useAutoModeDuringPlan`이 기본값인 켜져 있는 경우는 예외입니다. 자동 모드가 활성화되면, 분류기는 검색 및 파일 읽기와 같은 읽기 전용 명령을 프롬프트 없이 승인합니다. 어느 쪽이든 편집은 계획을 승인할 때까지 차단된 상태로 유지됩니다.

136 136 

137`Shift+Tab`을 눌러 계획 모드에 들어가거나 단일 프롬프트 앞에 `/plan`을 붙입니다. CLI에서 계획 모드로 시작할 수도 있습니다:137`Shift+Tab`을 눌러 계획 모드에 들어가거나 단일 프롬프트 앞에 `/plan`을 붙입니다. CLI에서 계획 모드로 시작할 수도 있습니다:

138 138 

178 자동 모드로 권한 프롬프트 제거178 자동 모드로 권한 프롬프트 제거

179</h2>179</h2>

180 180 

181<Note>

182 자동 모드는 Claude Code v2.1.83 이상이 필요합니다.

183</Note>

184 

185자동 모드는 Claude가 일상적인 권한 프롬프트 없이 실행되도록 합니다. 별도의 분류기 모델이 실행 전에 작업을 검토하여, 요청을 초과하여 확대되거나, 인식되지 않은 인프라를 대상으로 하거나, Claude가 읽은 적대적 콘텐츠에 의해 주도되는 것으로 보이는 모든 것을 차단합니다. 명시적 [요청 규칙](/ko/permissions#manage-permissions)은 여전히 프롬프트를 강제합니다.181자동 모드는 Claude가 일상적인 권한 프롬프트 없이 실행되도록 합니다. 별도의 분류기 모델이 실행 전에 작업을 검토하여, 요청을 초과하여 확대되거나, 인식되지 않은 인프라를 대상으로 하거나, Claude가 읽은 적대적 콘텐츠에 의해 주도되는 것으로 보이는 모든 것을 차단합니다. 명시적 [요청 규칙](/ko/permissions#manage-permissions)은 여전히 프롬프트를 강제합니다.

186 182 

187자동 모드는 또한 Claude에게 명확히 하는 질문을 위해 멈추지 않고 계속 작업하도록 권장합니다. 그러나 Claude는 프롬프트나 스킬이 명시적으로 이를 필요로 할 때는 여전히 질문합니다. 권한 프롬프트를 유지하면서 더 강력한 자율적 동작을 원하면 [사전 예방적 출력 스타일](/ko/output-styles)을 대신 설정합니다.183자동 모드는 또한 Claude에게 명확히 하는 질문을 위해 멈추지 않고 계속 작업하도록 권장합니다. 그러나 Claude는 프롬프트나 스킬이 명시적으로 이를 필요로 할 때는 여전히 질문합니다. 권한 프롬프트를 유지하면서 더 강력한 자율적 동작을 원하면 [사전 예방적 출력 스타일](/ko/output-styles)을 대신 설정합니다.

575 575 

576Claude Code는 개인 저장소에서 플러그인 설치를 지원합니다. 수동 설치 및 업데이트의 경우 Claude Code는 기존 git 자격 증명 도우미를 사용합니다. 따라서 HTTPS 액세스는 `gh auth login`, macOS Keychain 또는 `git-credential-store`를 통해 터미널에서와 동일하게 작동합니다. SSH 액세스는 호스트가 이미 `known_hosts` 파일에 있고 키가 `ssh-agent`에 로드되어 있는 한 작동합니다. Claude Code는 호스트 지문 및 키 암호에 대한 대화형 SSH 프롬프트를 억제하기 때문입니다.576Claude Code는 개인 저장소에서 플러그인 설치를 지원합니다. 수동 설치 및 업데이트의 경우 Claude Code는 기존 git 자격 증명 도우미를 사용합니다. 따라서 HTTPS 액세스는 `gh auth login`, macOS Keychain 또는 `git-credential-store`를 통해 터미널에서와 동일하게 작동합니다. SSH 액세스는 호스트가 이미 `known_hosts` 파일에 있고 키가 `ssh-agent`에 로드되어 있는 한 작동합니다. Claude Code는 호스트 지문 및 키 암호에 대한 대화형 SSH 프롬프트를 억제하기 때문입니다.

577 577 

578백그라운드 자동 업데이트는 대화형 프롬프트가 Claude Code 시작을 차단하므로 자격 증명 도우미 없이 시작 시 실행됩니다. 개인 마켓플레이스에 대한 자동 업데이트를 활성화하려면 환경에서 적절한 인증 토큰을 설정합니다:578백그라운드 자동 업데이트는 다르게 작동합니다. 기본적으로 백그라운드 새로고침은 `git pull`에 대해 git 자격 증명 도우미를 비활성화하므로 도우미가 구성되어 있어도 HTTPS를 통해 개인 저장소에 인증할 수 없습니다. SSH 원격은 영향을 받지 않습니다. `ssh-agent`에 로드된 키는 수동 작업과 동일한 방식으로 백그라운드 풀을 인증합니다. 백그라운드 풀이 실패하면 Claude Code는 마켓플레이스를 처음부터 다시 복제하는 것으로 폴백합니다. 다시 복제는 저장된 git 자격 증명을 사용하지만 [대규모 저장소에서 시간 초과](#git-operations-time-out)될 수 있으므로 개인 마켓플레이스 자동 업데이트가 간헐적으로 실패할 수 있습니다.

579 579 

580| 공급자 | 환경 변수 | 참고 |580두 가지 설정이 개인 마켓플레이스를 예측 가능하게 작동하게 합니다:

581| :-------- | :--------------------------- | :------------------------- |

582| GitHub | `GITHUB_TOKEN` 또는 `GH_TOKEN` | 개인 액세스 토큰 또는 GitHub App 토큰 |

583| GitLab | `GITLAB_TOKEN` 또는 `GL_TOKEN` | 개인 액세스 토큰 또는 프로젝트 토큰 |

584| Bitbucket | `BITBUCKET_TOKEN` | 앱 비밀번호 또는 저장소 액세스 토큰 |

585 581 

586셸 구성(예: `.bashrc`, `.zshrc`)에서 토큰을 설정하거나 Claude Code를 실행할 때 전달합니다:582* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 백그라운드 풀이 실패할 때 기존 복제를 삭제하고 다시 복제하는 대신 유지합니다. 플러그인은 마지막 동기화된 상태에서 계속 작동하며 `/plugin marketplace update`를 사용한 수동 업데이트는 여전히 자격 증명으로 풀합니다.

583* git 자격 증명 도우미를 구성합니다. 예를 들어 GitHub의 경우 `gh auth setup-git`을 사용하여 다시 복제 폴백이 프롬프트 없이 인증할 수 있습니다.

584 

585`GITHUB_TOKEN`과 같은 공급자 토큰을 환경에서 설정하는 것만으로는 백그라운드 인증을 활성화하지 않습니다. 토큰은 구성된 자격 증명 도우미(예: `GH_TOKEN` 및 `GITHUB_TOKEN`을 읽는 `gh` CLI의 도우미)를 통해서만 적용됩니다.

586 

587백그라운드 풀 자체가 HTTPS를 통해 인증하도록 하려면 전역 git URL 다시 쓰기를 구성합니다. 다시 쓰기는 원격 URL에 토큰을 포함하므로 백그라운드 풀이 자격 증명 도우미를 비활성화하더라도 적용되며 성공적인 풀은 다시 복제 폴백을 건너뜁니다. 다음 예제는 마켓플레이스 저장소의 URL을 다시 쓰어 액세스 토큰을 포함합니다:

587 588 

588```bash theme={null}589```bash theme={null}

589export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx590git config --global url."https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins".insteadOf "https://github.com/acme-corp/plugins"

590```591```

591 592 

593다시 쓰기를 마켓플레이스 저장소 또는 조직 경로로 범위를 지정합니다. 기본이 호스트만인 다시 쓰기는 해당 호스트에 대한 모든 가져오기 및 푸시에 적용되며 자신의 저장소에 대한 푸시를 포함한 일반 자격 증명을 재정의합니다.

594 

595각 공급자는 다시 쓴 URL에서 다른 사용자 이름을 예상하며 동일한 경로 범위 지정이 모든 공급자에 적용됩니다. 자체 호스팅 서버의 경우 호스트 이름을 서버의 호스트 이름으로 바꿉니다:

596 

597| 공급자 | 다시 쓴 URL 형식 |

598| :-------- | :---------------------------------------------------------------- |

599| GitHub | `https://x-access-token:YOUR_TOKEN@github.com/acme-corp/plugins` |

600| GitLab | `https://oauth2:YOUR_TOKEN@gitlab.com/acme-corp/plugins` |

601| Bitbucket | `https://x-token-auth:YOUR_TOKEN@bitbucket.org/acme-corp/plugins` |

602 

603다시 쓰기는 gitconfig에 평문으로 토큰을 저장하므로 마켓플레이스 저장소에 대한 읽기 전용 액세스 권한이 있는 토큰을 사용합니다.

604 

592<Note>605<Note>

593 CI/CD 환경의 경우 토큰을 비밀 환경 변수로 구성합니다. GitHub Actions는 동일한 조직의 저장소에 대해 자동으로 `GITHUB_TOKEN`을 제공합니다.606 CI/CD 환경에서는 개인 저장소에서 플러그인을 설치하기 전에 git 자격 증명 도우미를 구성합니다. GitHub Actions에서 마켓플레이스 저장소에 대한 읽기 액세스 권한이 있는 토큰을 `GH_TOKEN`으로 내보낸 다음 `gh auth setup-git`을 실행합니다. 기본 워크플로우 토큰은 워크플로우 자신의 저장소에만 액세스할 수 있으므로 다른 저장소의 개인 마켓플레이스는 개인 액세스 토큰 또는 앱 토큰이 필요합니다. 파이프라인에서 구성된 전역 URL 다시 쓰기도 백그라운드 풀을 직접 인증합니다.

594</Note>607</Note>

595 608 

596<h3 id="test-locally-before-distribution">609<h3 id="test-locally-before-distribution">

1162 1175 

1163백그라운드 자동 업데이트의 경우:1176백그라운드 자동 업데이트의 경우:

1164 1177 

1165* 환경에서 적절한 토큰이 설정되었는지 확인합니다: `echo $GITHUB_TOKEN`1178* 기본적으로 백그라운드 새로 고침은 pull에 대해 git 자격 증명 도우미를 비활성화하므로 pull이 HTTPS를 통해 인증할 수 없습니다. `ssh-agent`에 로드된 키가 있는 SSH 원격은 여전히 인증합니다. 실패한 pull은 저장된 자격 증명을 사용하지만 대규모 저장소에서 시간 초과될 수 있는 처음부터 다시 복제를 트리거합니다

1166* 토큰에 필수 권한이 있는지 확인합니다(저장소에 대한 읽기 액세스)1179* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 백그라운드 pull이 실패할 때 기존 복제본을 유지합니다

1167* GitHub의 경우 토큰에 개인 저장소에 대한 `repo` 범위가 있는지 확인합니다1180* git 자격 증명 도우미(예: `gh auth setup-git`)를 구성하여 다시 복제 폴백이 인증할 수 있도록 합니다

1168* GitLab의 경우 토큰에 최소한 `read_repository` 범위가 있는지 확인합니다1181* 대규모 저장소에서 다시 복제 시간이 초과되면 [`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)를 사용하여 제한을 늘립니다

1169* 토큰이 만료되지 않았는지 확인합니다1182* 백그라운드 pull이 직접 인증하도록 마켓플레이스 저장소로 범위가 지정된 [git URL 재작성](#private-repositories)을 구성합니다

1183* 또는 자격 증명을 사용하는 `/plugin marketplace update <name>`으로 개인 마켓플레이스를 수동으로 업데이트합니다

1170 1184 

1171<h3 id="marketplace-updates-fail-in-offline-environments">1185<h3 id="marketplace-updates-fail-in-offline-environments">

1172 마켓플레이스 업데이트가 오프라인 환경에서 실패합니다1186 마켓플레이스 업데이트가 오프라인 환경에서 실패합니다

1173</h3>1187</h3>

1174 1188 

1175**증상**: 마켓플레이스 `git pull`이 실패하고 Claude Code가 기존 캐시를 삭제하여 플러그인을 사용할 수 없게 됩니다.1189**증상**: 마켓플레이스 `git pull`이 백그라운드에서 실패하고 Claude Code가 성공할 수 없는 다시 복제를 반복적으로 시도합니다.

1176 1190 

1177**원인**: 기본적으로 `git pull`이 실패하면 Claude Code는 오래된 복제본을 제거하고 다시 복제를 시도합니다. 오프라인 또는 에어갭 환경에서 다시 복제가 동일한 방식으로 실패하여 마켓플레이스 디렉터리가 비어 있게 됩니다.1191**원인**: 기본적으로 `git pull`이 실패하면 Claude Code는 처음부터 다시 복제를 시도합니다. 오프라인 또는 에어갭 환경에서 다시 복제가 동일한 방식으로 실패하고 그 후 이전 캐시의 복원은 최선의 노력입니다. 새로 고침은 시작 후 백그라운드에서 실행되므로 시작을 지연시키지 않지만 각 세션은 실패한 시도를 반복하고 각 git 작업은 [120초 시간 초과](#git-operations-time-out)를 기다릴 수 있습니다.

1178 1192 

1179**해결책**: `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 pull이 실패할 때 기존 캐시를 삭제하는 대신 유지합니다:1193**해결책**: `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`을 설정하여 pull이 실패할 때 다시 복제 시도를 건너뛰고 기존 캐시를 계속 사용합니다:

1180 1194 

1181```bash theme={null}1195```bash theme={null}

1182export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=11196export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

520| 공유하려면 수동으로 복사해야 함 | `/plugin install`로 설치 |520| 공유하려면 수동으로 복사해야 함 | `/plugin install`로 설치 |

521 521 

522<Note>522<Note>

523 마이그레이션 후 중복을 피하기 위해 `.claude/`에서 원본 파일을 제거합니다. 프로젝트 및 사용자 `.claude/agents/` 정의는 같은 이름의 플러그인 agents를 재정의하므로, 원본이 제거되면 플러그인 버전만 적용됩니다.523 마이그레이션 후 중복을 피하기 위해 `.claude/`에서 원본 파일을 제거합니다. 프로젝트 및 사용자 `.claude/agents/` 정의는 같은 이름의 플러그인 agents를 재정의하므로, 원본이 제거되면 플러그인 버전만 적용됩니다. 플러그인 skills는 `/plugin-name:skill-name`으로 네임스페이스되므로, 원본 `/skill-name`과 플러그인 복사본이 모두 사용 가능하게 유지되며 하나가 다른 하나를 재정의하지 않습니다.

524</Note>524</Note>

525 525 

526<h2 id="next-steps">526<h2 id="next-steps">

95 95 

96비용은 대화당 한 번 적용됩니다. 첫 번째 빠른 모드 턴 후 Claude Code는 계속 헤더를 보내고 캐시 키의 일부가 아닌 요청의 속도 설정만 변경합니다. 빠른 모드를 끄기, [속도 제한 후 표준 속도로 자동 폴백](/ko/fast-mode#handle-rate-limits), 나중에 다시 켜기는 모두 캐시를 유지합니다. `/clear`와 `/compact`는 어차피 그 지점에서 캐시를 다시 구축하므로 이를 재설정합니다.96비용은 대화당 한 번 적용됩니다. 첫 번째 빠른 모드 턴 후 Claude Code는 계속 헤더를 보내고 캐시 키의 일부가 아닌 요청의 속도 설정만 변경합니다. 빠른 모드를 끄기, [속도 제한 후 표준 속도로 자동 폴백](/ko/fast-mode#handle-rate-limits), 나중에 다시 켜기는 모두 캐시를 유지합니다. `/clear`와 `/compact`는 어차피 그 지점에서 캐시를 다시 구축하므로 이를 재설정합니다.

97 97 

98<Note>

99 토글 간에 헤더를 유지하려면 Claude Code v2.1.86 이상이 필요합니다. 이전 버전에서는 모든 빠른 모드 토글과 속도 제한 폴백이 캐시를 무효화합니다.

100</Note>

101 

102<h3 id="connecting-or-disconnecting-an-mcp-server">98<h3 id="connecting-or-disconnecting-an-mcp-server">

103 MCP 서버 연결 또는 연결 해제99 MCP 서버 연결 또는 연결 해제

104</h3>100</h3>

21 21 

22클라우드 인프라에서 실행되는 [웹의 Claude Code](/ko/claude-code-on-the-web)와 달리 Remote Control 세션은 컴퓨터에서 직접 실행되며 로컬 파일 시스템과 상호 작용합니다. 웹 및 모바일 인터페이스는 단지 해당 로컬 세션의 창일 뿐입니다.22클라우드 인프라에서 실행되는 [웹의 Claude Code](/ko/claude-code-on-the-web)와 달리 Remote Control 세션은 컴퓨터에서 직접 실행되며 로컬 파일 시스템과 상호 작용합니다. 웹 및 모바일 인터페이스는 단지 해당 로컬 세션의 창일 뿐입니다.

23 23 

24<Note>

25 Remote Control에는 Claude Code v2.1.51 이상이 필요합니다. `claude --version`으로 버전을 확인하세요.

26</Note>

27 

28이 페이지에서는 설정, 세션을 시작하고 연결하는 방법, Remote Control과 웹의 Claude Code를 비교하는 방법을 다룹니다.24이 페이지에서는 설정, 세션을 시작하고 연결하는 방법, Remote Control과 웹의 Claude Code를 비교하는 방법을 다룹니다.

29 25 

30<h2 id="requirements">26<h2 id="requirements">

104 </Tab>100 </Tab>

105 101 

106 <Tab title="VS Code">102 <Tab title="VS Code">

107 [Claude Code VS Code 확장](/ko/vs-code)에서 프롬프트 상자에 `/remote-control` 또는 `/rc`를 입력하거나 `/`로 명령 메뉴를 열고 선택하세요. Claude Code v2.1.79 이상이 필요합니다.103 [Claude Code VS Code 확장](/ko/vs-code)에서 프롬프트 상자에 `/remote-control` 또는 `/rc`를 입력하거나 `/`로 명령 메뉴를 열고 선택하세요.

108 104 

109 ```text theme={null}105 ```text theme={null}

110 /remote-control106 /remote-control

419* Console API 키 또는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry와 같은 클라우드 공급자로 인증되어 있습니다. `/schedule`은 claude.ai 구독 로그인이 필요합니다. 셸에서 `ANTHROPIC_API_KEY` 또는 `ANTHROPIC_AUTH_TOKEN`이 설정되어 있거나 `settings.json`에서 `apiKeyHelper`가 설정되어 있으면 먼저 제거하세요. 이들이 claude.ai 로그인보다 우선하기 때문입니다.419* Console API 키 또는 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry와 같은 클라우드 공급자로 인증되어 있습니다. `/schedule`은 claude.ai 구독 로그인이 필요합니다. 셸에서 `ANTHROPIC_API_KEY` 또는 `ANTHROPIC_AUTH_TOKEN`이 설정되어 있거나 `settings.json`에서 `apiKeyHelper`가 설정되어 있으면 먼저 제거하세요. 이들이 claude.ai 로그인보다 우선하기 때문입니다.

420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 `DISABLE_GROWTHBOOK`이 셸 환경 또는 [`settings.json` 파일](/ko/settings#available-settings)의 `env` 블록에 설정되어 있습니다. 이들은 `/schedule`이 의존하는 기능 플래그 가져오기를 비활성화합니다.420* `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 또는 `DISABLE_GROWTHBOOK`이 셸 환경 또는 [`settings.json` 파일](/ko/settings#available-settings)의 `env` 블록에 설정되어 있습니다. 이들은 `/schedule`이 의존하는 기능 플래그 가져오기를 비활성화합니다.

421* Claude Code 웹 세션 내부에 있습니다. 대신 [웹 UI](https://claude.ai/code/routines)에서 루틴을 관리하세요.421* Claude Code 웹 세션 내부에 있습니다. 대신 [웹 UI](https://claude.ai/code/routines)에서 루틴을 관리하세요.

422* {/* min-version: 2.1.81 */}CLI가 v2.1.81보다 오래되었습니다. `claude update`를 실행하세요.

423 422 

424CLI가 어떻게 구성되어 있든 관계없이 [claude.ai/code/routines](https://claude.ai/code/routines)에서 언제든지 루틴을 생성하고 관리할 수 있습니다.423CLI가 어떻게 구성되어 있든 관계없이 [claude.ai/code/routines](https://claude.ai/code/routines)에서 언제든지 루틴을 생성하고 관리할 수 있습니다.

425 424 

136 136 

137세션 임시 디렉토리는 기본적으로 작업 디렉토리와 함께 샌드박스 내에서 쓰기 가능합니다. Claude Code는 샌드박싱된 명령에 대해 `$TMPDIR`을 이 디렉토리로 설정하므로 임시 파일을 작성하는 도구는 추가 구성 없이 작동합니다. 샌드박싱되지 않은 명령은 셸의 `$TMPDIR`을 변경되지 않은 상태로 상속하므로, 샌드박싱된 명령과 샌드박싱되지 않은 명령은 `$TMPDIR`을 다른 디렉토리로 해석합니다. 두 명령 간에 임시 파일을 전달하려면 작업 디렉토리 아래에 작성하세요.137세션 임시 디렉토리는 기본적으로 작업 디렉토리와 함께 샌드박스 내에서 쓰기 가능합니다. Claude Code는 샌드박싱된 명령에 대해 `$TMPDIR`을 이 디렉토리로 설정하므로 임시 파일을 작성하는 도구는 추가 구성 없이 작동합니다. 샌드박싱되지 않은 명령은 셸의 `$TMPDIR`을 변경되지 않은 상태로 상속하므로, 샌드박싱된 명령과 샌드박싱되지 않은 명령은 `$TMPDIR`을 다른 디렉토리로 해석합니다. 두 명령 간에 임시 파일을 전달하려면 작업 디렉토리 아래에 작성하세요.

138 138 

139일부 명령은 샌드박스 내에서 전혀 실행할 수 없습니다. 예를 들어 호환되지 않는 도구나 허용하지 않은 호스트가 필요한 도구입니다. 작업을 실패하거나 샌드박싱을 끄도록 요구하는 대신 Claude Code는 탈출 해치를 포함합니다: 명령이 샌드박스 제한으로 인해 실패하면 Claude는 실패를 분석하고 `dangerouslyDisableSandbox` 매개변수로 명령을 다시 시도할 수 있습니다. 다시 시도된 명령은 샌드박스 외부에서 실행되므로 일반 권한 흐름을 거치고 승인이 필요합니다.139일부 명령은 샌드박스 내에서 전혀 실행할 수 없습니다. 예를 들어 호환되지 않는 도구나 허용하지 않은 호스트가 필요한 도구입니다. 작업을 실패하거나 샌드박싱을 끄도록 요구하는 대신 Claude Code는 탈출 해치를 포함합니다: 명령이 샌드박스 제한으로 인해 실패하면 Claude는 실패를 분석하고 `dangerouslyDisableSandbox` 매개변수로 명령을 다시 시도할 수 있습니다. 다시 시도된 명령은 샌드박스 외부에서 실행되므로 일반 권한 흐름을 거칩니다. [자동 모드](/ko/permission-modes#eliminate-prompts-with-auto-mode)에서 분류기는 사용자에게 프롬프트하는 대신 기본 명령을 평가합니다.

140 140 

141[샌드박스 설정](/ko/settings#sandbox-settings)에서 `"allowUnsandboxedCommands": false`를 설정하여 이 탈출 해치를 비활성화할 수 있습니다. 비활성화되면 `/sandbox` Overrides 탭에 **Strict sandbox mode**로 표시되며, `dangerouslyDisableSandbox` 매개변수는 완전히 무시되고 모든 명령은 샌드박싱되거나 `excludedCommands`에 명시적으로 나열되어야 합니다.141[샌드박스 설정](/ko/settings#sandbox-settings)에서 `"allowUnsandboxedCommands": false`를 설정하여 이 탈출 해치를 비활성화할 수 있습니다. 비활성화되면 `/sandbox` Overrides 탭에 **Strict sandbox mode**로 표시되며, `dangerouslyDisableSandbox` 매개변수는 완전히 무시되고 모든 명령은 샌드박싱되거나 `excludedCommands`에 명시적으로 나열되어야 합니다.

142 142 

6 6 

7> /loop와 cron 스케줄링 도구를 사용하여 Claude Code 세션 내에서 프롬프트를 반복 실행하거나, 상태를 폴링하거나, 일회성 알림을 설정합니다.7> /loop와 cron 스케줄링 도구를 사용하여 Claude Code 세션 내에서 프롬프트를 반복 실행하거나, 상태를 폴링하거나, 일회성 알림을 설정합니다.

8 8 

9<Note>

10 스케줄된 작업을 사용하려면 Claude Code v2.1.72 이상이 필요합니다. `claude --version`으로 버전을 확인하세요.

11</Note>

12 

13스케줄된 작업을 사용하면 Claude가 일정한 간격으로 프롬프트를 자동으로 다시 실행할 수 있습니다. 배포를 폴링하거나, PR을 감시하거나, 오래 실행되는 빌드를 확인하거나, 나중에 세션에서 무언가를 하도록 자신에게 알림을 설정하는 데 사용합니다. 이벤트가 발생할 때 폴링하는 대신 반응하려면 [Channels](/ko/channels)를 참조하세요. CI가 실패를 세션에 직접 푸시할 수 있습니다. 세션이 조건이 충족될 때까지 한 번에 한 번씩 계속 작동하도록 하려면 일정한 간격이 아닌 경우 [`/goal`](/ko/goal)을 참조하세요.9스케줄된 작업을 사용하면 Claude가 일정한 간격으로 프롬프트를 자동으로 다시 실행할 수 있습니다. 배포를 폴링하거나, PR을 감시하거나, 오래 실행되는 빌드를 확인하거나, 나중에 세션에서 무언가를 하도록 자신에게 알림을 설정하는 데 사용합니다. 이벤트가 발생할 때 폴링하는 대신 반응하려면 [Channels](/ko/channels)를 참조하세요. CI가 실패를 세션에 직접 푸시할 수 있습니다. 세션이 조건이 충족될 때까지 한 번에 한 번씩 계속 작동하도록 하려면 일정한 간격이 아닌 경우 [`/goal`](/ko/goal)을 참조하세요.

14 10 

15작업은 세션 범위입니다. 현재 대화에 존재하며 새로운 대화를 시작할 때 중지됩니다. `--resume` 또는 `--continue`로 재개하면 [만료](#seven-day-expiry)되지 않은 모든 작업이 복원됩니다. 지난 7일 이내에 생성된 반복 작업이거나 스케줄된 시간이 아직 지나지 않은 일회성 작업입니다. 세션과 독립적으로 지속되는 스케줄링의 경우 [Routines](/ko/routines)을 사용하여 Anthropic 관리 인프라에서 루틴을 생성하거나, [Desktop scheduled tasks](/ko/desktop-scheduled-tasks)를 설정하거나, [GitHub Actions](/ko/github-actions)를 사용하세요.11작업은 세션 범위입니다. 현재 대화에 존재하며 새로운 대화를 시작할 때 중지됩니다. `--resume` 또는 `--continue`로 재개하면 [만료](#seven-day-expiry)되지 않은 모든 작업이 복원됩니다. 지난 7일 이내에 생성된 반복 작업이거나 스케줄된 시간이 아직 지나지 않은 일회성 작업입니다. 세션과 독립적으로 지속되는 스케줄링의 경우 [Routines](/ko/routines)을 사용하여 Anthropic 관리 인프라에서 루틴을 생성하거나, [Desktop scheduled tasks](/ko/desktop-scheduled-tasks)를 설정하거나, [GitHub Actions](/ko/github-actions)를 사용하세요.

22 22 

23* Claude for Teams 또는 Claude for Enterprise 플랜23* Claude for Teams 또는 Claude for Enterprise 플랜

24* Claude 조직에서 구성을 보고 편집할 수 있는 Owner 또는 Primary Owner 역할24* Claude 조직에서 구성을 보고 편집할 수 있는 Owner 또는 Primary Owner 역할

25* Claude for Teams의 경우 Claude Code 버전 2.1.38 이상, Claude for Enterprise의 경우 버전 2.1.30 이상

26* `api.anthropic.com`에 대한 네트워크 액세스25* `api.anthropic.com`에 대한 네트워크 액세스

27 26 

28<h2 id="choose-between-server-managed-and-endpoint-managed-settings">27<h2 id="choose-between-server-managed-and-endpoint-managed-settings">

214 214 

215| 키 | 설명 | 예제 |215| 키 | 설명 | 예제 |

216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |

217| `advisorModel` | {/* min-version: 2.1.98 */}서버 측 [advisor 도구](/ko/advisor)를 위한 모델입니다. `"opus"`, `"sonnet"` 또는 `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+)과 같은 모델 별칭 또는 전체 모델 ID를 허용합니다. `/advisor`를 실행할 때 자동으로 작성됩니다. Advisor를 비활성화하려면 설정 해제합니다. Claude Code v2.1.98 이상이 필요합니다 | `"opus"` |217| `advisorModel` | 서버 측 [advisor 도구](/ko/advisor)를 위한 모델입니다. `"opus"`, `"sonnet"` 또는 `"fable"` ({/* min-version: 2.1.170 */}v2.1.170+)과 같은 모델 별칭 또는 전체 모델 ID를 허용합니다. `/advisor`를 실행할 때 자동으로 작성됩니다. Advisor를 비활성화하려면 설정 해제합니다 | `"opus"` |

218| `agent` | 메인 스레드를 명명된 subagent로 실행하고 `claude agents`에서 디스패치된 세션의 기본 에이전트를 설정합니다. 해당 subagent의 시스템 프롬프트, 도구 제한 및 모델을 적용합니다. [subagents 명시적으로 호출](/ko/sub-agents#invoke-subagents-explicitly)을 참조하세요 | `"code-reviewer"` |218| `agent` | 메인 스레드를 명명된 subagent로 실행하고 `claude agents`에서 디스패치된 세션의 기본 에이전트를 설정합니다. 해당 subagent의 시스템 프롬프트, 도구 제한 및 모델을 적용합니다. [subagents 명시적으로 호출](/ko/sub-agents#invoke-subagents-explicitly)을 참조하세요 | `"code-reviewer"` |

219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**기본값**: `false`. [Remote Control](/ko/remote-control)이 연결되어 있을 때 Claude가 장시간 작업이 완료될 때와 같이 휴대폰에 사전 예방적 푸시 알림을 보낼 수 있도록 허용합니다. `/config`에 **Claude가 결정할 때 푸시**로 표시됩니다. [모바일 푸시 알림](/ko/remote-control#mobile-push-notifications)을 참조하세요. Claude Code v2.1.119 이상이 필요합니다 | `true` |219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**기본값**: `false`. [Remote Control](/ko/remote-control)이 연결되어 있을 때 Claude가 장시간 작업이 완료될 때와 같이 휴대폰에 사전 예방적 푸시 알림을 보낼 수 있도록 허용합니다. `/config`에 **Claude가 결정할 때 푸시**로 표시됩니다. [모바일 푸시 알림](/ko/remote-control#mobile-push-notifications)을 참조하세요. Claude Code v2.1.119 이상이 필요합니다 | `true` |

220| `allowAllClaudeAiMcps` | (Managed 설정만) 배포된 `managed-mcp.json`과 함께 claude.ai 커넥터를 로드합니다. 그렇지 않으면 독점적 제어를 취하고 이를 억제합니다. [Managed MCP 구성](/ko/managed-mcp)을 참조하세요 | `true` |220| `allowAllClaudeAiMcps` | (Managed 설정만) 배포된 `managed-mcp.json`과 함께 claude.ai 커넥터를 로드합니다. 그렇지 않으면 독점적 제어를 취하고 이를 억제합니다. [Managed MCP 구성](/ko/managed-mcp)을 참조하세요 | `true` |

424| `network.allowMachLookup` | 샌드박스가 조회할 수 있는 추가 XPC/Mach 서비스 이름 (macOS만). 접두사 일치를 위해 단일 후행 `*`를 지원합니다. iOS Simulator 또는 Playwright와 같이 XPC를 통해 통신하는 도구에 필요합니다. | `["com.apple.coresimulator.*"]` |424| `network.allowMachLookup` | 샌드박스가 조회할 수 있는 추가 XPC/Mach 서비스 이름 (macOS만). 접두사 일치를 위해 단일 후행 `*`를 지원합니다. iOS Simulator 또는 Playwright와 같이 XPC를 통해 통신하는 도구에 필요합니다. | `["com.apple.coresimulator.*"]` |

425| `network.allowedDomains` | 아웃바운드 네트워크 트래픽을 허용할 도메인 배열입니다. 와일드카드를 지원합니다 (예: `*.example.com`). | `["github.com", "*.npmjs.org"]` |425| `network.allowedDomains` | 아웃바운드 네트워크 트래픽을 허용할 도메인 배열입니다. 와일드카드를 지원합니다 (예: `*.example.com`). | `["github.com", "*.npmjs.org"]` |

426| `network.deniedDomains` | 아웃바운드 네트워크 트래픽을 차단할 도메인 배열입니다. `allowedDomains`와 동일한 와일드카드 구문을 지원합니다. 둘 다 일치할 때 `allowedDomains`보다 우선합니다. 모든 설정 소스와 관계없이 병합됩니다 | `["sensitive.cloud.example.com"]` |426| `network.deniedDomains` | 아웃바운드 네트워크 트래픽을 차단할 도메인 배열입니다. `allowedDomains`와 동일한 와일드카드 구문을 지원합니다. 둘 다 일치할 때 `allowedDomains`보다 우선합니다. 모든 설정 소스와 관계없이 병합됩니다 | `["sensitive.cloud.example.com"]` |

427| `network.allowManagedDomainsOnly` | (Managed 설정만) Managed 설정의 `allowedDomains` 및 `WebFetch(domain:...)` 허용 규칙만 존중됩니다. 사용자, 프로젝트 및 local 설정의 도메인은 무시됩니다. 허용되지 않은 도메인은 사용자에게 메시지를 표시하지 않고 자동으로 차단됩니다. 거부된 도메인은 여전히 모든 소스에서 존중됩니다. 기본값: false | `true` |427| `network.allowManagedDomainsOnly` | (Managed 설정만) Managed 설정의 `allow edDomains` 및 `WebFetch(domain:...)` 허용 규칙만 존중됩니다. 사용자, 프로젝트 및 local 설정의 도메인은 무시됩니다. 허용되지 않은 도메인은 사용자에게 메시지를 표시하지 않고 자동으로 차단됩니다. 거부된 도메인은 여전히 모든 소스에서 존중됩니다. 기본값: false | `true` |

428| `network.httpProxyPort` | 자신의 프록시를 가져오려는 경우 사용되는 HTTP 프록시 포트입니다. 지정되지 않으면 Claude가 자신의 프록시를 실행합니다. | `8080` |428| `network.httpProxyPort` | 자신의 프록시를 가져오려는 경우 사용되는 HTTP 프록시 포트입니다. 지정되지 않으면 Claude가 자신의 프록시를 실행합니다. | `8080` |

429| `network.socksProxyPort` | 자신의 프록시를 가져오려는 경우 사용되는 SOCKS5 프록시 포트입니다. 지정되지 않으면 Claude가 자신의 프록시를 실행합니다. | `8081` |429| `network.socksProxyPort` | 자신의 프록시를 가져오려는 경우 사용되는 SOCKS5 프록시 포트입니다. 지정되지 않으면 Claude가 자신의 프록시를 실행합니다. | `8081` |

430| `network.tlsTerminate` | {{/* min-version: 2.1.199 */}}실험적입니다. 샌드박스 프록시 내에서 TLS를 종료하여 HTTPS 요청의 내용을 읽을 수 있습니다. `mask` [자격 증명 대체](/ko/sandboxing#protect-credentials)에 필요합니다. 세션에 대한 임시 인증 기관을 생성하려면 `{}`로 설정하거나 자신의 것을 사용하려면 `caCertPath` 및 `caKeyPath`로 설정합니다. 사용자, managed 또는 CLI `--settings` 설정에서만 적용되며 `.claude/settings.json` 또는 `.claude/settings.local.json`에서는 적용되지 않습니다. Claude Code v2.1.199 이상이 필요합니다. {{/* min-version: 2.1.199 */}} | `{}` |430| `network.tlsTerminate` | {{/* min-version: 2.1.199 */}}실험적입니다. 샌드박스 프록시 내에서 TLS를 종료하여 HTTPS 요청의 내용을 읽을 수 있습니다. `mask` [자격 증명 대체](/ko/sandboxing#protect-credentials)에 필요합니다. 세션에 대한 임시 인증 기관을 생성하려면 `{}`로 설정하거나 자신의 것을 사용하려면 `caCertPath` 및 `caKeyPath`로 설정합니다. 사용자, managed 또는 CLI `--settings` 설정에서만 적용되며 `.claude/settings.json` 또는 `.claude/settings.local.json`에서는 적용되지 않습니다. Claude Code v2.1.199 이상이 필요합니다. {{/* min-version: 2.1.199 */}} | `{}` |

856* `hostPattern`: 마켓플레이스 호스트와 일치하는 정규식 패턴 (`hostPattern` 사용)856* `hostPattern`: 마켓플레이스 호스트와 일치하는 정규식 패턴 (`hostPattern` 사용)

857* `settings`: 별도의 호스팅 저장소 없이 settings.json에 직접 선언된 인라인 마켓플레이스 (`name` 및 `plugins` 사용)857* `settings`: 별도의 호스팅 저장소 없이 settings.json에 직접 선언된 인라인 마켓플레이스 (`name` 및 `plugins` 사용)

858 858 

859`git` 소스 유형은 자체 호스팅 GitLab 및 Bitbucket을 포함한 모든 git 호스팅 서비스에서 작동합니다. Claude Code는 해당 머신에서 `git clone`이 사용할 것과 동일한 인증으로 저장소를 복제합니다: 구성된 credential helpers, SSH 키 또는 호스트별 토큰 환경 변수. 설정 세부 정보는 [Private repositories](/ko/plugin-marketplaces#private-repositories)를 참조하세요.859`git` 소스 유형은 자체 호스팅 GitLab 및 Bitbucket을 포함한 모든 git 호스팅 서비스에서 작동합니다. Claude Code는 해당 머신에서 `git clone`이 사용할 것과 동일한 인증으로 저장소를 복제합니다: 구성된 credential helpers 또는 SSH 키. `GITHUB_TOKEN`과 같은 공급자 토큰은 이를 읽는 credential helper를 통해서만 적용됩니다. 설정 세부 정보는 [Private repositories](/ko/plugin-marketplaces#private-repositories)를 참조하세요.

860 860 

861`github` 및 `git` 소스의 경우 `source` 객체 내부 (`repo` 또는 `url`과 함께)에 `"skipLfs": true`를 설정하여 Claude Code가 마켓플레이스 저장소를 복제하거나 업데이트할 때 Git LFS 다운로드를 건너뜁니다. LFS 포인터 파일은 해당 콘텐츠를 다운로드하는 대신 포인터로 유지됩니다. 저장소에 플러그인 콘텐츠와 무관한 대용량 LFS 객체가 포함되어 있을 때 이를 사용합니다. {/* min-version: 2.1.153 */}Claude Code v2.1.153 이상이 필요합니다.861`github` 및 `git` 소스의 경우 `source` 객체 내부 (`repo` 또는 `url`과 함께)에 `"skipLfs": true`를 설정하여 Claude Code가 마켓플레이스 저장소를 복제하거나 업데이트할 때 Git LFS 다운로드를 건너뜁니다. LFS 포인터 파일은 해당 콘텐츠를 다운로드하는 대신 포인터로 유지됩니다. 저장소에 플러그인 콘텐츠와 무관한 대용량 LFS 객체가 포함되어 있을 때 이를 사용합니다. {/* min-version: 2.1.153 */}Claude Code v2.1.153 이상이 필요합니다.

862 862 

1143 1143 

1144**Managed 설정만**: skills, agents, hooks 및 MCP servers가 사용자 및 프로젝트 소스에서 로드되는 것을 차단하므로 플러그인 또는 managed 설정에서만 가져올 수 있습니다. `strictKnownMarketplaces`와 결합하여 전체 사용자 정의 공급 체인을 제어합니다: 마켓플레이스 허용 목록은 사용자가 설치할 수 있는 플러그인을 제어하고 이 설정은 플러그인 또는 managed 설정에서 오지 않는 모든 것을 차단합니다.1144**Managed 설정만**: skills, agents, hooks 및 MCP servers가 사용자 및 프로젝트 소스에서 로드되는 것을 차단하므로 플러그인 또는 managed 설정에서만 가져올 수 있습니다. `strictKnownMarketplaces`와 결합하여 전체 사용자 정의 공급 체인을 제어합니다: 마켓플레이스 허용 목록은 사용자가 설치할 수 있는 플러그인을 제어하고 이 설정은 플러그인 또는 managed 설정에서 오지 않는 모든 것을 차단합니다.

1145 1145 

1146<Note>

1147 `strictPluginOnlyCustomization`은 Claude Code v2.1.82 이상이 필요합니다. 이전 버전은 키를 무시하고 사용자 및 프로젝트 사용자 정의를 계속 로드하므로 클라이언트가 업데이트될 때까지 잠금이 적용되지 않습니다.

1148</Note>

1149 

1150값은 모든 4개 표면을 잠그려면 `true`이거나 잠글 표면을 명명하는 배열입니다:1146값은 모든 4개 표면을 잠그려면 `true`이거나 잠글 표면을 명명하는 배열입니다:

1151 1147 

1152```json theme={null}1148```json theme={null}

928[Claude resumes the subagent with full context from previous conversation]928[Claude resumes the subagent with full context from previous conversation]

929```929```

930 930 

931중단된 subagent가 `SendMessage`를 받으면 새로운 `Agent` 호출 없이 background에서 자동으로 재개됩니다.931중단된 subagent가 `SendMessage`를 받으면 새로운 `Agent` 호출 없이 background에서 자동으로 재개됩니다. `TaskStop` 도구로 Claude가 중단한 subagent도 마찬가지입니다.

932 

933{/* min-version: 2.1.191 */}v2.1.191부터 `/tasks`에서 `x`를 사용하거나 SDK `stop_task` 요청으로 직접 중단한 subagent는 자동으로 재개되지 않습니다. `SendMessage` 호출은 에이전트가 취소되었음을 알리는 거부를 반환합니다. subagent 패널의 해당 subagent 트랜스크립트에 입력하여 직접 재개하면 중지가 해제되어 나중에 `SendMessage` 호출이 다시 자동으로 재개할 수 있습니다.

932 934 

933재개는 동일한 ID 아래에서 에이전트의 새로운 실행을 시작하므로 이미 실패했거나 완료된 subagent는 작업 목록 및 Agent SDK의 작업 이벤트에서 다시 실행 중으로 표시됩니다. v2.1.205 이전에는 재개된 실행이 작동하는 동안 이전의 실패했거나 완료된 상태를 계속 표시했습니다.935재개는 동일한 ID 아래에서 에이전트의 새로운 실행을 시작하므로 이미 실패했거나 완료된 subagent는 작업 목록 및 Agent SDK의 작업 이벤트에서 다시 실행 중으로 표시됩니다. v2.1.205 이전에는 재개된 실행이 작동하는 동안 이전의 실패했거나 완료된 상태를 계속 표시했습니다.

934 936 

296 296 

297디스플레이가 깜박이거나 Claude가 작업 중일 때 스크롤 위치가 점프하면 [전체 화면 렌더링 모드](/ko/fullscreen)로 전환하세요. 터미널이 일반 스크롤백에 추가하는 대신 전체 화면 앱용으로 예약한 별도의 화면에 그려서 메모리 사용량을 평탄하게 유지하고 스크롤 및 선택을 위한 마우스 지원을 추가합니다. 이 모드에서는 터미널의 기본 스크롤백이 아닌 마우스 또는 PageUp으로 Claude Code 내에서 스크롤합니다. 검색 및 복사 방법은 [전체 화면 페이지](/ko/fullscreen#search-and-review-the-conversation)를 참조하세요.297디스플레이가 깜박이거나 Claude가 작업 중일 때 스크롤 위치가 점프하면 [전체 화면 렌더링 모드](/ko/fullscreen)로 전환하세요. 터미널이 일반 스크롤백에 추가하는 대신 전체 화면 앱용으로 예약한 별도의 화면에 그려서 메모리 사용량을 평탄하게 유지하고 스크롤 및 선택을 위한 마우스 지원을 추가합니다. 이 모드에서는 터미널의 기본 스크롤백이 아닌 마우스 또는 PageUp으로 Claude Code 내에서 스크롤합니다. 검색 및 복사 방법은 [전체 화면 페이지](/ko/fullscreen#search-and-review-the-conversation)를 참조하세요.

298 298 

299현재 세션에서 대화를 유지하면서 전환하려면 `/tui fullscreen`을 실행하세요. 기본값으로 설정하려면 Claude Code를 시작하기 전에 `CLAUDE_CODE_NO_FLICKER` 환경 변수를 설정하세요:299`/tui fullscreen`을 실행하여 전환하고 기본값을 저장하세요. 대화가 그대로 다시 시작되며 향후 세션은 전체 화면에서 시작됩니다. Claude Code를 시작하기 전에 `CLAUDE_CODE_NO_FLICKER` 환경 변수를 설정할 수도 있습니다:

300 300 

301<CodeGroup>301<CodeGroup>

302 ```bash Bash and Zsh theme={null}302 ```bash Bash and Zsh theme={null}

204 Monitor 도구204 Monitor 도구

205</h2>205</h2>

206 206 

207<Note>

208 Monitor 도구는 Claude Code v2.1.98 이상이 필요합니다.

209</Note>

210 

211Monitor 도구를 사용하면 Claude는 백그라운드에서 무언가를 감시하고 대화를 일시 중지하지 않고 변경될 때 반응할 수 있습니다. Claude에 다음을 요청합니다:207Monitor 도구를 사용하면 Claude는 백그라운드에서 무언가를 감시하고 대화를 일시 중지하지 않고 변경될 때 반응할 수 있습니다. Claude에 다음을 요청합니다:

212 208 

213* 로그 파일을 추적하고 오류가 나타나면 플래그 지정209* 로그 파일을 추적하고 오류가 나타나면 플래그 지정

7> CLI에서 계획을 시작하고, 웹의 Claude Code에서 초안을 작성한 다음, 원격으로 또는 터미널로 돌아가서 실행합니다7> CLI에서 계획을 시작하고, 웹의 Claude Code에서 초안을 작성한 다음, 원격으로 또는 터미널로 돌아가서 실행합니다