12 12 

13확장 프로그램을 사용하면 Claude의 계획을 수락하기 전에 검토하고 편집할 수 있으며, 편집이 이루어질 때 자동으로 수락하고, 선택 항목에서 특정 줄 범위가 있는 파일을 @-멘션으로 표시하고, 대화 기록에 액세스하고, 별도의 탭이나 창에서 여러 대화를 열 수 있습니다.13확장 프로그램을 사용하면 Claude의 계획을 수락하기 전에 검토하고 편집할 수 있으며, 편집이 이루어질 때 자동으로 수락하고, 선택 항목에서 특정 줄 범위가 있는 파일을 @-멘션으로 표시하고, 대화 기록에 액세스하고, 별도의 탭이나 창에서 여러 대화를 열 수 있습니다.

14 14 

15## 필수 조건15<h2 id="prerequisites">

16 필수 조건

17</h2>

16 18 

17설치하기 전에 다음을 확인하십시오:19설치하기 전에 다음을 확인하십시오:

18 20 

23 확장 프로그램에는 CLI(명령줄 인터페이스)가 포함되어 있으며, VS Code의 통합 터미널에서 고급 기능에 액세스할 수 있습니다. 자세한 내용은 [VS Code 확장 프로그램 vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli)를 참조하십시오.25 확장 프로그램에는 CLI(명령줄 인터페이스)가 포함되어 있으며, VS Code의 통합 터미널에서 고급 기능에 액세스할 수 있습니다. 자세한 내용은 [VS Code 확장 프로그램 vs. Claude Code CLI](#vs-code-extension-vs-claude-code-cli)를 참조하십시오.

24</Tip>26</Tip>

25 27 

26## 확장 프로그램 설치28<h2 id="install-the-extension">

29 확장 프로그램 설치

30</h2>

27 31 

28IDE에 대한 링크를 클릭하여 직접 설치합니다:32IDE에 대한 링크를 클릭하여 직접 설치합니다:

29 33 

32 36 

33또는 VS Code에서 `Cmd+Shift+X`(Mac) 또는 `Ctrl+Shift+X`(Windows/Linux)를 눌러 확장 프로그램 보기를 열고, "Claude Code"를 검색한 후 **설치**를 클릭합니다.37또는 VS Code에서 `Cmd+Shift+X`(Mac) 또는 `Ctrl+Shift+X`(Windows/Linux)를 눌러 확장 프로그램 보기를 열고, "Claude Code"를 검색한 후 **설치**를 클릭합니다.

34 38 

35확장 프로그램은 Windsurf 또는 Kiro와 같은 다른 VS Code 포크에도 설치됩니다. 편집기의 확장 프로그램 보기에서 "Claude Code"를 검색하거나 [Open VSX 레지스트리](https://open-vsx.org/extension/Anthropic/claude-code)에서 설치합니다. 편집기에서 확장 프로그램을 설치할 수 없는 경우 통합 터미널에서 `claude`를 실행합니다. [CLI](/ko/quickstart)는 모든 터미널에서 작동합니다.39확장 프로그램은 Devin Desktop 또는 Kiro와 같은 다른 VS Code 포크에도 설치됩니다. 편집기의 확장 프로그램 보기에서 "Claude Code"를 검색하거나 [Open VSX 레지스트리](https://open-vsx.org/extension/Anthropic/claude-code)에서 설치합니다. 편집기에서 확장 프로그램을 설치할 수 없는 경우 통합 터미널에서 `claude`를 실행합니다. [CLI](/ko/quickstart)는 모든 터미널에서 작동합니다.

36 40 

37<Note>설치 후 확장 프로그램이 나타나지 않으면 VS Code를 다시 시작하거나 명령 팔레트에서 "Developer: Reload Window"를 실행합니다.</Note>41<Note>설치 후 확장 프로그램이 나타나지 않으면 VS Code를 다시 시작하거나 명령 팔레트에서 "Developer: Reload Window"를 실행합니다.</Note>

38 42 

39## 시작하기43<h2 id="get-started">

44 시작하기

45</h2>

40 46 

41설치 후 VS Code 인터페이스를 통해 Claude Code를 사용할 수 있습니다:47설치 후 VS Code 인터페이스를 통해 Claude Code를 사용할 수 있습니다:

42 48 

90 명령 팔레트에서 "Claude Code: Open Walkthrough"를 실행하여 기본 사항에 대한 안내 투어를 받습니다.96 명령 팔레트에서 "Claude Code: Open Walkthrough"를 실행하여 기본 사항에 대한 안내 투어를 받습니다.

91</Tip>97</Tip>

92 98 

93## 프롬프트 상자 사용99<h2 id="use-the-prompt-box">

100 프롬프트 상자 사용

101</h2>

94 102 

95프롬프트 상자는 여러 기능을 지원합니다:103프롬프트 상자는 여러 기능을 지원합니다:

96 104 

100* **확장 사고**: Claude가 복잡한 문제를 추론하는 데 더 많은 시간을 소비할 수 있습니다. 명령 메뉴(`/`)를 통해 켭니다. Claude의 추론은 대화에 축소된 블록으로 나타납니다: 블록을 클릭하여 읽거나 `Ctrl+O`를 눌러 세션의 모든 사고 블록을 확장하거나 축소합니다. 자세한 내용은 [확장 사고](/ko/model-config#extended-thinking)를 참조하십시오.108* **확장 사고**: Claude가 복잡한 문제를 추론하는 데 더 많은 시간을 소비할 수 있습니다. 명령 메뉴(`/`)를 통해 켭니다. Claude의 추론은 대화에 축소된 블록으로 나타납니다: 블록을 클릭하여 읽거나 `Ctrl+O`를 눌러 세션의 모든 사고 블록을 확장하거나 축소합니다. 자세한 내용은 [확장 사고](/ko/model-config#extended-thinking)를 참조하십시오.

101* **여러 줄 입력**: `Shift+Enter`를 눌러 보내지 않고 새 줄을 추가합니다. 이것은 질문 대화의 "기타" 자유 텍스트 입력에서도 작동합니다.109* **여러 줄 입력**: `Shift+Enter`를 눌러 보내지 않고 새 줄을 추가합니다. 이것은 질문 대화의 "기타" 자유 텍스트 입력에서도 작동합니다.

102 110 

103### 파일 및 폴더 참조111<h3 id="reference-files-and-folders">

112 파일 및 폴더 참조

113</h3>

104 114 

105@-멘션을 사용하여 특정 파일이나 폴더에 대한 컨텍스트를 Claude에게 제공합니다. `@` 다음에 파일 또는 폴더 이름을 입력하면 Claude는 해당 콘텐츠를 읽고 이에 대해 질문하거나 변경할 수 있습니다. Claude Code는 fuzzy matching을 지원하므로 부분 이름을 입력하여 필요한 것을 찾을 수 있습니다:115@-멘션을 사용하여 특정 파일이나 폴더에 대한 컨텍스트를 Claude에게 제공합니다. `@` 다음에 파일 또는 폴더 이름을 입력하면 Claude는 해당 콘텐츠를 읽고 이에 대해 질문하거나 변경할 수 있습니다. Claude Code는 fuzzy matching을 지원하므로 부분 이름을 입력하여 필요한 것을 찾을 수 있습니다:

106 116 

115 125 

116프롬프트 상자에 파일을 드래그할 때 `Shift`를 누르고 있으면 첨부 파일로 추가할 수 있습니다. 첨부 파일의 X를 클릭하여 컨텍스트에서 제거합니다.126프롬프트 상자에 파일을 드래그할 때 `Shift`를 누르고 있으면 첨부 파일로 추가할 수 있습니다. 첨부 파일의 X를 클릭하여 컨텍스트에서 제거합니다.

117 127 

118### 과거 대화 재개128<h3 id="resume-past-conversations">

129 과거 대화 재개

130</h3>

119 131 

120Claude Code 패널 상단의 **세션 기록** 버튼을 클릭하여 대화 기록에 액세스합니다. 키워드로 검색하거나 시간별로 찾아볼 수 있습니다(오늘, 어제, 지난 7일 등). 대화를 클릭하여 전체 메시지 기록으로 재개합니다. 새 세션은 첫 번째 메시지를 기반으로 AI가 생성한 제목을 받습니다. 세션 위에 마우스를 올려 이름 바꾸기 및 제거 작업을 표시합니다: 설명적인 제목으로 이름을 바꾸거나 목록에서 삭제하려면 제거합니다. 세션 재개에 대한 자세한 내용은 [세션 관리](/ko/sessions)를 참조하십시오.132Claude Code 패널 상단의 **세션 기록** 버튼을 클릭하여 대화 기록에 액세스합니다. 키워드로 검색하거나 시간별로 찾아볼 수 있습니다(오늘, 어제, 지난 7일 등). 대화를 클릭하여 전체 메시지 기록으로 재개합니다. 새 세션은 첫 번째 메시지를 기반으로 AI가 생성한 제목을 받습니다. 세션 위에 마우스를 올려 이름 바꾸기 및 제거 작업을 표시합니다: 설명적인 제목으로 이름을 바꾸거나 목록에서 삭제하려면 제거합니다. 세션 재개에 대한 자세한 내용은 [세션 관리](/ko/sessions)를 참조하십시오.

121 133 

122### Claude.ai에서 원격 세션 재개134<h3 id="resume-remote-sessions-from-claude-ai">

135 Claude.ai에서 원격 세션 재개

136</h3>

123 137 

124[웹에서 Claude Code](/ko/claude-code-on-the-web)를 사용하는 경우 VS Code에서 직접 해당 원격 세션을 재개할 수 있습니다. 이를 위해서는 Anthropic Console이 아닌 **Claude.ai Subscription**으로 로그인해야 합니다.138[웹에서 Claude Code](/ko/claude-code-on-the-web)를 사용하는 경우 VS Code에서 직접 해당 원격 세션을 재개할 수 있습니다. 이를 위해서는 Anthropic Console이 아닌 **Claude.ai Subscription**으로 로그인해야 합니다.

125 139 

141 원격 탭에는 GitHub 저장소로 시작된 웹 세션만 나타납니다. 재개하면 대화 기록이 로컬로 로드되며, 변경 사항은 claude.ai로 다시 동기화되지 않습니다.155 원격 탭에는 GitHub 저장소로 시작된 웹 세션만 나타납니다. 재개하면 대화 기록이 로컬로 로드되며, 변경 사항은 claude.ai로 다시 동기화되지 않습니다.

142</Note>156</Note>

143 157 

144## 워크플로우 사용자 정의158<h2 id="customize-your-workflow">

159 워크플로우 사용자 정의

160</h2>

145 161 

146실행 중이면 Claude 패널을 다시 배치하거나, 여러 세션을 실행하거나, 터미널 모드로 전환할 수 있습니다.162실행 중이면 Claude 패널을 다시 배치하거나, 여러 세션을 실행하거나, 터미널 모드로 전환할 수 있습니다.

147 163 

148### Claude가 있는 위치 선택164<h3 id="choose-where-claude-lives">

165 Claude가 있는 위치 선택

166</h3>

149 167 

150Claude 패널을 드래그하여 VS Code의 어느 곳이든 다시 배치할 수 있습니다. 패널의 탭이나 제목 표시줄을 잡고 다음으로 드래그합니다:168Claude 패널을 드래그하여 VS Code의 어느 곳이든 다시 배치할 수 있습니다. 패널의 탭이나 제목 표시줄을 잡고 다음으로 드래그합니다:

151 169 

157 주 Claude 세션에 사이드바를 사용하고 부수적인 작업을 위해 추가 탭을 엽니다. Claude는 선호하는 위치를 기억합니다. 활동 표시줄 세션 목록 아이콘은 Claude 패널과 별개입니다: 세션 목록은 항상 활동 표시줄에 표시되지만 Claude 패널 아이콘은 패널이 왼쪽 사이드바에 도킹되어 있을 때만 나타납니다.175 주 Claude 세션에 사이드바를 사용하고 부수적인 작업을 위해 추가 탭을 엽니다. Claude는 선호하는 위치를 기억합니다. 활동 표시줄 세션 목록 아이콘은 Claude 패널과 별개입니다: 세션 목록은 항상 활동 표시줄에 표시되지만 Claude 패널 아이콘은 패널이 왼쪽 사이드바에 도킹되어 있을 때만 나타납니다.

158</Tip>176</Tip>

159 177 

160### 여러 대화 실행178<h3 id="run-multiple-conversations">

179 여러 대화 실행

180</h3>

161 181 

162명령 팔레트에서 **새 탭에서 열기** 또는 **새 창에서 열기**를 사용하여 추가 대화를 시작합니다. 각 대화는 자체 기록 및 컨텍스트를 유지하므로 다양한 작업을 병렬로 작업할 수 있습니다.182명령 팔레트에서 **새 탭에서 열기** 또는 **새 창에서 열기**를 사용하여 추가 대화를 시작합니다. 각 대화는 자체 기록 및 컨텍스트를 유지하므로 다양한 작업을 병렬로 작업할 수 있습니다.

163 183 

164탭을 사용할 때 spark 아이콘의 작은 색상 점은 상태를 나타냅니다: 파란색은 권한 요청이 보류 중임을 의미하고, 주황색은 탭이 숨겨져 있는 동안 Claude가 완료되었음을 의미합니다.184탭을 사용할 때 spark 아이콘의 작은 색상 점은 상태를 나타냅니다: 파란색은 권한 요청이 보류 중임을 의미하고, 주황색은 탭이 숨겨져 있는 동안 Claude가 완료되었음을 의미합니다.

165 185 

166### 터미널 모드로 전환186<h3 id="switch-to-terminal-mode">

187 터미널 모드로 전환

188</h3>

167 189 

168기본적으로 확장 프로그램은 그래픽 채팅 패널을 엽니다. CLI 스타일 인터페이스를 선호하는 경우 [Use Terminal 설정](vscode://settings/claudeCode.useTerminal)을 열고 상자를 선택합니다.190기본적으로 확장 프로그램은 그래픽 채팅 패널을 엽니다. CLI 스타일 인터페이스를 선호하는 경우 [Use Terminal 설정](vscode://settings/claudeCode.useTerminal)을 열고 상자를 선택합니다.

169 191 

170VS Code 설정(`Cmd+,` Mac 또는 `Ctrl+,` Windows/Linux)을 열고 확장 프로그램 → Claude Code로 이동한 후 **Use Terminal**을 선택할 수도 있습니다.192VS Code 설정(`Cmd+,` Mac 또는 `Ctrl+,` Windows/Linux)을 열고 확장 프로그램 → Claude Code로 이동한 후 **Use Terminal**을 선택할 수도 있습니다.

171 193 

172## 플러그인 관리194<h2 id="manage-plugins">

195 플러그인 관리

196</h2>

173 197 

174VS Code 확장 프로그램에는 [플러그인](/ko/plugins)을 설치하고 관리하기 위한 그래픽 인터페이스가 포함되어 있습니다. 프롬프트 상자에 `/plugins`를 입력하여 **플러그인 관리** 인터페이스를 엽니다.198VS Code 확장 프로그램에는 [플러그인](/ko/plugins)을 설치하고 관리하기 위한 그래픽 인터페이스가 포함되어 있습니다. 프롬프트 상자에 `/plugins`를 입력하여 **플러그인 관리** 인터페이스를 엽니다.

175 199 

176### 플러그인 설치200<h3 id="install-plugins">

201 플러그인 설치

202</h3>

177 203 

178플러그인 대화 상자에는 **플러그인** 및 **마켓플레이스**의 두 탭이 표시됩니다.204플러그인 대화 상자에는 **플러그인** 및 **마켓플레이스**의 두 탭이 표시됩니다.

179 205 

190* **이 프로젝트용 설치**: 프로젝트 협력자와 공유(프로젝트 범위)216* **이 프로젝트용 설치**: 프로젝트 협력자와 공유(프로젝트 범위)

191* **로컬로 설치**: 이 저장소에서만 사용자용(로컬 범위)217* **로컬로 설치**: 이 저장소에서만 사용자용(로컬 범위)

192 218 

193### 마켓플레이스 관리219<h3 id="manage-marketplaces">

220 마켓플레이스 관리

221</h3>

194 222 

195**마켓플레이스** 탭으로 전환하여 플러그인 소스를 추가하거나 제거합니다:223**마켓플레이스** 탭으로 전환하여 플러그인 소스를 추가하거나 제거합니다:

196 224 

206 234 

207플러그인 시스템에 대한 자세한 내용은 [플러그인](/ko/plugins) 및 [플러그인 마켓플레이스](/ko/plugin-marketplaces)를 참조하십시오.235플러그인 시스템에 대한 자세한 내용은 [플러그인](/ko/plugins) 및 [플러그인 마켓플레이스](/ko/plugin-marketplaces)를 참조하십시오.

208 236 

209## Chrome으로 브라우저 작업 자동화237<h2 id="automate-browser-tasks-with-chrome">

238 Chrome으로 브라우저 작업 자동화

239</h2>

210 240 

211Claude를 Chrome 브라우저에 연결하여 웹 앱을 테스트하고, 콘솔 로그로 디버깅하고, VS Code를 떠나지 않고 브라우저 워크플로우를 자동화합니다. 이를 위해서는 [Chrome의 Claude 확장 프로그램](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 버전 1.0.36 이상이 필요합니다.241Claude를 Chrome 브라우저에 연결하여 웹 앱을 테스트하고, 콘솔 로그로 디버깅하고, VS Code를 떠나지 않고 브라우저 워크플로우를 자동화합니다. 이를 위해서는 [Chrome의 Claude 확장 프로그램](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) 버전 1.0.36 이상이 필요합니다.

212 242 

222 252 

223설정 지침, 전체 기능 목록 및 문제 해결은 [Chrome에서 Claude Code 사용](/ko/chrome)을 참조하십시오.253설정 지침, 전체 기능 목록 및 문제 해결은 [Chrome에서 Claude Code 사용](/ko/chrome)을 참조하십시오.

224 254 

225## VS Code 명령 및 단축키255<h2 id="vs-code-commands-and-shortcuts">

256 VS Code 명령 및 단축키

257</h2>

226 258 

227명령 팔레트(`Cmd+Shift+P` Mac 또는 `Ctrl+Shift+P` Windows/Linux)를 열고 "Claude Code"를 입력하여 Claude Code 확장 프로그램에 사용 가능한 모든 VS Code 명령을 봅니다.259명령 팔레트(`Cmd+Shift+P` Mac 또는 `Ctrl+Shift+P` Windows/Linux)를 열고 "Claude Code"를 입력하여 Claude Code 확장 프로그램에 사용 가능한 모든 VS Code 명령을 봅니다.

228 260 

245| Show Logs | - | 확장 프로그램 디버그 로그 보기 |277| Show Logs | - | 확장 프로그램 디버그 로그 보기 |

246| Logout | - | Anthropic 계정에서 로그아웃 |278| Logout | - | Anthropic 계정에서 로그아웃 |

247 279 

248### 다른 도구에서 VS Code 탭 시작280<h3 id="launch-a-vs-code-tab-from-other-tools">

281 다른 도구에서 VS Code 탭 시작

282</h3>

249 283 

250확장 프로그램은 `vscode://anthropic.claude-code/open`에서 URI 핸들러를 등록합니다. 이를 사용하여 자신의 도구에서 새 Claude Code 탭을 열 수 있습니다: 셸 별칭, 브라우저 북마크렛 또는 URL을 열 수 있는 모든 스크립트입니다. VS Code가 아직 실행 중이 아니면 URL을 열면 먼저 시작됩니다. VS Code가 이미 실행 중이면 URL은 현재 포커스된 창에서 열립니다.284확장 프로그램은 `vscode://anthropic.claude-code/open`에서 URI 핸들러를 등록합니다. 이를 사용하여 자신의 도구에서 새 Claude Code 탭을 열 수 있습니다: 셸 별칭, 브라우저 북마크렛 또는 URL을 열 수 있는 모든 스크립트입니다. VS Code가 아직 실행 중이 아니면 URL을 열면 먼저 시작됩니다. VS Code가 이미 실행 중이면 URL은 현재 포커스된 창에서 열립니다.

251 285 

294 328 

295터미널 세션을 VS Code 탭 대신 시작하려면 CLI의 `claude-cli://` 핸들러를 사용합니다. [링크에서 세션 시작](/ko/deep-links)을 참조하십시오.329터미널 세션을 VS Code 탭 대신 시작하려면 CLI의 `claude-cli://` 핸들러를 사용합니다. [링크에서 세션 시작](/ko/deep-links)을 참조하십시오.

296 330 

297## 설정 구성331<h2 id="configure-settings">

332 설정 구성

333</h2>

298 334 

299확장 프로그램에는 두 가지 유형의 설정이 있습니다:335확장 프로그램에는 두 가지 유형의 설정이 있습니다:

300 336 

305 `"$schema": "https://json.schemastore.org/claude-code-settings.json"`을 `settings.json`에 추가하여 VS Code에서 직접 사용 가능한 모든 설정에 대한 자동 완성 및 인라인 유효성 검사를 받습니다.341 `"$schema": "https://json.schemastore.org/claude-code-settings.json"`을 `settings.json`에 추가하여 VS Code에서 직접 사용 가능한 모든 설정에 대한 자동 완성 및 인라인 유효성 검사를 받습니다.

306</Tip>342</Tip>

307 343 

308### 확장 프로그램 설정344<h3 id="extension-settings">

345 확장 프로그램 설정

346</h3>

309 347 

310| 설정 | 기본값 | 설명 |348| 설정 | 기본값 | 설명 |

311| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |349| ----------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------- |

312| `useTerminal` | `false` | 그래픽 패널 대신 터미널 모드에서 Claude 시작 |350| `useTerminal` | `false` | 그래픽 패널 대신 터미널 모드에서 Claude 시작 |

313| `initialPermissionMode` | `default` | 새 대화에 대한 승인 프롬프트 제어: `default`, `plan`, `acceptEdits` 또는 `bypassPermissions`. [권한 모드](/ko/permission-modes)를 참조하십시오. |351| `initialPermissionMode` | `default` | 새 대화에 대한 승인 프롬프트 제어: `default`, `plan`, `acceptEdits` 또는 `bypassPermissions`. [권한 모드](/ko/permission-modes)를 참조하십시오. |

314| `preferredLocation` | `panel` | Claude가 열리는 위치: `sidebar`(오른쪽) 또는 `panel`(새 탭) |352| `preferredLocation` | `panel` | Claude가 열리는 위치: `sidebar`(오른쪽) 또는 `panel`(새 탭) |

321| `usePythonEnvironment` | `true` | Claude를 실행할 때 작업 공간의 Python 환경을 활성화합니다. Python 확장 프로그램이 필요합니다. |359| `usePythonEnvironment` | `true` | Claude를 실행할 때 작업 공간의 Python 환경을 활성화합니다. Python 확장 프로그램이 필요합니다. |

322| `environmentVariables` | `[]` | Claude 프로세스에 대한 환경 변수 설정. 공유 구성을 위해 Claude Code 설정을 대신 사용합니다. |360| `environmentVariables` | `[]` | Claude 프로세스에 대한 환경 변수 설정. 공유 구성을 위해 Claude Code 설정을 대신 사용합니다. |

323| `disableLoginPrompt` | `false` | 인증 프롬프트 건너뛰기(타사 공급자 설정용) |361| `disableLoginPrompt` | `false` | 인증 프롬프트 건너뛰기(타사 공급자 설정용) |

324| `allowDangerouslySkipPermissions` | `false` | [Auto mode](/ko/permission-modes#eliminate-prompts-with-auto-mode) 및 Bypass 권한을 모드 선택기에 추가합니다. Auto mode는 [계획, 관리자, 모델 및 공급자 요구 사항](/ko/permission-modes#eliminate-prompts-with-auto-mode)이 있으므로 이 토글이 켜져 있어도 사용 불가능할 수 있습니다. Bypass 권한은 인터넷 액세스가 없는 샌드박스에서만 사용합니다. |362| `allowDangerouslySkipPermissions` | `false` | 모드 선택기에 Bypass 권한을 추가합니다. 인터넷 액세스가 없는 샌드박스에서만 사용합니다. |

325| `claudeProcessWrapper` | - | Claude 프로세스를 시작하는 데 사용되는 실행 파일입니다. 번들된 바이너리 경로는 존재할 때 인수로 전달됩니다. 확장 프로그램 빌드에 플랫폼용 바이너리가 포함되지 않은 경우 별도로 설치된 `claude` 바이너리로 설정합니다. |363| `claudeProcessWrapper` | - | Claude 프로세스를 시작하는 데 사용되는 실행 파일입니다. 번들된 바이너리 경로는 존재할 때 인수로 전달됩니다. 확장 프로그램 빌드에 플랫폼용 바이너리가 포함되지 않은 경우 별도로 설치된 `claude` 바이너리로 설정합니다. |

326 364 

327## VS Code 확장 프로그램 vs. Claude Code CLI365<h2 id="vs-code-extension-vs-claude-code-cli">

366 VS Code 확장 프로그램 vs. Claude Code CLI

367</h2>

328 368 

329Claude Code는 VS Code 확장 프로그램(그래픽 패널)과 CLI(터미널의 명령줄 인터페이스) 모두로 사용 가능합니다. 일부 기능은 CLI에서만 사용 가능합니다. CLI 전용 기능이 필요한 경우 VS Code의 통합 터미널에서 `claude`를 실행합니다.369Claude Code는 VS Code 확장 프로그램(그래픽 패널)과 CLI(터미널의 명령줄 인터페이스) 모두로 사용 가능합니다. 일부 기능은 CLI에서만 사용 가능합니다. CLI 전용 기능이 필요한 경우 VS Code의 통합 터미널에서 `claude`를 실행합니다.

330 370 

336| `!` bash 단축키 | 예 | 아니요 |376| `!` bash 단축키 | 예 | 아니요 |

337| Tab 완성 | 예 | 아니요 |377| Tab 완성 | 예 | 아니요 |

338 378 

339### Checkpoints로 되감기379<h3 id="rewind-with-checkpoints">

380 Checkpoints로 되감기

381</h3>

340 382 

341VS Code 확장 프로그램은 Claude의 파일 편집을 추적하고 이전 상태로 되감을 수 있는 checkpoints를 지원합니다. 메시지 위에 마우스를 올려 되감기 버튼을 표시한 후 세 가지 옵션 중에서 선택합니다:383VS Code 확장 프로그램은 Claude의 파일 편집을 추적하고 이전 상태로 되감을 수 있는 checkpoints를 지원합니다. 메시지 위에 마우스를 올려 되감기 버튼을 표시한 후 세 가지 옵션 중에서 선택합니다:

342 384 

346 388 

347checkpoints 작동 방식 및 제한 사항에 대한 전체 세부 정보는 [Checkpointing](/ko/checkpointing)을 참조하십시오.389checkpoints 작동 방식 및 제한 사항에 대한 전체 세부 정보는 [Checkpointing](/ko/checkpointing)을 참조하십시오.

348 390 

349### VS Code에서 CLI 실행391<h3 id="run-cli-in-vs-code">

392 VS Code에서 CLI 실행

393</h3>

350 394 

351VS Code에 머물면서 CLI를 사용하려면 통합 터미널(Windows/Linux에서 `` Ctrl+` `` 또는 Mac에서 `` Cmd+` ``)을 열고 `claude`를 실행합니다. CLI는 diff 보기 및 진단 공유와 같은 기능을 위해 IDE와 자동으로 통합됩니다.395VS Code에 머물면서 CLI를 사용하려면 통합 터미널(Windows/Linux에서 `` Ctrl+` `` 또는 Mac에서 `` Cmd+` ``)을 열고 `claude`를 실행합니다. CLI는 diff 보기 및 진단 공유와 같은 기능을 위해 IDE와 자동으로 통합됩니다.

352 396 

353외부 터미널을 사용하는 경우 Claude Code 내에서 `/ide`를 실행하여 VS Code에 연결합니다.397외부 터미널을 사용하는 경우 Claude Code 내에서 `/ide`를 실행하여 VS Code에 연결합니다.

354 398 

355### 확장 프로그램과 CLI 간 전환399<h3 id="switch-between-extension-and-cli">

400 확장 프로그램과 CLI 간 전환

401</h3>

356 402 

357확장 프로그램과 CLI는 동일한 대화 기록을 공유합니다. 확장 프로그램 대화를 CLI에서 계속하려면 터미널에서 `claude --resume`을 실행합니다. 이렇게 하면 대화를 검색하고 선택할 수 있는 대화형 선택기가 열립니다.403확장 프로그램과 CLI는 동일한 대화 기록을 공유합니다. 확장 프로그램 대화를 CLI에서 계속하려면 터미널에서 `claude --resume`을 실행합니다. 이렇게 하면 대화를 검색하고 선택할 수 있는 대화형 선택기가 열립니다.

358 404 

359### 프롬프트에 터미널 출력 포함405<h3 id="include-terminal-output-in-prompts">

406 프롬프트에 터미널 출력 포함

407</h3>

360 408 

361`@terminal:name`을 사용하여 프롬프트에서 터미널 출력을 참조합니다. 여기서 `name`은 터미널의 제목입니다. 이를 통해 Claude는 복사 붙여넣기 없이 명령 출력, 오류 메시지 또는 로그를 볼 수 있습니다.409`@terminal:name`을 사용하여 프롬프트에서 터미널 출력을 참조합니다. 여기서 `name`은 터미널의 제목입니다. 이를 통해 Claude는 복사 붙여넣기 없이 명령 출력, 오류 메시지 또는 로그를 볼 수 있습니다.

362 410 

363### 백그라운드 프로세스 모니터링411<h3 id="monitor-background-processes">

412 백그라운드 프로세스 모니터링

413</h3>

364 414 

365Claude가 장기 실행 명령을 실행할 때 확장 프로그램은 상태 표시줄에 진행 상황을 표시합니다. 그러나 백그라운드 작업의 가시성은 CLI에 비해 제한적입니다. 더 나은 가시성을 위해 Claude가 명령을 출력하도록 하여 VS Code의 통합 터미널에서 실행할 수 있습니다.415Claude가 장기 실행 명령을 실행할 때 확장 프로그램은 상태 표시줄에 진행 상황을 표시합니다. 그러나 백그라운드 작업의 가시성은 CLI에 비해 제한적입니다. 더 나은 가시성을 위해 Claude가 명령을 출력하도록 하여 VS Code의 통합 터미널에서 실행할 수 있습니다.

366 416 

367### MCP를 사용하여 외부 도구에 연결417<h3 id="connect-to-external-tools-with-mcp">

418 MCP를 사용하여 외부 도구에 연결

419</h3>

368 420 

369MCP(Model Context Protocol) 서버는 Claude에게 외부 도구, 데이터베이스 및 API에 대한 액세스를 제공합니다.421MCP(Model Context Protocol) 서버는 Claude에게 외부 도구, 데이터베이스 및 API에 대한 액세스를 제공합니다.

370 422 

379 431 

380VS Code를 떠나지 않고 MCP 서버를 관리하려면 채팅 패널에 `/mcp`를 입력합니다. MCP 관리 대화 상자를 사용하면 서버를 활성화 또는 비활성화하고, 서버에 다시 연결하고, OAuth 인증을 관리할 수 있습니다. 사용 가능한 서버는 [MCP 문서](/ko/mcp)를 참조하십시오.432VS Code를 떠나지 않고 MCP 서버를 관리하려면 채팅 패널에 `/mcp`를 입력합니다. MCP 관리 대화 상자를 사용하면 서버를 활성화 또는 비활성화하고, 서버에 다시 연결하고, OAuth 인증을 관리할 수 있습니다. 사용 가능한 서버는 [MCP 문서](/ko/mcp)를 참조하십시오.

381 433 

382## git으로 작업434<h2 id="work-with-git">

435 git으로 작업

436</h2>

383 437 

384Claude Code는 git과 통합되어 VS Code에서 직접 버전 제어 워크플로우를 지원합니다. Claude에게 변경 사항을 커밋하거나, 풀 요청을 생성하거나, 분기 간에 작업하도록 요청합니다.438Claude Code는 git과 통합되어 VS Code에서 직접 버전 제어 워크플로우를 지원합니다. Claude에게 변경 사항을 커밋하거나, 풀 요청을 생성하거나, 분기 간에 작업하도록 요청합니다.

385 439 

386### 커밋 및 풀 요청 생성440<h3 id="create-commits-and-pull-requests">

441 커밋 및 풀 요청 생성

442</h3>

387 443 

388Claude는 변경 사항을 스테이징하고, 커밋 메시지를 작성하고, 작업을 기반으로 풀 요청을 생성할 수 있습니다:444Claude는 변경 사항을 스테이징하고, 커밋 메시지를 작성하고, 작업을 기반으로 풀 요청을 생성할 수 있습니다:

389 445 

395 451 

396풀 요청을 생성할 때 Claude는 실제 코드 변경을 기반으로 설명을 생성하고 테스트 또는 구현 결정에 대한 컨텍스트를 추가할 수 있습니다.452풀 요청을 생성할 때 Claude는 실제 코드 변경을 기반으로 설명을 생성하고 테스트 또는 구현 결정에 대한 컨텍스트를 추가할 수 있습니다.

397 453 

398### 병렬 작업을 위해 git worktrees 사용454<h3 id="use-git-worktrees-for-parallel-tasks">

455 병렬 작업을 위해 git worktrees 사용

456</h3>

399 457 

400`--worktree`(`-w`) 플래그를 사용하여 자체 파일 및 분기가 있는 격리된 worktree에서 Claude를 시작합니다:458`--worktree`(`-w`) 플래그를 사용하여 자체 파일 및 분기가 있는 격리된 worktree에서 Claude를 시작합니다:

401 459 

405 463 

406각 worktree는 git 기록을 공유하면서 독립적인 파일 상태를 유지합니다. 이렇게 하면 Claude 인스턴스가 다양한 작업을 수행할 때 서로 간섭하지 않습니다. 자세한 내용은 [Git worktrees를 사용하여 병렬 세션 실행](/ko/worktrees)을 참조하십시오.464각 worktree는 git 기록을 공유하면서 독립적인 파일 상태를 유지합니다. 이렇게 하면 Claude 인스턴스가 다양한 작업을 수행할 때 서로 간섭하지 않습니다. 자세한 내용은 [Git worktrees를 사용하여 병렬 세션 실행](/ko/worktrees)을 참조하십시오.

407 465 

408## 타사 공급자 사용466<h2 id="use-third-party-providers">

467 타사 공급자 사용

468</h2>

409 469 

410기본적으로 Claude Code는 Anthropic의 API에 직접 연결됩니다. 조직에서 Amazon Bedrock, Google Vertex AI 또는 Microsoft Foundry를 사용하여 Claude에 액세스하는 경우 대신 공급자를 사용하도록 확장 프로그램을 구성합니다:470기본적으로 Claude Code는 Anthropic의 API에 직접 연결됩니다. 조직에서 Amazon Bedrock, Google Vertex AI 또는 Microsoft Foundry를 사용하여 Claude에 액세스하는 경우 대신 공급자를 사용하도록 확장 프로그램을 구성합니다:

411 471 

427 </Step>487 </Step>

428</Steps>488</Steps>

429 489 

430## 보안 및 개인 정보 보호490<h2 id="security-and-privacy">

491 보안 및 개인 정보 보호

492</h2>

431 493 

432코드는 비공개로 유지됩니다. Claude Code는 코드를 처리하여 지원을 제공하지만 모델 학습에 사용하지 않습니다. 데이터 처리 및 로깅을 거부하는 방법에 대한 자세한 내용은 [데이터 및 개인 정보 보호](/ko/data-usage)를 참조하십시오.494코드는 비공개로 유지됩니다. Claude Code는 코드를 처리하여 지원을 제공하지만 모델 학습에 사용하지 않습니다. 데이터 처리 및 로깅을 거부하는 방법에 대한 자세한 내용은 [데이터 및 개인 정보 보호](/ko/data-usage)를 참조하십시오.

433 495 

437* 편집에 대해 자동 수락 대신 수동 승인 모드를 사용합니다.499* 편집에 대해 자동 수락 대신 수동 승인 모드를 사용합니다.

438* 수락하기 전에 변경 사항을 주의 깊게 검토합니다.500* 수락하기 전에 변경 사항을 주의 깊게 검토합니다.

439 501 

440### 기본 제공 IDE MCP 서버502<h3 id="the-built-in-ide-mcp-server">

503 기본 제공 IDE MCP 서버

504</h3>

441 505 

442확장 프로그램이 활성화되면 CLI가 자동으로 연결하는 로컬 MCP 서버를 실행합니다. 이것이 CLI가 VS Code의 기본 diff 뷰어에서 diff를 열고, `@`-멘션에 대한 현재 선택을 읽고, Jupyter 노트북에서 작업할 때 VS Code에 셀을 실행하도록 요청하는 방법입니다.506확장 프로그램이 활성화되면 CLI가 자동으로 연결하는 로컬 MCP 서버를 실행합니다. 이것이 CLI가 VS Code의 기본 diff 뷰어에서 diff를 열고, `@`-멘션에 대한 현재 선택을 읽고, Jupyter 노트북에서 작업할 때 VS Code에 셀을 실행하도록 요청하는 방법입니다.

443 507 

444서버의 이름은 `ide`이며 구성할 것이 없으므로 `/mcp`에서 숨겨져 있습니다. 그러나 조직에서 `PreToolUse` hook을 사용하여 MCP 도구를 허용 목록에 추가하는 경우 이것이 존재한다는 것을 알아야 합니다.508서버의 이름은 `ide`이며 구성할 것이 없으므로 `/mcp`에서 숨겨져 있습니다. 그러나 조직에서 `PreToolUse` hook을 사용하여 MCP 도구를 허용 목록에 추가하는 경우 이것이 존재한다는 것을 알아야 합니다.

445 509 

510**선택 및 열린 파일 컨텍스트.** 연결되어 있는 동안 CLI는 현재 편집기 선택 및 활성 파일의 경로를 각 프롬프트에 컨텍스트로 포함합니다. 트랜스크립트는 이것이 발생할 때 `⧉ <파일>에서 N줄 선택됨` 줄을 표시합니다. `.env`와 같은 민감한 파일을 제외하려면 해당 경로에 대한 [`Read` 거부 규칙](/ko/permissions#read-and-edit)을 추가합니다. 일치하는 거부 규칙은 선택된 텍스트와 해당 파일에 대한 열린 파일 공지가 Claude에 도달하는 것을 모두 방지합니다.

511 

446**전송 및 인증.** 서버는 `127.0.0.1`에 바인드되고 임의의 높은 포트에서 다른 머신에서 도달할 수 없습니다. 각 확장 프로그램 활성화는 CLI가 연결하기 위해 제시해야 하는 새로운 임의의 인증 토큰을 생성합니다. 토큰은 `0600` 권한이 있는 `0700` 디렉토리 아래 `~/.claude/ide/`의 잠금 파일에 기록되므로 VS Code를 실행하는 사용자만 읽을 수 있습니다.512**전송 및 인증.** 서버는 `127.0.0.1`에 바인드되고 임의의 높은 포트에서 다른 머신에서 도달할 수 없습니다. 각 확장 프로그램 활성화는 CLI가 연결하기 위해 제시해야 하는 새로운 임의의 인증 토큰을 생성합니다. 토큰은 `0600` 권한이 있는 `0700` 디렉토리 아래 `~/.claude/ide/`의 잠금 파일에 기록되므로 VS Code를 실행하는 사용자만 읽을 수 있습니다.

447 513 

448**모델에 노출된 도구.** 서버는 약 12개의 도구를 호스팅하지만 모델에만 2개가 표시됩니다. 나머지는 CLI가 자체 UI(diff 열기, 선택 읽기, 파일 저장)에 사용하는 내부 RPC이며 도구 목록이 Claude에 도달하기 전에 필터링됩니다.514**모델에 노출된 도구.** 서버는 약 12개의 도구를 호스팅하지만 모델에만 2개가 표시됩니다. 나머지는 CLI가 자체 UI(diff 열기, 선택 읽기, 파일 저장)에 사용하는 내부 RPC이며 도구 목록이 Claude에 도달하기 전에 필터링됩니다.

460 526 

461<a id="troubleshooting" />527<a id="troubleshooting" />

462 528 

463## 일반적인 문제 해결529<h2 id="fix-common-issues">

530 일반적인 문제 해결

531</h2>

464 532 

465### 확장 프로그램이 설치되지 않음533<h3 id="extension-won-t-install">

534 확장 프로그램이 설치되지 않음

535</h3>

466 536 

467* VS Code의 호환 버전(1.98.0 이상)이 있는지 확인합니다.537* VS Code의 호환 버전(1.98.0 이상)이 있는지 확인합니다.

468* VS Code에 확장 프로그램을 설치할 권한이 있는지 확인합니다.538* VS Code에 확장 프로그램을 설치할 권한이 있는지 확인합니다.

469* [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)에서 직접 설치를 시도합니다.539* [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)에서 직접 설치를 시도합니다.

470 540 

471### Spark 아이콘이 표시되지 않음541<h3 id="spark-icon-not-visible">

542 Spark 아이콘이 표시되지 않음

543</h3>

472 544 

473Spark 아이콘은 파일을 열었을 때 **편집기 도구 모음**(편집기의 오른쪽 위)에 나타납니다. 표시되지 않으면:545Spark 아이콘은 파일을 열었을 때 **편집기 도구 모음**(편집기의 오른쪽 위)에 나타납니다. 표시되지 않으면:

474 546 

480 552 

481또는 **상태 표시줄**(오른쪽 아래 모서리)에서 "✱ Claude Code"를 클릭합니다. 파일을 열지 않았을 때도 작동합니다. **명령 팔레트**(`Cmd+Shift+P` / `Ctrl+Shift+P`)를 사용하고 "Claude Code"를 입력할 수도 있습니다.553또는 **상태 표시줄**(오른쪽 아래 모서리)에서 "✱ Claude Code"를 클릭합니다. 파일을 열지 않았을 때도 작동합니다. **명령 팔레트**(`Cmd+Shift+P` / `Ctrl+Shift+P`)를 사용하고 "Claude Code"를 입력할 수도 있습니다.

482 554 

483### macOS에서 Cmd+Esc가 작동하지 않음555<h3 id="cmd-esc-does-nothing-on-macos">

556 macOS에서 Cmd+Esc가 작동하지 않음

557</h3>

484 558 

485macOS Tahoe 이상에서는 시스템 Game Overlay 단축키가 기본적으로 `Cmd+Esc`에 바인딩되어 있으며 VS Code에 도달하기 전에 키 입력을 가로챕니다. 단축키를 해제하려면:559macOS Tahoe 이상에서는 시스템 Game Overlay 단축키가 기본적으로 `Cmd+Esc`에 바인딩되어 있으며 VS Code에 도달하기 전에 키 입력을 가로챕니다. 단축키를 해제하려면:

486 560 

490 564 

491또는 확장 프로그램을 다른 키로 다시 바인딩합니다. VS Code [키보드 단축키 편집기](https://code.visualstudio.com/docs/configure/keybindings)(`Cmd+K Cmd+S`)를 열고 `Claude Code: Focus input`을 검색한 후 새 바인딩을 할당합니다.565또는 확장 프로그램을 다른 키로 다시 바인딩합니다. VS Code [키보드 단축키 편집기](https://code.visualstudio.com/docs/configure/keybindings)(`Cmd+K Cmd+S`)를 열고 `Claude Code: Focus input`을 검색한 후 새 바인딩을 할당합니다.

492 566 

493### Claude Code가 응답하지 않음567<h3 id="claude-code-never-responds">

568 Claude Code가 응답하지 않음

569</h3>

494 570 

495Claude Code가 프롬프트에 응답하지 않으면:571Claude Code가 프롬프트에 응답하지 않으면:

496 572 

500 576 

501문제가 지속되면 오류에 대한 세부 정보와 함께 [GitHub에서 문제를 제출합니다](https://github.com/anthropics/claude-code/issues).577문제가 지속되면 오류에 대한 세부 정보와 함께 [GitHub에서 문제를 제출합니다](https://github.com/anthropics/claude-code/issues).

502 578 

503## 확장 프로그램 제거579<h2 id="uninstall-the-extension">

580 확장 프로그램 제거

581</h2>

504 582 

505Claude Code 확장 프로그램을 제거하려면:583Claude Code 확장 프로그램을 제거하려면:

506 584 

516 594 

517추가 도움말은 [문제 해결 가이드](/ko/troubleshooting)를 참조하십시오.595추가 도움말은 [문제 해결 가이드](/ko/troubleshooting)를 참조하십시오.

518 596 

519## 다음 단계597<h2 id="next-steps">

598 다음 단계

599</h2>

520 600 

521이제 VS Code에서 Claude Code를 설정했습니다:601이제 VS Code에서 Claude Code를 설정했습니다:

522 602