12 Claude Code에 로그인12 Claude Code에 로그인

13</h2>13</h2>

14 14 

15[Claude Code를 설치](/ko/setup#install-claude-code)한 후 터미널에서 `claude`를 실행합니다. 처음 실행할 때 Claude Code는 로그인할 수 있도록 브라우저 창을 엽니다.15[Claude Code를 설치](/docs/ko/setup#install-claude-code)한 후 터미널에서 `claude`를 실행합니다. 처음 실행할 때 Claude Code는 로그인할 수 있도록 브라우저 창을 엽니다.

16 16 

17브라우저가 자동으로 열리지 않으면 `c`를 눌러 로그인 URL을 클립보드에 복사한 후 브라우저에 붙여넣습니다.17브라우저가 자동으로 열리지 않으면 `c`를 눌러 로그인 URL을 클립보드에 복사한 후 브라우저에 붙여넣습니다.

18 18 

25* **Claude Pro 또는 Max 구독**: Claude.ai 계정으로 로그인합니다. [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max)에서 구독합니다.25* **Claude Pro 또는 Max 구독**: Claude.ai 계정으로 로그인합니다. [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max)에서 구독합니다.

26* **Claude for Teams 또는 Enterprise**: 팀 관리자가 초대한 Claude.ai 계정으로 로그인합니다.26* **Claude for Teams 또는 Enterprise**: 팀 관리자가 초대한 Claude.ai 계정으로 로그인합니다.

27* **Claude Console**: Console 자격증명으로 로그인합니다. 관리자가 먼저 [초대](#claude-console-authentication)해야 합니다.27* **Claude Console**: Console 자격증명으로 로그인합니다. 관리자가 먼저 [초대](#claude-console-authentication)해야 합니다.

28* **클라우드 제공자**: 조직에서 [Amazon Bedrock](/ko/amazon-bedrock), [Google Cloud의 Agent Platform](/ko/google-vertex-ai), 또는 [Microsoft Foundry](/ko/microsoft-foundry)를 사용하는 경우 `claude`를 실행하기 전에 필요한 환경 변수를 설정하거나 로그인 프롬프트에서 **3rd-party platform**을 선택합니다. 이는 Bedrock 및 Vertex AI에 대한 대화형 설정 마법사를 시작합니다. 브라우저 로그인이 필요하지 않습니다.28* **클라우드 제공자**: 조직에서 [Amazon Bedrock](/docs/ko/amazon-bedrock), [Google Cloud의 Agent Platform](/docs/ko/google-vertex-ai), 또는 [Microsoft Foundry](/docs/ko/microsoft-foundry)를 사용하는 경우 `claude`를 실행하기 전에 필요한 환경 변수를 설정하거나 로그인 프롬프트에서 **3rd-party platform**을 선택합니다. 이는 Bedrock 및 Vertex AI에 대한 대화형 설정 마법사를 시작합니다. 브라우저 로그인이 필요하지 않습니다.

29* **클라우드 게이트웨이**: 조직에서 자체 호스팅 [Claude 앱 게이트웨이](/ko/claude-apps-gateway)를 실행하는 경우 `/login`을 통해 회사 SSO로 로그인합니다. 게이트웨이에서 발급한 토큰이 세션의 유일한 자격증명입니다.29* **클라우드 게이트웨이**: 조직에서 자체 호스팅 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway)를 실행하는 경우 `/login`을 통해 회사 SSO로 로그인합니다. 게이트웨이에서 발급한 토큰이 세션의 유일한 자격증명입니다.

30 30 

31관리자는 [`forceLoginMethod` 및 `forceLoginOrgUUID`](/ko/settings#available-settings) 관리 설정으로 대화형 로그인을 제한할 수 있습니다. 둘 중 하나가 설정되면 `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, 또는 `apiKeyHelper`로 인증된 세션은 시작 시 차단됩니다. 클라우드 제공자 세션은 영향을 받지 않습니다.31관리자는 [`forceLoginMethod` 및 `forceLoginOrgUUID`](/docs/ko/settings#available-settings) 관리 설정으로 대화형 로그인을 제한할 수 있습니다. 둘 중 하나가 설정되면 `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, 또는 `apiKeyHelper`로 인증된 세션은 시작 시 차단됩니다. 클라우드 제공자 세션은 영향을 받지 않습니다.

32 32 

33Claude Code 프롬프트에서 `/logout`을 입력하여 로그아웃하고 다시 인증합니다. 로그아웃하면 첫 실행 설정 상태도 재설정되므로 다음에 `claude`를 실행할 때 로그인 및 설정을 다시 진행합니다.33Claude Code 프롬프트에서 `/logout`을 입력하여 로그아웃하고 다시 인증합니다. 로그아웃하면 첫 실행 설정 상태도 재설정되므로 다음에 `claude`를 실행할 때 로그인 및 설정을 다시 진행합니다.

34 34 

35로그인에 문제가 있으면 [인증 문제 해결](/ko/troubleshoot-install#login-and-authentication)을 참조합니다.35로그인에 문제가 있으면 [인증 문제 해결](/docs/ko/troubleshoot-install#login-and-authentication)을 참조합니다.

36 36 

37<h2 id="set-up-team-authentication">37<h2 id="set-up-team-authentication">

38 팀 인증 설정38 팀 인증 설정

42 42 

43* [Claude for Teams 또는 Enterprise](#claude-for-teams-or-enterprise), 대부분의 팀에 권장됨43* [Claude for Teams 또는 Enterprise](#claude-for-teams-or-enterprise), 대부분의 팀에 권장됨

44* [Claude Console](#claude-console-authentication)44* [Claude Console](#claude-console-authentication)

45* [Claude apps gateway](/ko/claude-apps-gateway), 개발자가 IdP로 로그인하고 구성한 클라우드 제공자로 추론을 라우팅하는 자체 호스팅 게이트웨이45* [Claude apps gateway](/docs/ko/claude-apps-gateway), 개발자가 IdP로 로그인하고 구성한 클라우드 제공자로 추론을 라우팅하는 자체 호스팅 게이트웨이

46* [Amazon Bedrock](/ko/amazon-bedrock)46* [Amazon Bedrock](/docs/ko/amazon-bedrock)

47* [Google Cloud's Agent Platform](/ko/google-vertex-ai)47* [Google Cloud's Agent Platform](/docs/ko/google-vertex-ai)

48* [Microsoft Foundry](/ko/microsoft-foundry)48* [Microsoft Foundry](/docs/ko/microsoft-foundry)

49 49 

50<h3 id="claude-for-teams-or-enterprise">50<h3 id="claude-for-teams-or-enterprise">

51 Claude for Teams 또는 Enterprise51 Claude for Teams 또는 Enterprise

99 초대된 각 사용자는 다음을 수행해야 합니다:99 초대된 각 사용자는 다음을 수행해야 합니다:

100 100 

101 * Console 초대 수락101 * Console 초대 수락

102 * [시스템 요구 사항 확인](/ko/setup#system-requirements)102 * [시스템 요구 사항 확인](/docs/ko/setup#system-requirements)

103 * [Claude Code 설치](/ko/setup#install-claude-code)103 * [Claude Code 설치](/docs/ko/setup#install-claude-code)

104 * Console 계정 자격증명으로 로그인104 * Console 계정 자격증명으로 로그인

105 </Step>105 </Step>

106</Steps>106</Steps>

113 113 

114<Steps>114<Steps>

115 <Step title="제공자 설정 따르기">115 <Step title="제공자 설정 따르기">

116 [Amazon Bedrock 문서](/ko/amazon-bedrock), [Google Cloud's Agent Platform 문서](/ko/google-vertex-ai), 또는 [Microsoft Foundry 문서](/ko/microsoft-foundry)를 따릅니다.116 [Amazon Bedrock 문서](/docs/ko/amazon-bedrock), [Google Cloud's Agent Platform 문서](/docs/ko/google-vertex-ai), 또는 [Microsoft Foundry 문서](/docs/ko/microsoft-foundry)를 따릅니다.

117 </Step>117 </Step>

118 118 

119 <Step title="구성 배포">119 <Step title="구성 배포">

120 환경 변수와 클라우드 자격증명 생성 지침을 사용자에게 배포합니다. [여기에서 구성을 관리하는 방법](/ko/settings)에 대해 자세히 알아봅니다.120 환경 변수와 클라우드 자격증명 생성 지침을 사용자에게 배포합니다. [여기에서 구성을 관리하는 방법](/docs/ko/settings)에 대해 자세히 알아봅니다.

121 </Step>121 </Step>

122 122 

123 <Step title="Claude Code 설치">123 <Step title="Claude Code 설치">

124 사용자는 [Claude Code를 설치](/ko/setup#install-claude-code)할 수 있습니다.124 사용자는 [Claude Code를 설치](/docs/ko/setup#install-claude-code)할 수 있습니다.

125 </Step>125 </Step>

126</Steps>126</Steps>

127 127 

136 * Linux에서 자격증명은 `~/.claude/.credentials.json`에 파일 모드 `0600`으로 저장됩니다.136 * Linux에서 자격증명은 `~/.claude/.credentials.json`에 파일 모드 `0600`으로 저장됩니다.

137 * Windows에서 자격증명은 `%USERPROFILE%\.claude\.credentials.json`에 저장되며 사용자 프로필 디렉터리의 액세스 제어를 상속하므로 기본적으로 파일이 사용자 계정으로 제한됩니다.137 * Windows에서 자격증명은 `%USERPROFILE%\.claude\.credentials.json`에 저장되며 사용자 프로필 디렉터리의 액세스 제어를 상속하므로 기본적으로 파일이 사용자 계정으로 제한됩니다.

138 * Linux 또는 Windows에서 `CLAUDE_CONFIG_DIR` 환경 변수를 설정한 경우 `.credentials.json` 파일은 해당 디렉터리 아래에 있습니다.138 * Linux 또는 Windows에서 `CLAUDE_CONFIG_DIR` 환경 변수를 설정한 경우 `.credentials.json` 파일은 해당 디렉터리 아래에 있습니다.

139 * Claude Code는 `/login` 및 `/logout`을 통해 `.credentials.json`을 관리합니다. 요청을 사용자 정의 API 엔드포인트를 통해 라우팅하려면 대신 [`ANTHROPIC_BASE_URL`](/ko/env-vars) 환경 변수를 설정합니다.139 * Claude Code는 `/login` 및 `/logout`을 통해 `.credentials.json`을 관리합니다. 요청을 사용자 정의 API 엔드포인트를 통해 라우팅하려면 대신 [`ANTHROPIC_BASE_URL`](/docs/ko/env-vars) 환경 변수를 설정합니다.

140* **지원되는 인증 유형**: Claude.ai 자격증명, Claude API 자격증명, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, 및 [Claude apps gateway](/ko/claude-apps-gateway) 세션 토큰.140* **지원되는 인증 유형**: Claude.ai 자격증명, Claude API 자격증명, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, 및 [Claude apps gateway](/docs/ko/claude-apps-gateway) 세션 토큰.

141* **사용자 정의 자격증명 스크립트**: [`apiKeyHelper`](/ko/settings#available-settings) 설정을 구성하여 API 키를 반환하는 셸 스크립트를 실행할 수 있습니다.141* **사용자 정의 자격증명 스크립트**: [`apiKeyHelper`](/docs/ko/settings#available-settings) 설정을 구성하여 API 키를 반환하는 셸 스크립트를 실행할 수 있습니다.

142* **새로고침 간격**: 기본적으로 `apiKeyHelper`는 5분 후 또는 HTTP 401 응답 시 호출됩니다. 사용자 정의 새로고침 간격을 위해 `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` 환경 변수를 설정합니다.142* **새로고침 간격**: 기본적으로 `apiKeyHelper`는 5분 후 또는 HTTP 401 응답 시 호출됩니다. 사용자 정의 새로고침 간격을 위해 `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` 환경 변수를 설정합니다.

143* **느린 도우미 알림**: `apiKeyHelper`가 키를 반환하는 데 10초 이상 걸리면 Claude Code는 경과 시간을 표시하는 프롬프트 표시줄에 경고 알림을 표시합니다. 이 알림이 정기적으로 표시되면 자격증명 스크립트를 최적화할 수 있는지 확인합니다.143* **느린 도우미 알림**: `apiKeyHelper`가 키를 반환하는 데 10초 이상 걸리면 Claude Code는 경과 시간을 표시하는 프롬프트 표시줄에 경고 알림을 표시합니다. 이 알림이 정기적으로 표시되면 자격증명 스크립트를 최적화할 수 있는지 확인합니다.

144* **도우미 실패**: {/* min-version: 2.1.208 */}스크립트가 오류로 종료되거나 시간 초과되거나 아무것도 인쇄하지 않으면 요청은 3회 시도 내에 [`Your apiKeyHelper script is failing`](/ko/errors#your-apikeyhelper-script-is-failing)으로 실패합니다. v2.1.208 이전에는 도우미 실패가 약 10번의 자동 재시도 후 일반 401로 표시되었습니다.144* **도우미 실패**: 스크립트가 오류로 종료되거나 시간 초과되거나 아무것도 인쇄하지 않으면 요청은 3회 시도 내에 [`Your apiKeyHelper script is failing`](/docs/ko/errors#your-apikeyhelper-script-is-failing)으로 실패합니다. v2.1.208 이전에는 도우미 실패가 약 10번의 자동 재시도 후 일반 401로 표시되었습니다.

145 145 

146`apiKeyHelper`, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`은 CLI 및 VS Code 확장 프로그램, Agent SDK, GitHub Actions를 포함하여 이를 래핑하는 표면에 적용됩니다. Claude Desktop 및 클라우드 세션은 `apiKeyHelper`를 호출하거나 이러한 환경 변수를 읽지 않습니다. 이들은 OAuth를 사용하며, [타사 추론 구성](/ko/llm-gateway-connect#desktop-app)을 실행하는 데스크톱 세션은 해당 구성의 자격증명으로 인증합니다.146`apiKeyHelper`, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`은 CLI 및 VS Code 확장 프로그램, Agent SDK, GitHub Actions를 포함하여 이를 래핑하는 표면에 적용됩니다. Claude Desktop 및 클라우드 세션은 `apiKeyHelper`를 호출하거나 이러한 환경 변수를 읽지 않습니다. 이들은 OAuth를 사용하며, [타사 추론 구성](/docs/ko/llm-gateway-connect#desktop-app)을 실행하는 데스크톱 세션은 해당 구성의 자격증명으로 인증합니다.

147 147 

148<h3 id="renew-an-expiring-login">148<h3 id="renew-an-expiring-login">

149 만료되는 로그인 갱신149 만료되는 로그인 갱신

153 153 

154`/login`을 실행하여 갱신합니다. 경고는 정보 제공용이며 요청을 차단하지 않습니다: 로그인이 실제로 만료될 때까지 인증이 계속 작동합니다. 로그인 수명 자체는 변경되지 않습니다. 사전 경고는 v2.1.203이 추가한 것입니다.154`/login`을 실행하여 갱신합니다. 경고는 정보 제공용이며 요청을 차단하지 않습니다: 로그인이 실제로 만료될 때까지 인증이 계속 작동합니다. 로그인 수명 자체는 변경되지 않습니다. 사전 경고는 v2.1.203이 추가한 것입니다.

155 155 

156{/* min-version: 2.1.206 */}저장된 로그인이 만료되고 새로고칠 수 없으면 다시 로그인할 때까지 각 요청은 [`Login expired · Please run /login`](/ko/errors#login-expired)으로 실패합니다. v2.1.206 이전에는 만료된 로그인이 모델 오류로 표시되었습니다.156저장된 로그인이 만료되고 새로고칠 수 없으면 다시 로그인할 때까지 각 요청은 [`Login expired · Please run /login`](/docs/ko/errors#login-expired)으로 실패합니다. v2.1.206 이전에는 만료된 로그인이 모델 오류로 표시되었습니다.

157 157 

158경고는 claude.ai 또는 Claude Console 로그인이 활성 자격증명일 때만 나타나며, 클라우드 제공자, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, 또는 `apiKeyHelper`가 자격증명을 제공할 때는 나타나지 않습니다.158경고는 claude.ai 또는 Claude Console 로그인이 활성 자격증명일 때만 나타나며, 클라우드 제공자, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, 또는 `apiKeyHelper`가 자격증명을 제공할 때는 나타나지 않습니다.

159 159 

160조기 갱신은 무인으로 실행되는 세션에 가장 중요합니다. [에이전트 보기의 백그라운드 세션](/ko/agent-view) 또는 로그인보다 오래 지속되는 [Remote Control](/ko/remote-control) 세션은 자격증명이 만료되면 진행을 멈추고 다시 로그인할 때까지 복구할 수 없습니다.160조기 갱신은 무인으로 실행되는 세션에 가장 중요합니다. [에이전트 보기의 백그라운드 세션](/docs/ko/agent-view) 또는 로그인보다 오래 지속되는 [Remote Control](/docs/ko/remote-control) 세션은 자격증명이 만료되면 진행을 멈추고 다시 로그인할 때까지 복구할 수 없습니다.

161 161 

162<h3 id="authentication-precedence">162<h3 id="authentication-precedence">

163 인증 우선순위163 인증 우선순위

165 165 

166여러 자격증명이 있을 때 Claude Code는 다음 순서로 선택합니다:166여러 자격증명이 있을 때 Claude Code는 다음 순서로 선택합니다:

167 167 

1681. `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, 또는 `CLAUDE_CODE_USE_FOUNDRY`가 설정된 경우 클라우드 제공자 자격증명. 설정은 [타사 통합](/ko/third-party-integrations)을 참조합니다.1681. `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, 또는 `CLAUDE_CODE_USE_FOUNDRY`가 설정된 경우 클라우드 제공자 자격증명. 설정은 [타사 통합](/docs/ko/third-party-integrations)을 참조합니다.

1692. `ANTHROPIC_AUTH_TOKEN` 환경 변수. `Authorization: Bearer` 헤더로 전송됩니다. Anthropic API 키 대신 베어러 토큰으로 인증하는 [LLM 게이트웨이 또는 프록시](/ko/llm-gateway)를 통해 라우팅할 때 사용합니다.1692. `ANTHROPIC_AUTH_TOKEN` 환경 변수. `Authorization: Bearer` 헤더로 전송됩니다. Anthropic API 키 대신 베어러 토큰으로 인증하는 [LLM 게이트웨이 또는 프록시](/docs/ko/llm-gateway)를 통해 라우팅할 때 사용합니다.

1703. `ANTHROPIC_API_KEY` 환경 변수. `X-Api-Key` 헤더로 전송됩니다. [Claude Console](https://platform.claude.com)의 키를 사용하여 Anthropic API에 직접 액세스할 때 사용합니다. 대화형 모드에서는 키를 승인하거나 거부하도록 한 번 프롬프트되며 선택이 기억됩니다. 나중에 변경하려면 `/config`의 "사용자 정의 API 키 사용" 토글을 사용합니다. 토글은 `ANTHROPIC_API_KEY`가 환경에 설정되어 있는 동안에만 나타납니다. 비대화형 모드(`-p`)에서는 키가 있을 때 항상 사용됩니다.1703. `ANTHROPIC_API_KEY` 환경 변수. `X-Api-Key` 헤더로 전송됩니다. [Claude Console](https://platform.claude.com)의 키를 사용하여 Anthropic API에 직접 액세스할 때 사용합니다. 대화형 모드에서는 키를 승인하거나 거부하도록 한 번 프롬프트되며 선택이 기억됩니다. 나중에 변경하려면 `/config`의 "사용자 정의 API 키 사용" 토글을 사용합니다. 토글은 `ANTHROPIC_API_KEY`가 환경에 설정되어 있는 동안에만 나타납니다. 비대화형 모드(`-p`)에서는 키가 있을 때 항상 사용됩니다.

1714. [`apiKeyHelper`](/ko/settings#available-settings) 스크립트 출력. 자격증명 모음에서 가져온 단기 토큰과 같은 동적 또는 회전 자격증명에 사용합니다.1714. [`apiKeyHelper`](/docs/ko/settings#available-settings) 스크립트 출력. 자격증명 모음에서 가져온 단기 토큰과 같은 동적 또는 회전 자격증명에 사용합니다.

1725. `CLAUDE_CODE_OAUTH_TOKEN` 환경 변수. [`claude setup-token`](#generate-a-long-lived-token)으로 생성된 장기 OAuth 토큰입니다. 브라우저 로그인을 사용할 수 없는 CI 파이프라인 및 스크립트에 사용합니다.1725. `CLAUDE_CODE_OAUTH_TOKEN` 환경 변수. [`claude setup-token`](#generate-a-long-lived-token)으로 생성된 장기 OAuth 토큰입니다. 브라우저 로그인을 사용할 수 없는 CI 파이프라인 및 스크립트에 사용합니다.

1736. `/login`의 구독 OAuth 자격증명. Claude Pro, Max, Team, Enterprise 사용자의 기본값입니다.1736. `/login`의 구독 OAuth 자격증명. Claude Pro, Max, Team, Enterprise 사용자의 기본값입니다.

174 174 

175활성 Claude 구독이 있지만 환경에 `ANTHROPIC_API_KEY`도 설정되어 있으면 승인된 후 API 키가 우선합니다. 키가 비활성화되거나 만료된 조직에 속하면 인증 실패가 발생할 수 있습니다. `unset ANTHROPIC_API_KEY`를 실행하여 구독으로 돌아가고 `/status`를 확인하여 활성 방법을 확인합니다.175활성 Claude 구독이 있지만 환경에 `ANTHROPIC_API_KEY`도 설정되어 있으면 승인된 후 API 키가 우선합니다. 키가 비활성화되거나 만료된 조직에 속하면 인증 실패가 발생할 수 있습니다. `unset ANTHROPIC_API_KEY`를 실행하여 구독으로 돌아가고 `/status`를 확인하여 활성 방법을 확인합니다.

176 176 

177[Claude apps gateway](/ko/claude-apps-gateway) 세션에 서명한 것은 이 목록 외에 있습니다: Amazon Bedrock 또는 Google Cloud의 Agent Platform과 같은 제공자 선택이며 이들보다 우선합니다. 게이트웨이 세션이 존재할 때 CLI는 `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, 또는 `CLAUDE_CODE_USE_FOUNDRY`가 설정되어 있어도 게이트웨이 토큰으로 인증하며, 위의 베어러 토큰, API 키, `apiKeyHelper` 항목은 사용되지 않습니다.177[Claude apps gateway](/docs/ko/claude-apps-gateway) 세션에 서명한 것은 이 목록 외에 있습니다: Amazon Bedrock 또는 Google Cloud의 Agent Platform과 같은 제공자 선택이며 이들보다 우선합니다. 게이트웨이 세션이 존재할 때 CLI는 `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, 또는 `CLAUDE_CODE_USE_FOUNDRY`가 설정되어 있어도 게이트웨이 토큰으로 인증하며, 위의 베어러 토큰, API 키, `apiKeyHelper` 항목은 사용되지 않습니다.

178 178 

179[Claude Code on the Web](/ko/claude-code-on-the-web)은 항상 구독 자격증명을 사용합니다. 샌드박스 환경에서 `ANTHROPIC_API_KEY` 또는 `ANTHROPIC_AUTH_TOKEN`을 설정하면 구독 자격증명을 재정의하지 않습니다.179[Claude Code on the Web](/docs/ko/claude-code-on-the-web)은 항상 구독 자격증명을 사용합니다. 샌드박스 환경에서 `ANTHROPIC_API_KEY` 또는 `ANTHROPIC_AUTH_TOKEN`을 설정하면 구독 자격증명을 재정의하지 않습니다.

180 180 

181<h3 id="generate-a-long-lived-token">181<h3 id="generate-a-long-lived-token">

182 장기 토큰 생성182 장기 토큰 생성

194export CLAUDE_CODE_OAUTH_TOKEN=your-token194export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```195```

196 196 

197이 토큰은 Claude 구독으로 인증하며 Pro, Max, Team 또는 Enterprise 플랜이 필요합니다. 추론만으로 범위가 지정되며 [Remote Control](/ko/remote-control) 세션을 설정할 수 없습니다.197이 토큰은 Claude 구독으로 인증하며 Pro, Max, Team 또는 Enterprise 플랜이 필요합니다. 추론만으로 범위가 지정되며 [Remote Control](/docs/ko/remote-control) 세션을 설정할 수 없습니다.

198 198 

199[Bare mode](/ko/headless#start-faster-with-bare-mode)는 `CLAUDE_CODE_OAUTH_TOKEN`을 읽지 않습니다. 스크립트가 `--bare`를 전달하면 `ANTHROPIC_API_KEY` 또는 `apiKeyHelper`로 인증합니다.199[Bare mode](/docs/ko/headless#start-faster-with-bare-mode)는 `CLAUDE_CODE_OAUTH_TOKEN`을 읽지 않습니다. 스크립트가 `--bare`를 전달하면 `ANTHROPIC_API_KEY` 또는 `apiKeyHelper`로 인증합니다.