10 웹의 Claude Code는 Pro, Max, Team 사용자와 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위한 연구 미리보기 상태입니다.10 웹의 Claude Code는 Pro, Max, Team 사용자와 프리미엄 시트 또는 Chat + Claude Code 시트가 있는 Enterprise 사용자를 위한 연구 미리보기 상태입니다.

11</Note>11</Note>

12 12 

13웹의 Claude Code는 사용자의 머신 대신 Anthropic 관리 클라우드 인프라에서 실행됩니다. [claude.ai/code](https://claude.ai/code)에서 브라우저 또는 Claude 모바일 앱을 통해 작업을 제출합니다.13웹의 Claude Code는 사용자의 머신 대신 기본적으로 Anthropic 관리 클라우드 인프라에서 실행됩니다. [claude.ai/code](https://claude.ai/code)에서 브라우저 또는 Claude 모바일 앱을 통해 작업을 제출합니다.

14 14 

15[시작하기](#connect-github-and-create-an-environment)를 위해 GitHub 저장소가 필요합니다. Claude는 이를 격리된 가상 머신으로 복제하고, 변경 사항을 만들고, 검토할 수 있도록 브랜치를 푸시합니다. 세션은 기기 간에 지속되므로, 노트북에서 시작한 작업을 나중에 휴대폰에서 검토할 수 있습니다.15[시작하기](#connect-github)를 위해 GitHub 저장소가 필요합니다. Claude는 이를 격리된 가상 머신으로 복제하고, 변경 사항을 만들고, 검토할 수 있도록 브랜치를 푸시합니다. 세션은 기기 간에 지속되므로, 노트북에서 시작한 작업을 나중에 휴대폰에서 검토할 수 있습니다.

16 16 

17웹의 Claude Code는 다음에 적합합니다:17웹의 Claude Code는 다음에 적합합니다:

18 18 

27 세션이 실행되는 방식27 세션이 실행되는 방식

28</h2>28</h2>

29 29 

30작업을 제출할 때:30아래 단계는 Anthropic 호스팅 세션을 설명합니다. [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서는 복제 및 그 이후의 모든 작업이 조직의 자체 러너에서 실행되며, 네트워크 경계, 설정 및 푸시 동작은 운영자가 구성합니다. 작업을 제출할 때:

31 31 

321. **복제 및 준비**: 저장소가 Anthropic 관리 VM으로 복제되고, 구성된 경우 [설정 스크립트](/docs/ko/claude-code-on-the-web#setup-scripts)가 실행됩니다.321. **복제 및 준비**: 저장소가 Anthropic 관리 VM으로 복제되고, 구성된 경우 [설정 스크립트](/docs/ko/cloud-environments#setup-scripts)가 실행됩니다.

332. **네트워크 구성**: 인터넷 접근은 환경의 [접근 수준](/docs/ko/claude-code-on-the-web#access-levels)에 따라 설정됩니다.332. **네트워크 구성**: 인터넷 접근은 환경의 [접근 수준](/docs/ko/cloud-environments#access-levels)에 따라 설정됩니다.

343. **작업**: Claude는 코드를 분석하고, 변경 사항을 만들고, 테스트를 실행하고, 작업을 확인합니다. 전체 과정을 지켜보고 조정할 수 있거나, 물러나 있다가 완료되면 돌아올 수 있습니다.343. **작업**: Claude는 코드를 분석하고, 변경 사항을 만들고, 테스트를 실행하고, 작업을 확인합니다. 전체 과정을 지켜보고 조정할 수 있거나, 물러나 있다가 완료되면 돌아올 수 있습니다.

354. **브랜치 푸시**: Claude가 중지점에 도달하면, 브랜치를 GitHub로 푸시합니다. 차이를 검토하고, 인라인 댓글을 남기고, PR을 생성하거나, 계속 진행하도록 다른 메시지를 보냅니다.354. **브랜치 푸시**: Claude가 중지점에 도달하면, 브랜치를 GitHub로 푸시합니다. 차이를 검토하고, 인라인 댓글을 남기고, PR을 생성하거나, 계속 진행하도록 다른 메시지를 보냅니다.

36 36 

44 44 

45| | 웹에서 | Remote Control | Terminal CLI | Desktop 앱 |45| | 웹에서 | Remote Control | Terminal CLI | Desktop 앱 |

46| :-------------------------------- | :------------------------------------------------------------------------------------------------- | :----------------- | :----------- | :--------------------- |46| :-------------------------------- | :------------------------------------------------------------------------------------------------- | :----------------- | :----------- | :--------------------- |

47| **코드 실행 위치** | Anthropic 클라우드 VM | 사용자의 머신 | 사용자의 머신 | 사용자의 머신 또는 클라우드 VM |47| **코드 실행 위치** | 기본적으로 Anthropic에서 관리하는 클라우드 VM | 사용자의 머신 | 사용자의 머신 | 사용자의 머신 또는 클라우드 VM |

48| **채팅 위치** | claude.ai 또는 모바일 앱 | claude.ai 또는 모바일 앱 | 터미널 | Desktop UI |48| **채팅 위치** | claude.ai 또는 모바일 앱 | claude.ai 또는 모바일 앱 | 터미널 | Desktop UI |

49| **로컬 구성 사용** | 아니오, 저장소만 | 예 | 예 | 로컬의 경우 예, 클라우드의 경우 아니오 |49| **로컬 구성 사용** | 아니오, 저장소만 | 예 | 예 | 로컬의 경우 예, 클라우드의 경우 아니오 |

50| **GitHub 필요** | 예, 또는 `--cloud`를 통해 [로컬 저장소 번들](/docs/ko/claude-code-on-the-web#send-local-repositories-without-github) | 아니오 | 아니오 | 클라우드 세션의 경우만 |50| **GitHub 필요** | 예, 또는 `--cloud`를 통해 [로컬 저장소 번들](/docs/ko/claude-code-on-the-web#send-local-repositories-without-github) | 아니오 | 아니오 | 클라우드 세션의 경우만 |

54 54 

55[터미널 빠른 시작](/docs/ko/quickstart), [Desktop 앱](/docs/ko/desktop) 또는 [Remote Control](/docs/ko/remote-control) 문서를 참조하여 설정합니다.55[터미널 빠른 시작](/docs/ko/quickstart), [Desktop 앱](/docs/ko/desktop) 또는 [Remote Control](/docs/ko/remote-control) 문서를 참조하여 설정합니다.

56 56 

57<h2 id="connect-github-and-create-an-environment">57<h2 id="connect-github">

58 GitHub 연결 및 환경 생성58 GitHub 연결

59</h2>59</h2>

60 60 

61설정은 일회성 프로세스입니다. 이미 GitHub CLI를 사용하는 경우, 브라우저 대신 [터미널에서 이를 수행](#connect-from-your-terminal)할 수 있습니다.61GitHub 연결은 일회성 단계입니다. 이미 GitHub CLI를 사용하는 경우, 브라우저 대신 [터미널에서 이를 수행](#connect-from-your-terminal)할 수 있습니다.

62 

63<Note>

64 Team 및 Enterprise 플랜에서 **GitHub로 로그인** 단계는 Claude 조직의 [Owner](/docs/ko/server-managed-settings#access-control)가 [**Admin settings > Connectors**](https://claude.ai/admin-settings/connectors)에서 GitHub 커넥터를 켠 후에만 작동합니다. 그때까지 해당 단계는 로그인 버튼 대신 "GitHub access is required for Claude Code on the web"을 표시합니다. 커넥터가 켜진 후 [claude.ai/code](https://claude.ai/code)를 다시 로드하고 첫 번째 단계부터 다시 시작합니다. [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code)의 [Quick web setup](/docs/ko/claude-code-on-the-web#github-authentication-options)이라는 두 번째 토글은 선택 사항입니다. 이를 켜면 `/web-setup`이 작동하고 온보딩이 멤버를 위한 환경을 생성합니다.

65</Note>

62 66 

63<Steps>67<Steps>

64 <Step title="claude.ai/code 방문">68 <Step title="Visit claude.ai/code">

65 [claude.ai/code](https://claude.ai/code)로 이동하고 Anthropic 계정으로 로그인합니다.69 [claude.ai/code](https://claude.ai/code)로 이동하고 claude.ai 계정으로 로그인합니다. macOS 또는 Windows에서 첫 번째 화면은 Claude Code 데스크톱 앱 및 Claude Code를 설치하는 다른 방법을 제공합니다. 브라우저에 머물러 있으려면 페이지 하단의 **Continue on web**을 클릭합니다.

66 </Step>70 </Step>

67 71 

68 <Step title="Claude GitHub 앱 설치">72 <Step title="Sign in with GitHub">

69 로그인 후, claude.ai/code는 GitHub를 연결하도록 요청합니다. 프롬프트를 따라 Claude GitHub 앱을 설치하고 저장소에 대한 접근을 허용합니다. 클라우드 세션은 기존 GitHub 저장소와 함께 작동하므로, 새 프로젝트를 시작하려면 먼저 [GitHub에서 빈 저장소를 생성](https://github.com/new)합니다.73 로그인한 후 claude.ai/code는 GitHub를 연결하도록 요청합니다. 프롬프트를 따르면 claude.ai/code가 GitHub의 인증 페이지로 이동합니다. 인증 요청을 승인하면 GitHub가 claude.ai/code로 돌아갑니다. 클라우드 세션은 기존 GitHub 저장소와 함께 작동하며 GitHub 계정이 볼 수 있는 모든 저장소에 도달할 수 있습니다. 새 프로젝트를 시작하려면 먼저 [GitHub에서 빈 저장소를 생성](https://github.com/new)합니다.

74 

75 Quick web setup이 꺼져 있을 때(Team 및 Enterprise 플랜에서 기본값), claude.ai/code는 Claude GitHub 앱을 저장소에 설치하도록 요청합니다(이미 설치된 경우 제외). [Auto-fix](/docs/ko/claude-code-on-the-web#auto-fix-pull-requests)를 원하면 설치합니다. Auto-fix는 Claude가 CI 실패에 응답하고 해당 저장소의 pull request에 대한 검토 의견에 응답할 수 있게 합니다. 그렇지 않으면 **Skip**을 클릭합니다. 어느 쪽이든 세션은 동일한 저장소에 도달할 수 있습니다.

70 </Step>76 </Step>

71 77 

72 <Step title="환경 생성">78 <Step title="Set up your Default environment">

73 GitHub를 연결한 후, 클라우드 환경을 생성하도록 요청받습니다. 환경은 세션 중에 Claude가 가진 네트워크 접근 권한과 새 세션이 생성될 때 실행되는 것을 제어합니다. 구성 없이 사용 가능한 것은 [설치된 도구](/docs/ko/claude-code-on-the-web#installed-tools)를 참조합니다.79 [cloud environment](/docs/ko/cloud-environments)는 세션 중에 Claude가 가진 네트워크 접근 권한과 세션이 시작될 때 실행되는 것을 제어하는 저장된 구성입니다. GitHub를 연결한 후 발생하는 일은 플랜에 따라 다릅니다:

74 80 

75 양식에는 다음 필드가 있습니다:81 * **Pro and Max**: 온보딩이 **Default**라는 환경을 생성합니다.

82 * **Team and Enterprise**: 온보딩이 **Create your first cloud environment** 양식을 표시합니다. 미리 채워진 이름과 네트워크 접근을 변경하지 않고 **Create & finish**를 클릭하여 **Default** 환경을 생성합니다. Owner가 [Quick web setup](/docs/ko/claude-code-on-the-web#github-authentication-options)을 켠 경우 온보딩이 대신 **Default**를 생성합니다.

76 83 

77 * **이름**: 표시 레이블입니다. 다양한 프로젝트 또는 접근 수준을 위해 여러 환경이 있을 때 유용합니다.84 **Default**는 [`Trusted` network access](/docs/ko/cloud-environments#access-levels)를 사용합니다: 세션은 [common package registries](/docs/ko/cloud-environments#default-allowed-domains) 및 기타 허용 목록에 있는 도메인에 도달하고 세션의 네트워크를 통해 다른 것에는 도달하지 않습니다. 구성 없이 사용 가능한 것은 [Installed tools](/docs/ko/cloud-environments#installed-tools)를 참조합니다.

78 * **네트워크 접근**: 세션이 인터넷에서 도달할 수 있는 것을 제어합니다. 기본값인 `Trusted`는 npm, PyPI, RubyGems와 같은 [일반적인 패키지 레지스트리](/docs/ko/claude-code-on-the-web#default-allowed-domains)에 대한 연결을 허용하면서 일반 인터넷 접근을 차단합니다.

79 * **환경 변수**: `.env` 형식의 모든 세션에서 사용 가능한 선택적 변수입니다. 따옴표가 값의 일부로 저장되므로 값을 따옴표로 감싸지 마십시오. 이 환경을 편집할 수 있는 모든 사람에게 표시됩니다.

80 * **설정 스크립트**: Claude Code가 시작되기 전에 실행되는 선택적 Bash 스크립트입니다. `apt install -y gh`와 같이 클라우드 VM에 포함되지 않은 시스템 도구를 설치하는 데 사용합니다. 결과는 [캐시됨](/docs/ko/claude-code-on-the-web#environment-caching)이므로, 스크립트는 매 세션마다 다시 실행되지 않습니다. 예제 및 디버깅 팁은 [설정 스크립트](/docs/ko/claude-code-on-the-web#setup-scripts)를 참조합니다.

81 85 

82 첫 번째 프로젝트의 경우, 기본값을 유지하고 **환경 생성**을 클릭합니다. 나중에 [편집하거나 다양한 프로젝트를 위해 추가 환경을 생성](/docs/ko/claude-code-on-the-web#configure-your-environment)할 수 있습니다.86 첫 번째 프로젝트의 경우 **Default** 환경이 그대로 작동합니다. 네트워크 접근을 변경하거나, 환경 변수를 추가하거나, 세션이 시작되기 전에 [setup script](/docs/ko/cloud-environments#setup-scripts)를 실행하려면 [이를 편집하거나 추가 환경을 생성](/docs/ko/cloud-environments#configure-your-environment)합니다.

83 </Step>87 </Step>

84</Steps>88</Steps>

85 89 

87 터미널에서 연결91 터미널에서 연결

88</h3>92</h3>

89 93 

90이미 GitHub CLI(`gh`)를 사용하는 경우, 브라우저를 열지 않고 웹에서 Claude Code를 설정할 수 있습니다. 이는 [Claude Code CLI](/docs/ko/quickstart)가 필요합니다. `/web-setup`은 로컬 `gh` 토큰을 읽고, Claude 계정에 연결하고, 아직 없는 경우 기본 클라우드 환경을 생성합니다.94이미 GitHub CLI(`gh`)를 사용하는 경우, 브라우저를 열지 않고 웹에서 Claude Code를 설정할 수 있습니다. 이는 [Claude Code CLI](/docs/ko/quickstart)가 필요합니다. `/web-setup`을 실행하면 Claude Code가 로컬 `gh` 토큰을 읽고, claude.ai 계정에 연결하고, 아직 없는 경우 **Default** 클라우드 환경을 생성합니다. Team 및 Enterprise 플랜에서 `/web-setup`은 Owner가 [Quick web setup](/docs/ko/claude-code-on-the-web#github-authentication-options)을 켠 후에만 사용 가능합니다.

91 95 

92<Note>96<Note>

93 [Zero Data Retention](/docs/ko/zero-data-retention)이 활성화된 조직은 `/web-setup` 또는 기타 클라우드 세션 기능을 사용할 수 없습니다. GitHub CLI가 설치되지 않았거나 인증되지 않은 경우, `/web-setup`은 브라우저 온보딩 흐름을 대신 엽니다.97 [Zero Data Retention](/docs/ko/zero-data-retention)이 활성화된 조직은 `/web-setup` 또는 기타 클라우드 세션 기능을 사용할 수 없습니다. GitHub CLI가 설치되지 않았거나 인증되지 않은 경우, Claude Code는 대신 브라우저 온보딩 흐름을 엽니다.

94</Note>98</Note>

95 99 

96<Steps>100<Steps>

102 ```106 ```

103 </Step>107 </Step>

104 108 

105 <Step title="Claude에 로그인">109 <Step title="Sign in to Claude">

106 Claude Code CLI에서 `/login`을 실행하여 claude.ai 계정으로 로그인합니다. 이미 로그인한 경우 이 단계를 건너뜁니다.110 Claude Code CLI에서 `/login`을 실행하여 claude.ai 계정으로 로그인합니다. 이미 claude.ai 계정으로 로그인한 경우 이 단계를 건너뜁니다. API 키로 인증하는 것은 계산되지 않습니다. 확인하려면 `/status`를 실행하고 **Login method** 행이 claude.ai 계정을 표시하는지 확인합니다.

107 </Step>111 </Step>

108 112 

109 <Step title="/web-setup 실행">113 <Step title="Run /web-setup">

110 Claude Code CLI에서 다음을 실행합니다:114 Claude Code CLI에서 다음을 실행합니다:

111 115 

112 ```text theme={null}116 ```text theme={null}

113 /web-setup117 /web-setup

114 ```118 ```

115 119 

116 이는 `gh` 토큰을 Claude 계정과 동기화합니다. 아직 클라우드 환경이 없는 경우, `/web-setup`은 Trusted 네트워크 접근 및 설정 스크립트 없이 환경을 생성합니다. 나중에 [환경을 편집하거나 변수를 추가](/docs/ko/claude-code-on-the-web#configure-your-environment)할 수 있습니다. `/web-setup`이 완료되면, 터미널에서 [`--cloud`](/docs/ko/claude-code-on-the-web#from-terminal-to-web)를 사용하여 클라우드 세션을 시작하거나 [`/schedule`](/docs/ko/routines)을 사용하여 반복 작업을 설정할 수 있습니다.120 이는 `gh` 토큰을 Claude 계정과 동기화합니다. 성공하면 Claude Code는 `Connected as <your-github-username>`을 출력하고 브라우저에서 [claude.ai/code](https://claude.ai/code)를 엽니다. 아직 클라우드 환경이 없는 경우, `/web-setup`은 Trusted 네트워크 접근 및 설정 스크립트 없이 환경을 생성합니다. 나중에 [환경을 편집하거나 변수를 추가](/docs/ko/cloud-environments#configure-your-environment)할 수 있습니다. `/web-setup`이 완료되면 터미널에서 [`--cloud`](/docs/ko/claude-code-on-the-web#from-terminal-to-web)를 사용하여 클라우드 세션을 시작하거나 [`/schedule`](/docs/ko/routines)을 사용하여 반복 작업을 설정할 수 있습니다.

117 </Step>121 </Step>

118</Steps>122</Steps>

119 123 

129 </Step>133 </Step>

130 134 

131 <Step title="권한 모드 선택">135 <Step title="권한 모드 선택">

132 입력 옆의 모드 드롭다운은 기본값으로 **편집 자동 수락**이며, Claude는 승인을 기다리지 않고 변경 사항을 만들고 브랜치를 푸시합니다. Claude가 접근 방식을 제안하고 파일을 편집하기 전에 승인을 기다리도록 하려면 **Plan Mode**로 전환합니다. 클라우드 세션은 Manual 또는 Bypass 권한을 제공하지 않습니다. 각 권한 모드가 허용하는 사항에 대해서는 [권한 모드의 전체 목록](/docs/ko/permission-modes#available-modes)을 참조합니다.136 입력 옆의 모드 드롭다운은 세션이 실행될 모드를 표시합니다:

137 

138 * **Auto**: 분류기가 사용자에게 묻는 대신 Claude의 작업을 검토합니다. 조직에서 자동 모드를 허용하고 선택한 모델이 이를 지원할 때 나타납니다

139 * **Accept edits**: Claude는 승인을 기다리지 않고 변경 사항을 만들고 브랜치를 푸시합니다

140 * **Plan**: Claude는 접근 방식을 제안하고 파일을 편집하기 전에 승인을 기다립니다

141 

142 클라우드 세션은 Manual 또는 Bypass 권한을 제공하지 않습니다. 각 권한 모드가 허용하는 사항에 대해서는 [권한 모드의 전체 목록](/docs/ko/permission-modes#available-modes)을 참조합니다.

133 </Step>143 </Step>

134 144 

135 <Step title="작업 설명 및 제출">145 <Step title="작업 설명 및 제출">

154| `prompt` | 입력 상자에 미리 채울 프롬프트 텍스트입니다. 별칭 `q`도 허용됩니다. |164| `prompt` | 입력 상자에 미리 채울 프롬프트 텍스트입니다. 별칭 `q`도 허용됩니다. |

155| `prompt_url` | 쿼리 문자열에 포함하기에 너무 긴 프롬프트 텍스트를 가져올 URL입니다. URL은 교차 출처 요청을 허용해야 합니다. `prompt`도 설정된 경우 무시됩니다. |165| `prompt_url` | 쿼리 문자열에 포함하기에 너무 긴 프롬프트 텍스트를 가져올 URL입니다. URL은 교차 출처 요청을 허용해야 합니다. `prompt`도 설정된 경우 무시됩니다. |

156| `repositories` | 미리 선택할 `owner/repo` 슬러그의 쉼표로 구분된 목록입니다. 별칭 `repo`도 허용됩니다. |166| `repositories` | 미리 선택할 `owner/repo` 슬러그의 쉼표로 구분된 목록입니다. 별칭 `repo`도 허용됩니다. |

157| `environment` | 미리 선택할 [환경](#connect-github-and-create-an-environment)의 이름 또는 ID입니다. |167| `environment` | 미리 선택할 [환경](#connect-github)의 이름 또는 ID입니다. |

158 168 

159각 값을 URL 인코딩합니다. 아래 예제는 프롬프트와 저장소가 이미 선택된 양식을 엽니다:169각 값을 URL 인코딩합니다. 아래 예제는 프롬프트와 저장소가 이미 선택된 양식을 엽니다:

160 170 

208 218 

209Enterprise 조직은 관리자가 웹에서 Claude Code를 활성화해야 할 수 있습니다. Anthropic 계정 팀에 문의합니다.219Enterprise 조직은 관리자가 웹에서 Claude Code를 활성화해야 할 수 있습니다. Anthropic 계정 팀에 문의합니다.

210 220 

211<h3 id="/web-setup-shows-no-commands-match-or-unknown-command">221<h3 id="/web-setup-says-not-signed-in-to-claude">

222 `/web-setup`이 "Not signed in to Claude"라고 표시됨

223</h3>

224 

225`/web-setup`이 "Not signed in to Claude. Run /login first."로 응답하면, CLI에 유효한 claude.ai 로그인이 없습니다. 이는 이전 로그인이 만료되었을 때도 발생할 수 있습니다. `/login`을 실행하고, claude.ai 계정으로 로그인한 다음, `/web-setup`을 다시 실행합니다.

226 

227<h3 id="/web-setup-warns-that-your-token-doesn’t-have-the-workflow-scope">

228 `/web-setup`이 토큰에 `workflow` 범위가 없다고 경고함

229</h3>

230 

231`/web-setup`이 GitHub CLI 토큰에 `workflow` 범위가 없다고 표시되면, 계속 진행할 수 있지만, GitHub는 해당 토큰으로 만든 일부 푸시를 거부할 수 있습니다. 예를 들어 GitHub Actions 워크플로우 파일을 변경하는 푸시 같은 경우입니다. 범위를 추가하려면, 셸에서 `gh auth refresh -s workflow`를 실행한 다음, `/web-setup`을 다시 실행합니다.

232 

233<h3 id="web-setup-shows-no-commands-match-or-unknown-command">

212 `/web-setup`이 "No commands match" 또는 "Unknown command"를 표시함234 `/web-setup`이 "No commands match" 또는 "Unknown command"를 표시함

213</h3>235</h3>

214 236 

216 238 

217Claude Code 내부에 입력했는데 명령 메뉴에 `No commands match "/web-setup"`이 표시되거나 제출하면 `Unknown command: /web-setup`이 반환되면, 요구 사항이 충족되지 않아 명령이 숨겨져 있습니다. 원인은 보통 API 키 또는 타사 공급자 대신 claude.ai 구독으로 인증되었기 때문입니다. `/login`을 실행하여 claude.ai 계정으로 로그인합니다.239Claude Code 내부에 입력했는데 명령 메뉴에 `No commands match "/web-setup"`이 표시되거나 제출하면 `Unknown command: /web-setup`이 반환되면, 요구 사항이 충족되지 않아 명령이 숨겨져 있습니다. 원인은 보통 API 키 또는 타사 공급자 대신 claude.ai 구독으로 인증되었기 때문입니다. `/login`을 실행하여 claude.ai 계정으로 로그인합니다.

218 240 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">241Team 및 Enterprise 플랜에서는 명령이 기본적으로 숨겨져 있습니다: [빠른 웹 설정 토글](/docs/ko/claude-code-on-the-web#github-authentication-options)은 관리자가 활성화할 때까지 꺼져 있습니다. 꺼져 있는 동안 [브라우저에서 GitHub 연결](#connect-github)합니다. 관리자가 조직에 대해 웹에서 Claude Code를 비활성화했거나, Enterprise 조직에 [Zero Data Retention](/docs/ko/zero-data-retention)이 활성화되어 있어 웹에서 Claude Code를 사용할 수 없을 때도 명령이 숨겨집니다.

220 `--cloud` 또는 ultraplan 사용 시 "클라우드 환경을 생성할 수 없음" 또는 "사용 가능한 클라우드 환경 없음"242 

243<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud">

244 `--cloud` 사용 시 "클라우드 환경을 생성할 수 없음" 또는 "사용 가능한 클라우드 환경 없음"

221</h3>245</h3>

222 246 

223원격 세션 기능은 아직 없는 경우 기본 클라우드 환경을 자동으로 생성합니다. "클라우드 환경을 생성할 수 없음"이 표시되면, 자동 생성이 실패했습니다. "사용 가능한 클라우드 환경 없음"이 표시되면, CLI가 자동 생성보다 앞서 있습니다. 어느 경우든, Claude Code CLI에서 `/web-setup`을 실행하여 수동으로 생성하거나, [claude.ai/code](https://claude.ai/code)를 방문하고 위의 **환경 생성** 단계를 따릅니다.247원격 세션 기능은 아직 없는 경우 기본 클라우드 환경을 자동으로 생성합니다. "클라우드 환경을 생성할 수 없음"이 표시되면, 자동 생성이 실패했습니다. "사용 가능한 클라우드 환경 없음"이 표시되면, CLI가 자동 생성보다 앞서 있습니다. 어느 경우든, Claude Code CLI에서 `/web-setup`을 실행하거나, [환경 선택기](/docs/ko/cloud-environments#configure-your-environment)에서 환경을 추가합니다. [claude.ai/code](https://claude.ai/code).

224 248 

225<h3 id="setup-script-failed">249<h3 id="setup-script-failed">

226 설정 스크립트 실패250 설정 스크립트 실패

228 252 

229설정 스크립트가 0이 아닌 상태로 종료되어 세션 시작을 차단합니다. 일반적인 원인:253설정 스크립트가 0이 아닌 상태로 종료되어 세션 시작을 차단합니다. 일반적인 원인:

230 254 

231* 레지스트리가 [네트워크 접근 수준](/docs/ko/claude-code-on-the-web#access-levels)에 없어서 패키지 설치가 실패했습니다. `Trusted`는 대부분의 패키지 관리자를 포함합니다. `None`은 모두 차단합니다.255* 레지스트리가 [네트워크 접근 수준](/docs/ko/cloud-environments#access-levels)에 없어서 패키지 설치가 실패했습니다. `Trusted`는 대부분의 패키지 관리자를 포함합니다. `None`은 모두 차단합니다.

232* 스크립트가 신선한 복제에 존재하지 않는 파일 또는 경로를 참조합니다.256* 스크립트가 신선한 복제에 존재하지 않는 파일 또는 경로를 참조합니다.

233* 로컬에서 작동하는 명령이 Ubuntu에서 다른 호출이 필요합니다.257* 로컬에서 작동하는 명령이 Ubuntu에서 다른 호출이 필요합니다.

234 258 

238 새 세션이 설정 중에 중단되거나 시간 초과됨262 새 세션이 설정 중에 중단되거나 시간 초과됨

239</h3>263</h3>

240 264 

241새 세션이 설정 스크립트 단계에서 정체되거나 스크립트가 완료되기 전에 일반 컨테이너 오류로 실패하면, 스크립트가 [환경 캐시](/docs/ko/claude-code-on-the-web#environment-caching) 구축을 위한 대략 5분의 시간 예산을 초과할 가능성이 높습니다. 큰 Docker 이미지 가져오기, 전체 종속성 트리 동기화 또는 모델 가중치 다운로드와 같은 무거운 단계는 특히 순차적으로 실행될 때 총합을 제한을 초과합니다.265새 세션이 설정 스크립트 단계에서 정체되거나 스크립트가 완료되기 전에 일반 컨테이너 오류로 실패하면, 스크립트가 [환경 캐시](/docs/ko/cloud-environments#environment-caching) 구축을 위한 대략 5분의 시간 예산을 초과할 가능성이 높습니다. 큰 Docker 이미지 가져오기, 전체 종속성 트리 동기화 또는 모델 가중치 다운로드와 같은 무거운 단계는 특히 순차적으로 실행될 때 총합을 제한을 초과합니다.

242 266 

243이를 해결하려면, 스크립트를 정리하여 5분 이내에 안정적으로 완료되도록 합니다:267이를 해결하려면, 스크립트를 정리하여 5분 이내에 안정적으로 완료되도록 합니다:

244 268 

245* `&`와 최종 `wait`를 사용하여 독립적인 설치를 병렬로 실행하는 대신 순차적으로 실행합니다.269* `&`와 최종 `wait`를 사용하여 독립적인 설치를 병렬로 실행하는 대신 순차적으로 실행합니다.

246* 가장 큰 다운로드를 설정 스크립트에서 [SessionStart hook](/docs/ko/claude-code-on-the-web#setup-scripts-vs-sessionstart-hooks)으로 이동하여 백그라운드에서 시작하도록 하여, 세션이 완료되는 동안 사용 가능해집니다.270* 가장 큰 다운로드를 설정 스크립트에서 [SessionStart hook](/docs/ko/cloud-environments#setup-scripts-vs-sessionstart-hooks)으로 이동하여 백그라운드에서 시작하도록 하여, 세션이 완료되는 동안 사용 가능해집니다.

247* 설정 스크립트에서 긴 재시도 대기를 제거합니다. 정체된 재시도 루프는 예산에 포함됩니다.271* 설정 스크립트에서 긴 재시도 대기를 제거합니다. 정체된 재시도 루프는 예산에 포함됩니다.

248 272 

249<h3 id="session-keeps-running-after-closing-the-tab">273<h3 id="session-keeps-running-after-closing-the-tab">

258 282 

259이제 작업을 제출하고 검토할 수 있으므로, 이 페이지들은 다음에 올 것을 다룹니다: 터미널에서 클라우드 세션 시작, 반복 작업 예약, Claude에게 상시 지침 제공.283이제 작업을 제출하고 검토할 수 있으므로, 이 페이지들은 다음에 올 것을 다룹니다: 터미널에서 클라우드 세션 시작, 반복 작업 예약, Claude에게 상시 지침 제공.

260 284 

261* [웹에서 Claude Code 사용](/docs/ko/claude-code-on-the-web): 터미널로 세션 텔레포트, 설정 스크립트, 환경 변수, 네트워크 구성을 포함한 전체 참조285* [웹에서 Claude Code 사용](/docs/ko/claude-code-on-the-web): 터미널로 세션 텔레포트, 세션 공유, 자동 풀 요청 수정을 포함한 전체 참조

286* [클라우드 환경 구성](/docs/ko/cloud-environments): 네트워크 액세스 수준, 환경 변수, 클라우드 세션용 설정 스크립트

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

263* [CLAUDE.md](/docs/ko/memory): 모든 세션의 시작 시 로드되는 지속적인 지침 및 컨텍스트를 Claude에게 제공합니다288* [CLAUDE.md](/docs/ko/memory): 모든 세션의 시작 시 로드되는 지속적인 지침 및 컨텍스트를 Claude에게 제공합니다

264* [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) 또는 [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude)용 Claude 모바일 앱을 설치하여 휴대폰에서 세션을 모니터링합니다. Claude Code CLI에서, `/mobile`은 QR 코드를 표시합니다.289* [iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) 또는 [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude)용 Claude 모바일 앱을 설치하여 휴대폰에서 세션을 모니터링합니다. Claude Code CLI에서, `/mobile`은 QR 코드를 표시합니다.