개발자가 Claude Code CLI를 사용하는 경우, 데스크톱 앱과 별도로 설정하세요. 데스크톱 앱은 ANTHROPIC_BASE_URL 또는 settings.json이 아닌 Claude Desktop의 3P 구성에서 공급자 설정을 가져오며, 시작하는 Code 세션에 이를 전달합니다. CLI는 환경 변수, 설정 파일, Claude Code 관리 설정을 읽으며, 이는 별도의 정책 키를 사용합니다.
이 가이드는 Claude Enterprise 플랜을 사용하는 조직의 관리자를 위한 것입니다.
이 문서는 Claude Enterprise에서 클라우드 공급자의 Claude Desktop으로 이동의 일부이며, 여기서 wave, overlap period, cutoff date 용어를 정의합니다.
CLI와 로컬에서 실행되는 모든 것은 모든 공급자에서 작동합니다. 이동 후 개발자는 다르게 로그인하고, 정책이 컴퓨터에 다르게 도달하며, 일부 기능을 사용할 수 없습니다.
CLI를 공급자에 연결
Amazon Bedrock, Google Cloud, Microsoft Foundry, 또는 LLM 게이트웨이에 대한 공급자 변수를 설정하세요. 개발자는 claude.ai 브라우저 로그인이 필요하지 않습니다. 게이트웨이를 사용하면 기본 URL과 게이트웨이 자격증명을 모두 설정하세요. 기본 URL만 사용하면 저장된 claude.ai 로그인이 활성 자격증명으로 유지되므로 해당 제한 및 청구가 계속 적용됩니다. 팀 롤아웃 전에 모델 버전을 고정하세요.
각 기기에 정책 전달
서버 관리 설정은 적용되지 않습니다 타사 공급자 또는 사용자 정의 기본 URL이 설정된 경우. 이러한 정책을 기기의 관리 설정으로 이동하세요. managed-settings.json 파일, com.anthropic.claudecode macOS 프로필, 또는 HKLM\SOFTWARE\Policies\ClaudeCode 레지스트리 키로 전달할 수 있습니다. 이들은 사용자 및 프로젝트 설정보다 우선하지만, 낮은 수준의 더 엄격한 값이 여전히 적용되는 몇 가지 보안 관련 키는 예외입니다.
컴퓨터가 사용할 수 있는 공급자 제한:
allowedProviders를 설정하세요 (Claude Code v2.1.285 이상). 중복 기간 동안["anthropic", "bedrock"]과 같은 목록을 사용하면 개발자가 둘 다 사용할 수 있습니다. 이동 후 새 공급자만 나열하세요. Claude Desktop에서 claude.ai에 로그인한 상태를 유지하는 컴퓨터에는 “anthropic”을 유지하세요. 이것이 없으면 Cowork 세션이 거부되기 때문입니다.ANTHROPIC_BASE_URL을 통해 도달하는 게이트웨이의 경우"customEndpoint"를 나열하고 게이트웨이 URL을 동일한 관리 소스의env블록에 넣으세요.이전 로그인 설정 제거: 게이트웨이 자격증명을 사용하면
forceLoginMethod및forceLoginOrgUUID를 제거하세요. 두 키 모두 시작 시 게이트웨이 자격증명을 차단하기 때문입니다. 클라우드 공급자에서 이러한 키는 특정 자격증명이 여전히 컴퓨터에 있는 동안에만 세션을 차단합니다:ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKEN,apiKeyHelper자격증명, 또는 이전 Claude Console 로그인으로 저장된 API 키.
개발자는 /status를 실행하여 활성 공급자와 설정의 출처를 확인할 수 있습니다. 원격 측정, 네트워크 호스트, 업데이트에 대해서는 데이터 사용, 엔터프라이즈 네트워크 구성, 고급 설정을 참조하세요.
비용 및 사용량 추적
Bedrock, Google Cloud, Foundry에서 사용량은 클라우드 계정에 토큰당 청구되며 비용 제어는 클라우드 청구 콘솔에 있습니다. 게이트웨이를 통해 사용량은 게이트웨이가 전달하는 자격증명을 소유한 사람에게 토큰당 청구됩니다. claude.ai 분석 대시보드 및 Claude Code Analytics API는 이 사용량을 다루지 않습니다. 사용자별 보고의 경우 OpenTelemetry 또는 LLM 게이트웨이를 사용하세요.
개발자를 위해 유지되는 것
항목 | 이동 후 | 할 일 |
설정, | 유지됩니다. | 로그아웃하지 않는 한 없습니다 (아래 참조). 정리 중에 이 폴더를 제자리에 두세요. |
로컬 세션 기록 |
| 파일럿에서 세션 재개를 테스트하세요. Bedrock, Google Cloud, Foundry에서 세션의 이전 모델이 복원되지 않습니다. 게이트웨이의 업스트림이 이전 thinking 서명을 거부하면 Claude Code는 이전 thinking 블록을 삭제하고 다시 시도합니다. |
클라우드 세션 | Anthropic은 Claude 계정 아래에 저장합니다. Claude Code가 타사 공급자로 구성된 경우 | 이동 전에 필요한 각 세션을 |
claude.ai의 커넥터 | 타사 공급자가 활성화된 경우 로드되지 않습니다. | 사용자 또는 프로젝트 범위에서 MCP 서버로 추가하거나 관리 MCP 구성을 통해 배포하세요. Microsoft 365, Gmail, Google Calendar와 같은 일부 Anthropic 호스팅 커넥터는 직접 추가한 서버에서 로그인을 지원하지 않으므로 이러한 항목에 대해 다른 서버를 계획하세요. |
claude.ai에서 동기화된 스킬 | Bedrock, Google Cloud, Foundry의 세션에서 또는 게이트웨이 자격증명이 claude.ai 로그인을 대체할 때 스킬 동기화가 실행되지 않습니다. 이전에 동기화된 스킬은 | 의존하는 모든 스킬을 |
claude.ai에서 동기화된 플러그인 | Bedrock, Google Cloud, Foundry의 세션에서 다운로드되거나 로드되지 않습니다. 이는 이러한 세션이 Anthropic에서 기능 플래그를 가져오지 않기 때문입니다. | 마켓플레이스에서 다시 설치하세요 (있는 경우). |
claude.ai 로그인이 필요한 기능 | 공급자에서 도달할 수 없습니다. 여기에는 클라우드 세션, Routines, 관리 Code Review, Ultrareview, Remote Control, Chrome 확장 프로그램, 음성 받아쓰기가 포함됩니다. Channels 및 분석 대시보드도 Bedrock, Google Cloud, Foundry에서 사용할 수 없습니다. Advisor 및 Code Mode도 마찬가지입니다. CLI의 웹 검색은 Bedrock에서 사용할 수 없습니다. Fast mode는 Bedrock 및 Foundry에서 사용할 수 없으며, Google Cloud에서는 Claude Fable 5.2로 제한됩니다. | 스케줄링에는 |
중복 기간 동안 주의할 사항
서버 관리 설정은 여전히 claude.ai로 인증하는 세션에서 우선합니다. 기본적으로 Claude Code는 이를 사용하고 기기의 관리 설정을 건너뜁니다.
env블록 및allowedProviders와 같은 몇 가지 예외가 있습니다. 일부 개발자가 claude.ai에 남아 있으면 그들을 위해 서버 관리 설정을 사용하고 다른 모든 사람을 위해 파일 또는 OS 정책을 사용하세요.저장된 claude.ai 로그인이 컴퓨터에 유지됩니다. 클라우드 공급자 자격증명은 이를 우선합니다. 클라우드 공급자가 활성화되면
/logout은 사용할 수 없습니다. 로그인을 제거하려면 공급자 설정을 배포하기 전에 개발자가 로그아웃하도록 하세요. 로그아웃하면 저장된 MCP 서버 로그인 및 플러그인 비밀도 제거되므로 다시 인증해야 합니다. 게이트웨이 자격증명을 사용하면/logout이 사용 가능하게 유지되며 이를 실행하여 저장된 로그인을 지울 수 있습니다.CLI 정책은 데스크톱 정책의 일부를 재정의할 수 있습니다. 기본적으로 컴퓨터에 Claude Code 관리 설정이 있으면 데스크톱 Code 세션은 데스크톱 앱이 제공하는 관리 정책 값을 무시합니다. 둘 다 사용하려면 관리 설정 배포에서
parentSettingsBehavior를 참조하세요.
개발자 체크리스트
이동 전
관리자가 지정한 버전으로 Claude Code를 업데이트하세요.
필요한 클라우드 세션을
claude --teleport로 터미널로 가져오세요. 먼저 세션의 브랜치가 원격으로 푸시되었는지 확인하고 작업 트리를 정리하세요.사용하는 claude.ai 커넥터를 나열하여 MCP 서버로 추가할 수 있도록 하세요.
의존하는 스킬을
~/.claude/skills/synced/에서 복사하고 다시 설치해야 할 동기화된 플러그인을 나열하세요.
이동하는 날
관리자가 설명하는 방식으로 클라우드 공급자에 로그인하세요. 예를 들어
aws sso login,gcloud auth application-default login, 또는az login을 사용하세요.claude를 시작하고/status를 실행하세요. 공급자, 모델, 설정 소스를 확인하세요.claude --resume으로 최근 세션을 다시 열고 응답하는지 확인하세요.누락된 도구 또는 커넥터에 대해 관리자에게 알리세요.
