Claude Code 프로파일 전환 설정 가이드(Windows 에서 GLM도 쓰기)

 

 

개요

Claude Code를 사용할 때 Anthropic 공식 구독과 Z.ai의 GLM-4.7 모델을 간편하게 전환할 수 있도록 PowerShell 프로파일을 설정하는 방법입니다.

설정 방법

1. PowerShell 프로파일 열기

notepad $PROFILE

💡 프로파일 파일이 없다면 자동으로 생성됩니다.

2. 전환 스크립트 추가

아래 코드를 $PROFILE 파일에 추가합니다:

# Claude Code 프로파일 전환 스크립트

# 1. 기본 모드 (Anthropic 구독) - 환경변수 설정만 합니다.
function cc {
    Remove-Item Env:\\ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
    Remove-Item Env:\\ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue
    Remove-Item Env:\\ANTHROPIC_DEFAULT_SONNET_MODEL -ErrorAction SilentlyContinue

    Write-Host "✓ Anthropic 구독 모드로 전환" -ForegroundColor Green
}

# 2. GLM 모드 (Z.ai API) - 환경변수 설정만 합니다.
function glm {
    $env:ANTHROPIC_AUTH_TOKEN = "your-zai-api-key-here"
    $env:ANTHROPIC_BASE_URL = "<https://api.z.ai/api/anthropic>"
    $env:ANTHROPIC_DEFAULT_SONNET_MODEL = "glm-4.7"

    Write-Host "✓ GLM-4.7 모드로 전환 (Z.ai)" -ForegroundColor Yellow
}

# 3. 현재 설정 확인
function ccp {
    Write-Host "`n=== Claude Code 현재 설정 ===" -ForegroundColor Cyan

    if ($env:ANTHROPIC_BASE_URL) {
        Write-Host "모드: GLM (Z.ai)" -ForegroundColor Yellow
        Write-Host "Base URL: $env:ANTHROPIC_BASE_URL"
        Write-Host "Model: $env:ANTHROPIC_DEFAULT_SONNET_MODEL"
        Write-Host "Auth: $($env:ANTHROPIC_AUTH_TOKEN.Substring(0,8))..." -ForegroundColor DarkGray
    } else {
        Write-Host "모드: Anthropic 구독 (기본)" -ForegroundColor Green
        Write-Host "인증: Claude.ai 세션 사용"
    }
    Write-Host ""
}

4. 프로파일 적용

. $PROFILE

또는 PowerShell을 재시작합니다.

---

사용법

기본 사용

# Anthropic 구독 모드로 전환
cc

# GLM 모드로 전환
glm

# 현재 설정 확인
ccp

실제 사용 예시

# 1. GLM 모드로 전환 후 Claude Code 실행
glm
claude

# 2. Anthropic 모드로 전환 후 실행
cc
claude

# 3. 현재 어떤 모드인지 확인
ccp

---

동작 원리

Anthropic 모드 (cc)

• 모든 커스텀 환경변수를 제거
• Claude Code가 기본 설정(Claude.ai 구독)을 사용하도록 함
• 별도 API 키 없이 브라우저 세션 인증 사용

GLM 모드 (glm)

• ANTHROPIC_AUTH_TOKEN: Z.ai API 키 설정
• ANTHROPIC_BASE_URL: Z.ai API 엔드포인트로 변경
• ANTHROPIC_DEFAULT_SONNET_MODEL: GLM-4.7 모델 지정

---

장단점

✅ 장점

• 간편한 전환: cc, glm 명령어만으로 즉시 전환
• 세션별 독립: 각 터미널 세션마다 독립적으로 모드 설정 가능
• 빠른 전환: 환경변수만 변경하므로 즉시 적용

⚠️ 주의사항

• API 키 노출: $PROFILE은 평문 파일이므로 보안에 주의
• 세션 기반: PowerShell 세션마다 모드 설정이 초기화됨
• 버전 관리: Git 등에 올릴 때 API 키가 노출되지 않도록 주의

---

마무리

이 설정을 통해 Claude Code를 사용할 때 공식 Anthropic 모델과 **중국 로컬 모델(GLM-4.7)**을 상황에 맞게 유연하게 전환할 수 있습니다.

• 번역/중국어 작업: glm → 로컬 모델 사용
• 일반 작업/최신 기능: cc → Anthropic 공식 모델 사용

필요에 따라 추가 프로파일(다른 API 제공자)도 같은 방식으로 쉽게 확장할 수 있습니다.