Skip to content

CLAUDE_CODE.md

Latest commit

 

History

History
154 lines (100 loc) · 6.79 KB

CLAUDE_CODE.md

File metadata and controls

154 lines (100 loc) · 6.79 KB

GAC에서 Claude Code 사용하기

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | हिन्दी | Tiếng Việt | Français | Русский | Español | Português | Norsk | Svenska | Deutsch | Nederlands | Italiano

GAC는 Claude Code 구독을 통한 인증을 지원하며, 비싼 Anthropic API를 지불하는 대신 Claude Code 구독을 사용할 수 있습니다. 이미 구독으로 Claude Code 액세스 권한을 가진 사용자에게 적합합니다.

⚠️ 주의 — 공식적으로 승인되지 않은 사용: Anthropic은 Claude Code CLI 외부에서 Claude Code OAuth 토큰을 사용하는 타사 도구를 적극적으로 단속하고 있으며, 때로는 액세스를 취소합니다. gac는 지금까지 레이더에서 벗어날 정도로 작지만, 여기서 Claude Code (OAuth)를 사용하는 것은 공식적으로 승인되지 않았으며 언제든지 작동을 중지할 수 있습니다. 안정적인 커밋 메시지 생성이 필요하면 대신 직접 API 제공자(anthropic, openai 등)를 사용하세요. 현재 정책은 Anthropic의 Claude Code 구독 문서를 참조하세요.

Claude Code란?

Claude Code는 Anthropic의 구독 서비스로, OAuth 기반의 Claude 모델 액세스를 제공합니다. API 키(토큰당 과금)를 사용하는 대신, Claude Code는 구독의 OAuth 토큰을 사용합니다.

이점

  • 비용 효율성: 기존 Claude Code 구독을 사용하고 API 액세스를 별도로 지불할 필요가 없습니다
  • 동일한 모델: 동일한 Claude 모델(예: claude-sonnet-4-5)에 액세스할 수 있습니다
  • 별도 과금: Claude Code 사용은 Anthropic API 과금과 분리되어 있습니다

설정

GAC에는 Claude Code용 내장 OAuth 인증이 포함되어 있습니다. 설정 과정은 완전 자동화되어 있으며 인증을 위해 브라우저가 자동으로 열립니다.

옵션 1: 초기 설정 중 (권장)

uvx gac init를 실행할 때, 프로바이더로 "Claude Code"를 선택하기만 하면 됩니다:

uvx gac init

마법사는 다음을 수행합니다:

  1. 프로바이더 목록에서 "Claude Code"를 선택하도록 요청합니다
  2. OAuth 인증을 위해 브라우저를 자동으로 엽니다
  3. 액세스 토큰을 ~/.gac.env에 저장합니다
  4. 기본 모델을 설정합니다

옵션 2: 나중에 Claude Code로 전환

다른 프로바이더로 GAC를 이미 설정했고 Claude Code로 전환하려는 경우:

uvx gac model

그런 다음:

  1. 프로바이더 목록에서 "Claude Code"를 선택합니다
  2. OAuth 인증을 위해 브라우저가 자동으로 열립니다
  3. 토큰이 ~/.gac.env에 저장됩니다
  4. 모델이 자동으로 설정됩니다

GAC를 평소대로 사용하기

인증되면 평소처럼 GAC를 사용할 수 있습니다:

# 변경 사항을 스테이징
git add .

# Claude Code로 생성하고 커밋
uvx gac

# 또는 단일 커밋을 위해 모델을 재정의
uvx gac -m claude-code:claude-sonnet-4-5

사용 가능한 모델

Claude Code는 Anthropic API와 동일한 모델에 접근할 수 있습니다. 현재 Claude 4.5 모델 제품군은 다음을 포함합니다:

  • claude-sonnet-4-5 - 최신이고 가장 지능적인 Sonnet 모델, 코딩에 최적
  • claude-haiku-4-5 - 빠르고 효율적
  • claude-opus-4-5 - 복잡한 추론에서 가장 강력한 모델

사용 가능한 모델의 전체 목록은 Claude 문서를 확인하세요.

문제 해결

토큰 만료됨

인증 오류가 표시되면 토큰이 만료되었을 수 있습니다. 다음을 실행하여 재인증하세요:

uvx gac auth claude-code login

브라우저가 자동으로 열려 새로운 OAuth 인증이 진행됩니다. 또는 uvx gac model을 실행하고 "Claude Code (OAuth)"를 선택한 다음 "재인증(새 토큰 받기)"를 선택할 수도 있습니다.

인증 상태 확인

현재 인증되어 있는지 확인하려면:

uvx gac auth claude-code status

또는 모든 프로바이더를 한 번에 확인:

uvx gac auth

로그아웃

저장된 토큰을 제거하려면:

uvx gac auth claude-code logout

"CLAUDE_CODE_ACCESS_TOKEN을 찾을 수 없음"

이는 GAC가 액세스 토큰을 찾을 수 없다는 의미입니다. 다음을 실행하여 인증하세요:

uvx gac model

그런 다음 프로바이더 목록에서 "Claude Code"를 선택하세요. OAuth 플로우가 자동으로 시작될 것입니다.

"인증 실패"

OAuth 인증이 실패하면:

  1. 활성 Claude Code 구독이 있는지 확인하세요
  2. 브라우저가 올바르게 열리는지 확인하세요
  3. 문제가 지속되면 다른 브라우저를 시도하세요
  4. claude.ai로의 네트워크 연결을 확인하세요
  5. 포트 8765-8795가 로컬 콜백 서버에 사용 가능한지 확인하세요

Anthropic 프로바이더와의 차이점

기능 Anthropic (anthropic:) Claude Code (claude-code:)
인증 API 키 (ANTHROPIC_API_KEY) OAuth (자동 브라우저 플로우)
과금 토큰당 API 과금 구독 기반
설정 수동 API 키 입력 uvx gac init 또는 uvx gac model를 통한 자동 OAuth
토큰 관리 장기 API 키 OAuth 토큰 (만료될 수 있음, model로 쉬운 재인증)
모델 동일한 모델 동일한 모델

보안 참고사항

  • 액세스 토큰을 버전 관리에 커밋하지 마세요
  • GAC는 토큰을 ~/.gac.env (프로젝트 디렉터리 외부)에 자동으로 저장합니다
  • 토큰은 만료될 수 있으며 uvx gac model을 통한 재인증이 필요할 수 있습니다
  • OAuth 플로우는 보안 강화를 위해 PKCE (Proof Key for Code Exchange)를 사용합니다
  • 로컬 콜백 서버는 로컬 호스트에서만 실행됩니다 (포트 8765-8795)

참고 자료