Documentation — Spybara

claude-code-on-the-web.md +40 −42

Details

13웹에서 Claude Code는 [claude.ai/code](https://claude.ai/code)의 Anthropic 관리 클라우드 인프라에서 작업을 실행합니다. 세션은 브라우저를 닫아도 유지되며, Claude 모바일 앱에서 모니터링할 수 있습니다.13웹에서 Claude Code는 [claude.ai/code](https://claude.ai/code)의 Anthropic 관리 클라우드 인프라에서 작업을 실행합니다. 세션은 브라우저를 닫아도 유지되며, Claude 모바일 앱에서 모니터링할 수 있습니다.

14 14

15<Tip>15<Tip>

~~16 웹에서 Claude Code를 처음 사용하시나요? [시작하기](/ko/web-quickstart)에서 GitHub 계정을 연결하고 첫 번째 작업을 제출하세요.~~16 웹에서 Claude Code를 처음 사용하시나요? [시작하기](/docs/ko/web-quickstart)에서 GitHub 계정을 연결하고 첫 번째 작업을 제출하세요.

17</Tip>17</Tip>

18 18

19이 페이지에서 다루는 내용:19이 페이지에서 다루는 내용:

36 36

37| 방법 | 작동 방식 | 최적 대상 |37| 방법 | 작동 방식 | 최적 대상 |

38| :--------------- | :---------------------------------------------------------- | :------------------------------------------------ |38| :--------------- | :---------------------------------------------------------- | :------------------------------------------------ |

41 41

42<Note>42<Note>

43 두 방법 모두에서 클라우드 세션은 Claude GitHub App이 설치된 저장소뿐만 아니라 연결된 GitHub 계정이 볼 수 있는 모든 저장소에 액세스할 수 있습니다. App 설치는 [자동 수정](#auto-fix-pull-requests)을 위한 PR 웹훅을 활성화합니다. 이는 세션 수준의 액세스 제어가 아닙니다. 클라우드 세션에서 팀이 도달할 수 있는 저장소를 제한하려면 GitHub 자체에서 액세스를 제한하세요. 예를 들어 연결된 GitHub 계정의 팀 또는 저장소 멤버십을 제한하면 됩니다.43 두 방법 모두에서 클라우드 세션은 Claude GitHub App이 설치된 저장소뿐만 아니라 연결된 GitHub 계정이 볼 수 있는 모든 저장소에 액세스할 수 있습니다. App 설치는 [자동 수정](#auto-fix-pull-requests)을 위한 PR 웹훅을 활성화합니다. 이는 세션 수준의 액세스 제어가 아닙니다. 클라우드 세션에서 팀이 도달할 수 있는 저장소를 제한하려면 GitHub 자체에서 액세스를 제한하세요. 예를 들어 연결된 GitHub 계정의 팀 또는 저장소 멤버십을 제한하면 됩니다.

44</Note>44</Note>

45 45

46두 방법 모두 작동합니다. [`/schedule`](/ko/routines)은 두 형태의 액세스를 확인하고 구성되지 않은 경우 `/web-setup`을 실행하라는 메시지를 표시합니다. `/web-setup` 안내는 [터미널에서 연결](/ko/web-quickstart#connect-from-your-terminal)을 참조하세요.46두 방법 모두 작동합니다. [`/schedule`](/docs/ko/routines)은 두 형태의 액세스를 확인하고 구성되지 않은 경우 `/web-setup`을 실행하라는 메시지를 표시합니다. `/web-setup` 안내는 [터미널에서 연결](/docs/ko/web-quickstart#connect-from-your-terminal)을 참조하세요.

47 47

48GitHub App은 App을 사용하여 PR 웹훅을 수신하는 [자동 수정](#auto-fix-pull-requests)에 필요합니다. `/web-setup`으로 연결했다가 나중에 자동 수정을 원하면 해당 저장소에 App을 설치하세요.48GitHub App은 App을 사용하여 PR 웹훅을 수신하는 [자동 수정](#auto-fix-pull-requests)에 필요합니다. `/web-setup`으로 연결했다가 나중에 자동 수정을 원하면 해당 저장소에 App을 설치하세요.

49 49

50Team 및 Enterprise 관리자는 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)의 Quick web setup 토글로 `/web-setup`을 비활성화할 수 있습니다.50Team 및 Enterprise 관리자는 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)의 Quick web setup 토글로 `/web-setup`을 비활성화할 수 있습니다.

51 51

52<Note>52<Note>

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

54</Note>54</Note>

55 55

56<h2 id="the-cloud-environment">56<h2 id="the-cloud-environment">

63 클라우드 세션에서 사용 가능한 것63 클라우드 세션에서 사용 가능한 것

64</h3>64</h3>

65 65

66클라우드 세션은 저장소의 새로운 복제본에서 시작됩니다. 저장소에 커밋된 모든 것이 사용 가능합니다. 자신의 머신에만 설치하거나 구성한 것은 사용할 수 없습니다. 조직의 정책은 [서버 관리 설정](/ko/server-managed-settings)을 통해 별도로 도착합니다.66클라우드 세션은 저장소의 새로운 복제본에서 시작됩니다. 저장소에 커밋된 모든 것이 사용 가능합니다. 자신의 머신에만 설치하거나 구성한 것은 사용할 수 없습니다. 조직의 정책은 [서버 관리 설정](/docs/ko/server-managed-settings)을 통해 별도로 도착합니다.

67 67

68| | 클라우드 세션에서 사용 가능 | 이유 |68| | 클라우드 세션에서 사용 가능 | 이유 |

69| :------------------------------------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |69| :------------------------------------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

72| 저장소의 `.mcp.json` MCP 서버 | 예 | 복제본의 일부 |72| 저장소의 `.mcp.json` MCP 서버 | 예 | 복제본의 일부 |

73| 저장소의 `.claude/rules/` | 예 | 복제본의 일부 |73| 저장소의 `.claude/rules/` | 예 | 복제본의 일부 |

74| 저장소의 `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | 예 | 복제본의 일부 |74| 저장소의 `.claude/skills/`, `.claude/agents/`, `.claude/commands/` | 예 | 복제본의 일부 |

75| `.claude/settings.json`에 선언된 플러그인 | 예 | 선언한 [마켓플레이스](/ko/plugin-marketplaces)에서 세션 시작 시 설치됩니다. 마켓플레이스 소스에 도달하려면 네트워크 액세스가 필요합니다 |75| `.claude/settings.json`에 선언된 플러그인 | 예 | 선언한 [마켓플레이스](/docs/ko/plugin-marketplaces)에서 세션 시작 시 설치됩니다. 마켓플레이스 소스에 도달하려면 네트워크 액세스가 필요합니다 |

76| 조직의 [서버 관리 설정](/ko/server-managed-settings) | 예 | 세션이 시작될 때 Anthropic의 서버에서 가져옵니다. 클라우드 세션에서 `availableModels`이 어떻게 적용되는지는 [표면 범위](/ko/model-config#surface-coverage)를 참조하세요. MDM 또는 관리 설정 파일을 통해 장치에 배포된 설정은 세션이 Anthropic 관리 VM에서 실행되므로 적용되지 않습니다 |76| 조직의 [서버 관리 설정](/docs/ko/server-managed-settings) | 예 | 세션이 시작될 때 Anthropic의 서버에서 가져옵니다. 클라우드 세션에서 `availableModels`이 어떻게 적용되는지는 [표면 범위](/docs/ko/model-config#surface-coverage)를 참조하세요. MDM 또는 관리 설정 파일을 통해 장치에 배포된 설정은 세션이 Anthropic 관리 VM에서 실행되므로 적용되지 않습니다 |

77| 사용자 `~/.claude/CLAUDE.md` | 아니오 | 저장소가 아닌 머신에 있습니다 |77| 사용자 `~/.claude/CLAUDE.md` | 아니오 | 저장소가 아닌 머신에 있습니다 |

78| 사용자 `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | 아니오 | 저장소가 아닌 머신에 있습니다. 대신 저장소의 `.claude/` 디렉토리에 커밋하세요. claude.ai에서 활성화한 Skills는 클라우드 세션에 자동으로 로드됩니다 |78| 사용자 `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` | 아니오 | 저장소가 아닌 머신에 있습니다. 대신 저장소의 `.claude/` 디렉토리에 커밋하세요. claude.ai에서 활성화한 Skills는 클라우드 세션에 자동으로 로드됩니다 |

79| 사용자 설정에서만 활성화된 플러그인 | 아니오 | 사용자 범위 `enabledPlugins`는 `~/.claude/settings.json`에 있습니다. 저장소의 `.claude/settings.json`에 선언하세요 |79| 사용자 설정에서만 활성화된 플러그인 | 아니오 | 사용자 범위 `enabledPlugins`는 `~/.claude/settings.json`에 있습니다. 저장소의 `.claude/settings.json`에 선언하세요 |

80| `claude mcp add`로 추가한 MCP 서버 | 아니오 | 저장소가 아닌 로컬 사용자 구성에 씁니다. [`.mcp.json`](/ko/mcp#project-scope)에 서버를 선언하세요 |80| `claude mcp add`로 추가한 MCP 서버 | 아니오 | 저장소가 아닌 로컬 사용자 구성에 씁니다. [`.mcp.json`](/docs/ko/mcp#project-scope)에 서버를 선언하세요 |

81| 정적 API 토큰 및 자격 증명 | 아니오 | 아직 전용 비밀 저장소가 없습니다. 아래를 참조하세요 |81| 정적 API 토큰 및 자격 증명 | 아니오 | 아직 전용 비밀 저장소가 없습니다. 아래를 참조하세요 |

82| AWS SSO와 같은 대화형 인증 | 아니오 | 지원되지 않습니다. SSO는 클라우드 세션에서 실행할 수 없는 브라우저 기반 로그인이 필요합니다 |82| AWS SSO와 같은 대화형 인증 | 아니오 | 지원되지 않습니다. SSO는 클라우드 세션에서 실행할 수 없는 브라우저 기반 로그인이 필요합니다 |

83 83

84클라우드 세션에서 구성을 사용 가능하게 하려면 저장소에 커밋하세요. 조직 정책은 [서버 관리 설정](/ko/server-managed-settings)을 통해 별도로 도착합니다.84클라우드 세션에서 구성을 사용 가능하게 하려면 저장소에 커밋하세요. 조직 정책은 [서버 관리 설정](/docs/ko/server-managed-settings)을 통해 별도로 도착합니다.

85 85

86전용 비밀 저장소는 아직 사용할 수 없습니다. 환경 변수와 설정 스크립트 모두 환경 구성에 저장되며, 해당 환경을 편집할 수 있는 모든 사람이 볼 수 있습니다. 클라우드 세션에서 비밀이 필요하면 이러한 가시성을 염두에 두고 환경 변수로 추가하세요.86전용 비밀 저장소는 아직 사용할 수 없습니다. 환경 변수와 설정 스크립트 모두 환경 구성에 저장되며, 해당 환경을 편집할 수 있는 모든 사람이 볼 수 있습니다. 클라우드 세션에서 비밀이 필요하면 이러한 가시성을 염두에 두고 환경 변수로 추가하세요.

87 87

140 140

141각 클라우드 세션에는 claude.ai의 트랜스크립트 URL이 있으며, 세션은 `CLAUDE_CODE_REMOTE_SESSION_ID` 환경 변수에서 자신의 ID를 읽을 수 있습니다. 이를 사용하여 PR 본문, 커밋 메시지, Slack 게시물 또는 생성된 보고서에 추적 가능한 링크를 넣어서 검토자가 이를 생성한 실행을 열 수 있습니다.141각 클라우드 세션에는 claude.ai의 트랜스크립트 URL이 있으며, 세션은 `CLAUDE_CODE_REMOTE_SESSION_ID` 환경 변수에서 자신의 ID를 읽을 수 있습니다. 이를 사용하여 PR 본문, 커밋 메시지, Slack 게시물 또는 생성된 보고서에 추적 가능한 링크를 넣어서 검토자가 이를 생성한 실행을 열 수 있습니다.

142 142

143v2.1.179부터 Claude가 웹 세션에서 생성하는 커밋에는 `Claude-Session: <url>` git 트레일러가 포함되며, PR 본문에는 세션 URL이 자체 줄에 포함됩니다. {/* min-version: 2.1.182 */}v2.1.182부터 [`attribution.sessionUrl`](/ko/settings#attribution-settings)을 `false`로 설정하여 트레일러와 PR 본문 링크를 생략할 수 있습니다.143v2.1.179부터 Claude가 웹 세션에서 생성하는 커밋에는 `Claude-Session: <url>` git 트레일러가 포함되며, PR 본문에는 세션 URL이 자체 줄에 포함됩니다. {/* min-version: 2.1.182 */}v2.1.182부터 [`attribution.sessionUrl`](/docs/ko/settings#attribution-settings)을 `false`로 설정하여 트레일러와 PR 본문 링크를 생략할 수 있습니다.

144 144

145커밋이나 PR이 아닌 다른 것(예: Claude가 게시하는 Slack 메시지 또는 작성하는 보고서 파일)에 세션 링크를 포함하려면 Claude에 다음 명령을 실행하도록 하고 출력을 사용하세요. 이 명령은 환경 변수의 값에서 `cse_` 접두사를 트랜스크립트 URL이 예상하는 `session_` 접두사로 변환합니다:145커밋이나 PR이 아닌 다른 것(예: Claude가 게시하는 Slack 메시지 또는 작성하는 보고서 파일)에 세션 링크를 포함하려면 Claude에 다음 명령을 실행하도록 하고 출력을 사용하세요. 이 명령은 환경 변수의 값에서 `cse_` 접두사를 트랜스크립트 URL이 예상하는 `session_` 접두사로 변환합니다:

146 146

180* 16 GB RAM180* 16 GB RAM

181* 30 GB 디스크181* 30 GB 디스크

182 182

183대규모 빌드 작업이나 메모리 집약적 테스트와 같이 훨씬 더 많은 메모리가 필요한 작업은 실패하거나 종료될 수 있습니다. 이러한 제한을 초과하는 워크로드의 경우 [Remote Control](/ko/remote-control)을 사용하여 자신의 하드웨어에서 Claude Code를 실행하세요.183대규모 빌드 작업이나 메모리 집약적 테스트와 같이 훨씬 더 많은 메모리가 필요한 작업은 실패하거나 종료될 수 있습니다. 이러한 제한을 초과하는 워크로드의 경우 [Remote Control](/docs/ko/remote-control)을 사용하여 자신의 하드웨어에서 Claude Code를 실행하세요.

184 184

185<h3 id="configure-your-environment">185<h3 id="configure-your-environment">

186 환경 구성186 환경 구성

216 216

217공유 환경의 값은 해당 환경의 모든 구성원의 세션에 도달합니다. 개인 환경과 마찬가지로 공유 환경에는 전용 비밀 저장소가 없으므로 비밀을 포함하지 마세요.217공유 환경의 값은 해당 환경의 모든 구성원의 세션에 도달합니다. 개인 환경과 마찬가지로 공유 환경에는 전용 비밀 저장소가 없으므로 비밀을 포함하지 마세요.

218 218

219자체 호스팅 러너 프로그램의 조직은 동일한 페이지에서 러너 풀도 관리합니다.

~~220~~

221<h2 id="setup-scripts">219<h2 id="setup-scripts">

222 설정 스크립트220 설정 스크립트

223</h2>221</h2>

259 설정 스크립트 vs. SessionStart hooks257 설정 스크립트 vs. SessionStart hooks

260</h3>258</h3>

261 259

262클라우드가 필요하지만 노트북에 이미 있는 것(예: 언어 런타임 또는 CLI 도구)을 설치하려면 설정 스크립트를 사용합니다. 클라우드 및 로컬 모두에서 실행되어야 하는 프로젝트 설정(예: `npm install`)의 경우 [SessionStart hook](/ko/hooks#sessionstart)을 사용합니다.260클라우드가 필요하지만 노트북에 이미 있는 것(예: 언어 런타임 또는 CLI 도구)을 설치하려면 설정 스크립트를 사용합니다. 클라우드 및 로컬 모두에서 실행되어야 하는 프로젝트 설정(예: `npm install`)의 경우 [SessionStart hook](/docs/ko/hooks#sessionstart)을 사용합니다.

263 261

264둘 다 세션 시작 시 실행되지만 다른 위치에 속합니다:262둘 다 세션 시작 시 실행되지만 다른 위치에 속합니다:

265 263

270| 실행 | Claude Code 시작 전, [캐시된 환경](#environment-caching)이 없을 때만 | Claude Code 시작 후, 재개된 세션을 포함한 모든 세션에서 |268| 실행 | Claude Code 시작 전, [캐시된 환경](#environment-caching)이 없을 때만 | Claude Code 시작 후, 재개된 세션을 포함한 모든 세션에서 |

271| 범위 | 클라우드 환경만 | 로컬 및 클라우드 모두 |269| 범위 | 클라우드 환경만 | 로컬 및 클라우드 모두 |

272 270

273SessionStart hooks는 로컬의 사용자 수준 `~/.claude/settings.json`에서도 정의할 수 있지만 사용자 수준 설정은 클라우드 세션으로 이월되지 않습니다. 클라우드에서는 저장소에서 그리고 조직의 [서버 관리 설정](/ko/server-managed-settings)에서 hooks가 제공됩니다.271SessionStart hooks는 로컬의 사용자 수준 `~/.claude/settings.json`에서도 정의할 수 있지만 사용자 수준 설정은 클라우드 세션으로 이월되지 않습니다. 클라우드에서는 저장소에서 그리고 조직의 [서버 관리 설정](/docs/ko/server-managed-settings)에서 hooks가 제공됩니다.

274 272

275<h3 id="install-dependencies-with-a-sessionstart-hook">273<h3 id="install-dependencies-with-a-sessionstart-hook">

276 SessionStart hook로 종속성 설치274 SessionStart hook로 종속성 설치

317* **프록시 호환성**: 모든 아웃바운드 트래픽은 [보안 프록시](#security-proxy)를 통과합니다. 일부 패키지 관리자는 이 프록시에서 제대로 작동하지 않습니다. Bun은 알려진 예입니다.315* **프록시 호환성**: 모든 아웃바운드 트래픽은 [보안 프록시](#security-proxy)를 통과합니다. 일부 패키지 관리자는 이 프록시에서 제대로 작동하지 않습니다. Bun은 알려진 예입니다.

318* **시작 지연 추가**: hooks는 세션이 시작되거나 재개될 때마다 실행됩니다. 설정 스크립트와 달리 [환경 캐싱](#environment-caching)의 이점을 얻지 못합니다. 재설치하기 전에 종속성이 이미 있는지 확인하여 설치 스크립트를 빠르게 유지하세요.316* **시작 지연 추가**: hooks는 세션이 시작되거나 재개될 때마다 실행됩니다. 설정 스크립트와 달리 [환경 캐싱](#environment-caching)의 이점을 얻지 못합니다. 재설치하기 전에 종속성이 이미 있는지 확인하여 설치 스크립트를 빠르게 유지하세요.

319 317

320후속 Bash 명령에 대한 환경 변수를 유지하려면 `$CLAUDE_ENV_FILE`의 파일에 쓰세요. 자세한 내용은 [SessionStart hooks](/ko/hooks#sessionstart)를 참조하세요.318후속 Bash 명령에 대한 환경 변수를 유지하려면 `$CLAUDE_ENV_FILE`의 파일에 쓰세요. 자세한 내용은 [SessionStart hooks](/docs/ko/hooks#sessionstart)를 참조하세요.

321 319

322기본 이미지를 자신의 Docker 이미지로 바꾸는 것은 아직 지원되지 않습니다. [제공된 이미지](#installed-tools) 위에 필요한 것을 설치하려면 설정 스크립트를 사용하거나, `docker compose`로 Claude와 함께 이미지를 컨테이너로 실행하세요.320기본 이미지를 자신의 Docker 이미지로 바꾸는 것은 아직 지원되지 않습니다. [제공된 이미지](#installed-tools) 위에 필요한 것을 설치하려면 설정 스크립트를 사용하거나, `docker compose`로 Claude와 함께 이미지를 컨테이너로 실행하세요.

323 321

327 325

328네트워크 액세스는 클라우드 환경에서 아웃바운드 연결을 제어합니다. 각 환경은 하나의 액세스 수준을 지정하며, 사용자 정의 허용 도메인으로 확장할 수 있습니다. 기본값은 **Trusted**이며, 패키지 레지스트리 및 기타 [허용 목록 도메인](#default-allowed-domains)을 허용합니다.326네트워크 액세스는 클라우드 환경에서 아웃바운드 연결을 제어합니다. 각 환경은 하나의 액세스 수준을 지정하며, 사용자 정의 허용 도메인으로 확장할 수 있습니다. 기본값은 **Trusted**이며, 패키지 레지스트리 및 기타 [허용 목록 도메인](#default-allowed-domains)을 허용합니다.

329 327

330환경의 네트워크 액세스를 변경하려면 [편집을 위해 열고](#configure-your-environment) 대화 상자에서 **Network access** 선택기를 사용하세요. 별도의 Environments 페이지가 없습니다. 클라우드 세션을 시작하거나 [routine](/ko/routines#environments-and-network-access)을 구성할 때마다 클라우드 아이콘이 나타납니다.328환경의 네트워크 액세스를 변경하려면 [편집을 위해 열고](#configure-your-environment) 대화 상자에서 **Network access** 선택기를 사용하세요. 별도의 Environments 페이지가 없습니다. 클라우드 세션을 시작하거나 [routine](/docs/ko/routines#environments-and-network-access)을 구성할 때마다 클라우드 아이콘이 나타납니다.

331 329

332<Note>330<Note>

333 MCP 커넥터 트래픽은 Anthropic의 서버를 통해 라우팅되므로 세션 또는 routine에서 활성화한 커넥터는 **Allowed domains**에 해당 호스트를 추가하지 않고도 작동합니다. 커넥터는 세션별 또는 routine별로 구성됩니다. 필요하지 않은 것을 제거하여 Claude가 도달할 수 있는 도구를 제한하세요. 이는 [보안 및 격리](#security-and-isolation)에서 언급한 동일한 Anthropic 바운드 채널에 의존합니다.331 MCP 커넥터 트래픽은 Anthropic의 서버를 통해 라우팅되므로 세션 또는 routine에서 활성화한 커넥터는 **Allowed domains**에 해당 호스트를 추가하지 않고도 작동합니다. 커넥터는 세션별 또는 routine별로 구성됩니다. 필요하지 않은 것을 제거하여 Claude가 도달할 수 있는 도구를 제한하세요. 이는 [보안 및 격리](#security-and-isolation)에서 언급한 동일한 Anthropic 바운드 채널에 의존합니다.

362 360

363와일드카드 하위 도메인 일치를 위해 `*.`를 사용하세요. **Also include default list of common package managers**를 확인하여 [Trusted 도메인](#default-allowed-domains)을 사용자 정의 항목과 함께 유지하거나, 나열한 것만 허용하려면 선택 해제하세요.361와일드카드 하위 도메인 일치를 위해 `*.`를 사용하세요. **Also include default list of common package managers**를 확인하여 [Trusted 도메인](#default-allowed-domains)을 사용자 정의 항목과 함께 유지하거나, 나열한 것만 허용하려면 선택 해제하세요.

364 362

365허용 도메인은 환경별로 구성됩니다. 소유자가 모든 사용자의 환경에 푸시할 수 있는 조직 수준의 허용 목록은 없습니다. [서버 관리 설정](/ko/server-managed-settings)은 클라우드 세션을 제한할 수 있지만 허용 도메인을 추가할 수 없습니다.363허용 도메인은 환경별로 구성됩니다. 소유자가 모든 사용자의 환경에 푸시할 수 있는 조직 수준의 허용 목록은 없습니다. [서버 관리 설정](/docs/ko/server-managed-settings)은 클라우드 세션을 제한할 수 있지만 허용 도메인을 추가할 수 없습니다.

366 364

367<h3 id="github-proxy">365<h3 id="github-proxy">

368 GitHub 프록시366 GitHub 프록시

653 웹과 터미널 간에 작업 이동651 웹과 터미널 간에 작업 이동

654</h2>652</h2>

655 653

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

657 655

658<Note>656<Note>

659 CLI에서 세션 핸드오프는 일방향입니다: `--teleport`로 클라우드 세션을 터미널로 가져올 수 있지만 기존 터미널 세션을 웹으로 푸시할 수 없습니다. `--cloud` 플래그는 현재 저장소에 대한 새로운 클라우드 세션을 생성합니다. [Desktop 앱](/ko/desktop#continue-in-another-surface)은 로컬 세션을 웹으로 보낼 수 있는 Continue in 메뉴를 제공합니다.657 CLI에서 세션 핸드오프는 일방향입니다: `--teleport`로 클라우드 세션을 터미널로 가져올 수 있지만 기존 터미널 세션을 웹으로 푸시할 수 없습니다. `--cloud` 플래그는 현재 저장소에 대한 새로운 클라우드 세션을 생성합니다. [Desktop 앱](/docs/ko/desktop#continue-in-another-surface)은 로컬 세션을 웹으로 보낼 수 있는 Continue in 메뉴를 제공합니다.

660</Note>658</Note>

661 659

662<h3 id="from-terminal-to-web">660<h3 id="from-terminal-to-web">

674{/* min-version: 2.1.195 */}v2.1.195부터 CLI는 저장소 복제 및 [설정 스크립트](#setup-scripts) 실행과 같은 설정 단계의 라이브 체크리스트를 표시하며, 클라우드 컨테이너가 시작됩니다. 컨테이너가 프로비저닝되는 동안 입력한 메시지는 큐에 저장되었다가 세션이 준비되면 전송됩니다.672{/* min-version: 2.1.195 */}v2.1.195부터 CLI는 저장소 복제 및 [설정 스크립트](#setup-scripts) 실행과 같은 설정 단계의 라이브 체크리스트를 표시하며, 클라우드 컨테이너가 시작됩니다. 컨테이너가 프로비저닝되는 동안 입력한 메시지는 큐에 저장되었다가 세션이 준비되면 전송됩니다.

675 673

676<Note>674<Note>

677 `--cloud`는 클라우드 세션을 생성합니다. `--remote-control`은 관련이 없습니다: 로컬 CLI 세션을 노출하여 웹에서 모니터링할 수 있습니다. [Remote Control](/ko/remote-control)을 참조하세요.675 `--cloud`는 클라우드 세션을 생성합니다. `--remote-control`은 관련이 없습니다: 로컬 CLI 세션을 노출하여 웹에서 모니터링할 수 있습니다. [Remote Control](/docs/ko/remote-control)을 참조하세요.

678</Note>676</Note>

679 677

680Claude Code CLI에서 `/tasks`를 사용하여 진행 상황을 확인하거나 claude.ai 또는 Claude 모바일 앱에서 세션을 열어 직접 상호 작용하세요. 여기서 Claude를 조종하고, 피드백을 제공하거나, 다른 대화처럼 질문에 답변할 수 있습니다.678Claude Code CLI에서 `/tasks`를 사용하여 진행 상황을 확인하거나 claude.ai 또는 Claude 모바일 앱에서 세션을 열어 직접 상호 작용하세요. 여기서 Claude를 조종하고, 피드백을 제공하거나, 다른 대화처럼 질문에 답변할 수 있습니다.

697 695

698이 패턴은 Claude가 클라우드에서 자율적으로 실행되도록 하면서 전략에 대한 제어를 제공합니다.696이 패턴은 Claude가 클라우드에서 자율적으로 실행되도록 하면서 전략에 대한 제어를 제공합니다.

699 697

700**ultraplan으로 클라우드에서 계획**: 웹 세션 자체에서 계획을 작성하고 검토하려면 [ultraplan](/ko/ultraplan)을 사용하세요. Claude는 웹에서 Claude Code on the web에서 계획을 생성하는 동안 계속 작업하고, 브라우저에서 섹션에 주석을 달고 원격으로 실행하거나 계획을 터미널로 다시 보낼 수 있습니다.698**ultraplan으로 클라우드에서 계획**: 웹 세션 자체에서 계획을 작성하고 검토하려면 [ultraplan](/docs/ko/ultraplan)을 사용하세요. Claude는 웹에서 Claude Code on the web에서 계획을 생성하는 동안 계속 작업하고, 브라우저에서 섹션에 주석을 달고 원격으로 실행하거나 계획을 터미널로 다시 보낼 수 있습니다.

701 699

702**작업을 병렬로 실행**: 각 `--cloud` 명령은 독립적으로 실행되는 자체 클라우드 세션을 생성합니다. 여러 작업을 시작할 수 있으며 모두 별도의 세션에서 동시에 실행됩니다:700**작업을 병렬로 실행**: 각 `--cloud` 명령은 독립적으로 실행되는 자체 클라우드 세션을 생성합니다. 여러 작업을 시작할 수 있으며 모두 별도의 세션에서 동시에 실행됩니다:

703 701

772 컨텍스트 관리770 컨텍스트 관리

773</h3>771</h3>

774 772

775클라우드 세션은 텍스트 출력을 생성하는 [기본 제공 명령](/ko/commands)을 지원합니다. `/plugin` 또는 `/resume`과 같이 터미널 인터페이스에서만 실행되는 명령은 사용할 수 없습니다. 터미널에서 선택기 또는 패널을 열어야 하는 명령은 클라우드 세션에서 다르게 작동합니다:773클라우드 세션은 텍스트 출력을 생성하는 [기본 제공 명령](/docs/ko/commands)을 지원합니다. `/plugin` 또는 `/resume`과 같이 터미널 인터페이스에서만 실행되는 명령은 사용할 수 없습니다. 터미널에서 선택기 또는 패널을 열어야 하는 명령은 클라우드 세션에서 다르게 작동합니다:

776 774

777* {/* min-version: 2.1.205 */}**`/model`, `/effort`, `/fast`, `/color`, `/rename`**: 터미널 선택기 또는 슬라이더를 열지 않고 대신 인수로 값을 전달합니다(예: `/model sonnet`). 인수 형식은 세션의 환경에서 Claude Code v2.1.205 이상이 필요하며 각 명령의 [가용성 참고 사항](/ko/commands#all-commands)을 따릅니다: `/effort`는 모델의 [launch-default effort hold](/ko/model-config#adjust-effort-level)가 적용 중일 때 `Not applied`를 보고하고, `/fast`는 빠른 모드가 켜진 상태로 시작된 세션에서만 작동합니다.775* {/* min-version: 2.1.205 */}**`/model`, `/effort`, `/fast`, `/color`, `/rename`**: 터미널 선택기 또는 슬라이더를 열지 않고 대신 인수로 값을 전달합니다(예: `/model sonnet`). 인수 형식은 세션의 환경에서 Claude Code v2.1.205 이상이 필요하며 각 명령의 [가용성 참고 사항](/docs/ko/commands#all-commands)을 따릅니다: `/effort`는 모델의 [launch-default effort hold](/docs/ko/model-config#adjust-effort-level)가 적용 중일 때 `Not applied`를 보고하고, `/fast`는 빠른 모드가 켜진 상태로 시작된 세션에서만 작동합니다.

778* **`/config`**: 웹에서는 값을 설정하는 대신 Claude Code 설정 섹션을 열며, `key=value`를 포함한 명령 뒤의 텍스트는 무시됩니다. 클라우드 세션의 설정을 변경하려면 [환경 변수](#configure-your-environment)를 사용하거나 [설정 파일](/ko/settings)을 저장소에 커밋하세요.776* **`/config`**: 웹에서는 값을 설정하는 대신 Claude Code 설정 섹션을 열며, `key=value`를 포함한 명령 뒤의 텍스트는 무시됩니다. 클라우드 세션의 설정을 변경하려면 [환경 변수](#configure-your-environment)를 사용하거나 [설정 파일](/docs/ko/settings)을 저장소에 커밋하세요.

779 777

780컨텍스트 관리 특히:778컨텍스트 관리 특히:

781 779

785| `/context` | 예 | 현재 컨텍스트 윈도우에 있는 것을 표시합니다 |783| `/context` | 예 | 현재 컨텍스트 윈도우에 있는 것을 표시합니다 |

786| `/clear` | 아니오 | 사이드바에서 새 세션을 시작하세요 |784| `/clear` | 아니오 | 사이드바에서 새 세션을 시작하세요 |

787 785

788자동 압축은 컨텍스트 윈도우가 용량에 접근할 때 자동으로 실행됩니다. 더 일찍 트리거하려면 [환경 변수](#configure-your-environment)에서 [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/ko/env-vars)를 설정하세요. 예를 들어 `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70`은 윈도우가 거의 가득 찰 때까지 기다리는 대신 70% 용량에서 압축합니다. 압축 계산을 위한 유효 윈도우 크기를 변경하려면 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/ko/env-vars)를 사용하세요.786자동 압축은 컨텍스트 윈도우가 용량에 접근할 때 자동으로 실행됩니다. 더 일찍 트리거하려면 [환경 변수](#configure-your-environment)에서 [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ko/env-vars)를 설정하세요. 예를 들어 `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70`은 윈도우가 거의 가득 찰 때까지 기다리는 대신 70% 용량에서 압축합니다. 압축 계산을 위한 유효 윈도우 크기를 변경하려면 [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ko/env-vars)를 사용하세요.

789 787

790[Subagents](/ko/sub-agents)는 로컬과 동일한 방식으로 작동합니다. Claude는 Task 도구로 이들을 생성하여 연구 또는 병렬 작업을 별도의 컨텍스트 윈도우로 오프로드하여 주 대화를 더 가볍게 유지할 수 있습니다. 저장소의 `.claude/agents/`에 정의된 Subagents는 자동으로 선택됩니다.788[Subagents](/docs/ko/sub-agents)는 로컬과 동일한 방식으로 작동합니다. Claude는 Task 도구로 이들을 생성하여 연구 또는 병렬 작업을 별도의 컨텍스트 윈도우로 오프로드하여 주 대화를 더 가볍게 유지할 수 있습니다. 저장소의 `.claude/agents/`에 정의된 Subagents는 자동으로 선택됩니다.

791 789

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

793 791

794<h3 id="review-changes">792<h3 id="review-changes">

795 변경 사항 검토793 변경 사항 검토

796</h3>794</h3>

797 795

798각 세션은 추가 및 제거된 줄을 표시하는 diff 표시기를 표시합니다(예: `+42 -18`). 이를 선택하여 diff 보기를 열고, 특정 줄에 인라인 주석을 남기고, 다음 메시지로 Claude에 보내세요. 전체 안내는 PR 생성을 포함하여 [검토 및 반복](/ko/web-quickstart#review-and-iterate)을 참조하세요. Claude가 PR을 모니터링하여 CI 실패 및 검토 주석에 자동으로 응답하도록 하려면 [Pull request 자동 수정](#auto-fix-pull-requests)을 참조하세요.796각 세션은 추가 및 제거된 줄을 표시하는 diff 표시기를 표시합니다(예: `+42 -18`). 이를 선택하여 diff 보기를 열고, 특정 줄에 인라인 주석을 남기고, 다음 메시지로 Claude에 보내세요. 전체 안내는 PR 생성을 포함하여 [검토 및 반복](/docs/ko/web-quickstart#review-and-iterate)을 참조하세요. Claude가 PR을 모니터링하여 CI 실패 및 검토 주석에 자동으로 응답하도록 하려면 [Pull request 자동 수정](#auto-fix-pull-requests)을 참조하세요.

799 797

800<h3 id="share-sessions">798<h3 id="share-sessions">

801 세션 공유799 세션 공유

807 Enterprise 또는 Team 계정에서 공유805 Enterprise 또는 Team 계정에서 공유

808</h4>806</h4>

809 807

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

811 809

812저장소 액세스 확인은 기본적으로 수신자의 계정에 연결된 GitHub 계정을 기반으로 활성화됩니다. 계정의 표시 이름은 액세스 권한이 있는 모든 수신자에게 표시됩니다.810저장소 액세스 확인은 기본적으로 수신자의 계정에 연결된 GitHub 계정을 기반으로 활성화됩니다. 계정의 표시 이름은 액세스 권한이 있는 모든 수신자에게 표시됩니다.

813 811

847Claude는 pull request를 감시하고 CI 실패 및 검토 주석에 자동으로 응답할 수 있습니다. Claude는 PR의 GitHub 활동을 구독하고, 검사가 실패하거나 검토자가 주석을 남기면 Claude가 조사하고 명확한 수정이 있으면 푸시합니다.845Claude는 pull request를 감시하고 CI 실패 및 검토 주석에 자동으로 응답할 수 있습니다. Claude는 PR의 GitHub 활동을 구독하고, 검사가 실패하거나 검토자가 주석을 남기면 Claude가 조사하고 명확한 수정이 있으면 푸시합니다.

848 846

849<Note>847<Note>

850 자동 수정을 위해서는 Claude GitHub App이 저장소에 설치되어야 합니다. 아직 설치하지 않았으면 [GitHub App 페이지](https://github.com/apps/claude)에서 설치하거나 [설정](/ko/web-quickstart#connect-github-and-create-an-environment) 중에 메시지가 표시될 때 설치합니다.848 자동 수정을 위해서는 Claude GitHub App이 저장소에 설치되어야 합니다. 아직 설치하지 않았으면 [GitHub App 페이지](https://github.com/apps/claude)에서 설치하거나 [설정](/docs/ko/web-quickstart#connect-github-and-create-an-environment) 중에 메시지가 표시될 때 설치합니다.

851</Note>849</Note>

852 850

853PR이 어디에서 왔는지와 어떤 기기를 사용하는지에 따라 자동 수정을 켜는 방법은 몇 가지가 있습니다:851PR이 어디에서 왔는지와 어떤 기기를 사용하는지에 따라 자동 수정을 켜는 방법은 몇 가지가 있습니다:

854 852

855* **웹에서 Claude Code로 생성된 PR**: CI 상태 표시줄을 열고 **Auto-fix**를 선택합니다853* **웹에서 Claude Code로 생성된 PR**: CI 상태 표시줄을 열고 **Auto-fix**를 선택합니다

856* **터미널에서**: PR의 분기에 있는 동안 [`/autofix-pr`](/ko/commands)을 실행합니다. Claude Code가 `gh`로 열린 PR을 감지하고, 웹 세션을 생성하고, 한 단계에서 자동 수정을 켭니다854* **터미널에서**: PR의 분기에 있는 동안 [`/autofix-pr`](/docs/ko/commands)을 실행합니다. Claude Code가 `gh`로 열린 PR을 감지하고, 웹 세션을 생성하고, 한 단계에서 자동 수정을 켭니다

857* **모바일 앱에서**: Claude에 PR을 자동 수정하도록 지시합니다. 예를 들어 "watch this PR and fix any CI failures or review comments"855* **모바일 앱에서**: Claude에 PR을 자동 수정하도록 지시합니다. 예를 들어 "watch this PR and fix any CI failures or review comments"

858* **기존 PR**: PR URL을 세션에 붙여넣고 Claude에 자동 수정하도록 지시합니다856* **기존 PR**: PR URL을 세션에 붙여넣고 Claude에 자동 수정하도록 지시합니다

859 857

892 문제 해결890 문제 해결

893</h2>891</h2>

894 892

895런타임 API 오류(예: `API Error: 500`, `529 Overloaded`, `429` 또는 `Prompt is too long`)가 대화에 나타나면 [오류 참조](/ko/errors)를 참조하세요. 이러한 오류와 해결 방법은 CLI 및 Desktop 앱과 공유됩니다. 아래 섹션에서는 클라우드 세션에 특정한 문제를 다룹니다.893런타임 API 오류(예: `API Error: 500`, `529 Overloaded`, `429` 또는 `Prompt is too long`)가 대화에 나타나면 [오류 참조](/docs/ko/errors)를 참조하세요. 이러한 오류와 해결 방법은 CLI 및 Desktop 앱과 공유됩니다. 아래 섹션에서는 클라우드 세션에 특정한 문제를 다룹니다.

896 894

897<h3 id="session-creation-failed">895<h3 id="session-creation-failed">

898 세션 생성 실패896 세션 생성 실패

930 928

931* **속도 제한**: Claude Code on the web은 계정 내의 다른 모든 Claude 및 Claude Code 사용과 속도 제한을 공유합니다. 여러 작업을 병렬로 실행하면 비례적으로 더 많은 속도 제한을 소비합니다. 클라우드 VM에 대한 별도의 컴퓨팅 요금은 없습니다.929* **속도 제한**: Claude Code on the web은 계정 내의 다른 모든 Claude 및 Claude Code 사용과 속도 제한을 공유합니다. 여러 작업을 병렬로 실행하면 비례적으로 더 많은 속도 제한을 소비합니다. 클라우드 VM에 대한 별도의 컴퓨팅 요금은 없습니다.

932* **저장소 인증**: 웹에서 로컬로 세션을 이동할 때 동일한 계정으로 인증된 경우에만 가능합니다930* **저장소 인증**: 웹에서 로컬로 세션을 이동할 때 동일한 계정으로 인증된 경우에만 가능합니다

933* **플랫폼 제한**: 저장소 복제 및 pull request 생성에는 GitHub가 필요합니다. 자체 호스팅 [GitHub Enterprise Server](/ko/github-enterprise-server) 인스턴스는 Team 및 Enterprise 플랜에서 지원됩니다. GitLab, Bitbucket 및 기타 비 GitHub 저장소는 [로컬 번들](#send-local-repositories-without-github)로 클라우드 세션에 보낼 수 있지만 세션이 원격으로 결과를 다시 푸시할 수 없습니다931* **플랫폼 제한**: 저장소 복제 및 pull request 생성에는 GitHub가 필요합니다. 자체 호스팅 [GitHub Enterprise Server](/docs/ko/github-enterprise-server) 인스턴스는 Team 및 Enterprise 플랜에서 지원됩니다. GitLab, Bitbucket 및 기타 비 GitHub 저장소는 [로컬 번들](#send-local-repositories-without-github)로 클라우드 세션에 보낼 수 있지만 세션이 원격으로 결과를 다시 푸시할 수 없습니다

934* **조직 IP 허용 목록**: 클라우드 세션은 네트워크에서가 아닌 Anthropic 관리 인프라에서 Anthropic API를 호출합니다. 조직에 [IP 허용 목록](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)이 활성화되어 있으면 모든 클라우드 세션이 인증 오류로 실패합니다. 동일하게 [Code Review](/ko/code-review) 및 [Routines](/ko/routines)에 적용됩니다. [Anthropic 지원](https://support.claude.com/)에 문의하여 조직의 IP 허용 목록에서 Anthropic 호스팅 서비스를 제외하세요.932* **조직 IP 허용 목록**: 클라우드 세션은 네트워크에서가 아닌 Anthropic 관리 인프라에서 Anthropic API를 호출합니다. 조직에 [IP 허용 목록](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)이 활성화되어 있으면 모든 클라우드 세션이 인증 오류로 실패합니다. 동일하게 [Code Review](/docs/ko/code-review) 및 [Routines](/docs/ko/routines)에 적용됩니다. [Anthropic 지원](https://support.claude.com/)에 문의하여 조직의 IP 허용 목록에서 Anthropic 호스팅 서비스를 제외하세요.

935 933

936<h2 id="related-resources">934<h2 id="related-resources">

937 관련 리소스935 관련 리소스

938</h2>936</h2>

939 937

940* [Ultraplan](/ko/ultraplan): 클라우드 세션에서 계획을 작성하고 브라우저에서 검토합니다938* [Ultraplan](/docs/ko/ultraplan): 클라우드 세션에서 계획을 작성하고 브라우저에서 검토합니다

941* [Ultrareview](/ko/ultrareview): 클라우드 샌드박스에서 심층 다중 에이전트 코드 검토를 실행합니다939* [Ultrareview](/docs/ko/ultrareview): 클라우드 샌드박스에서 심층 다중 에이전트 코드 검토를 실행합니다

942* [Routines](/ko/routines): 일정에 따라, API 호출을 통해 또는 GitHub 이벤트에 응답하여 작업을 자동화합니다940* [Routines](/docs/ko/routines): 일정에 따라, API 호출을 통해 또는 GitHub 이벤트에 응답하여 작업을 자동화합니다

943* [Hooks 구성](/ko/hooks): 세션 수명 주기 이벤트에서 스크립트를 실행합니다941* [Hooks 구성](/docs/ko/hooks): 세션 수명 주기 이벤트에서 스크립트를 실행합니다

944* [설정 참조](/ko/settings): 모든 구성 옵션942* [설정 참조](/docs/ko/settings): 모든 구성 옵션

945* [보안](/ko/security): 격리 보장 및 데이터 처리943* [보안](/docs/ko/security): 격리 보장 및 데이터 처리

946* [데이터 사용](/ko/data-usage): Anthropic이 클라우드 세션에서 보유하는 것944* [데이터 사용](/docs/ko/data-usage): Anthropic이 클라우드 세션에서 보유하는 것

947* [Claude Tag](https://claude.com/docs/claude-tag/overview): 동일한 클라우드 환경에서 실행되는 조직 관리형 Slack의 @Claude945* [Claude Tag](https://claude.com/docs/claude-tag/overview): 동일한 클라우드 환경에서 실행되는 조직 관리형 Slack의 @Claude

Documentation 2026-07-23 23:57 UTC to 2026-07-24 23:01 UTC