Google Cloud의 Claude 모델(Anthropic 관리형)과 함께 Claude Code 사용하기

사전 요구 사항

• 계정 설정이 완료된 Google Cloud 프로젝트
• Claude Code를 실행하는 각 Google 계정 또는 서비스 계정에 대해 해당 프로젝트의 roles/claude.user IAM 역할
• 프로젝트 ID와 wrkspc_로 시작하는 워크스페이스 ID
• 서비스 계정 키 파일 대신 Google 계정으로 로그인하는 경우 gcloud CLI

Claude Code 설정

gcloud auth application-default login

{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}

팀을 위한 Claude Code 설정

모델 버전 고정

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

환경 변수

사용할 수 없는 Claude Code 기능

• 빠른 모드: /fast 또는 fastMode 설정으로 켤 수 없습니다
• Remote Control 및 클라우드 세션
• claude.ai의 MCP 커넥터
• 채널
• /design-sync 및 /import 명령
• 서버 관리형 설정. 팀에 설정을 강제하려면 대신 각 컴퓨터에서 관리형 설정을 사용하십시오

문제 해결

• CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD가 1인지 확인합니다
• claude --version이 2.1.307 이상을 출력하는지 확인합니다
• 셸과 설정 파일에서 CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY, CLAUDE_CODE_USE_ANTHROPIC_AWS를 제거합니다

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

• 프로젝트: /status에서 GCP project 줄에 사용자의 프로젝트가 표시되는지 확인합니다. 다른 프로젝트가 표시되거나 해당 줄이 없으면 No project was given을 따릅니다
• 워크스페이스: /status에서 Workspace ID 줄에 사용자의 워크스페이스 ID가 표시되는지 확인합니다. 다른 ID가 표시되면 No workspace ID found를 따릅니다
• IAM 역할: Claude Code를 실행하는 Google 계정 또는 서비스 계정이 GCP project 줄에 있는 프로젝트에 대해 roles/claude.user 또는 roles/claude.admin을 보유하고 있는지 확인합니다. 역할을 부여하려면 서비스의 권한 부여 명령을 사용하거나 프로젝트 관리자에게 부여를 요청합니다
• 서비스: GCP project 줄에 있는 프로젝트에서 claude.googleapis.com 서비스가 활성화되어 있는지 확인합니다. 활성화하려면 서비스의 계정 설정 단계를 따르거나 프로젝트 관리자에게 활성화를 요청합니다

관련 리소스

• Google Cloud의 Claude 모델(Anthropic 관리형): 계정 설정, IAM 역할, 청구, 데이터 보존 및 기능 지원
• 엔터프라이즈 배포 개요: Claude Code를 배포하는 다른 방법과 프록시 및 게이트웨이 설정
• 모델 구성: 모델 별칭, 모델 버전 고정, 사용자가 선택할 수 있는 모델 제한