snow · 2026.5.15 10:32 · 조회 2
API 키 관리
API 키 종류
Claude Code는 두 가지 인증 방식을 지원합니다.
| 방식 | 설명 | 적합한 환경 |
|---|---|---|
| Anthropic API 키 | Anthropic Console에서 발급 | 개인 개발자, 팀 공용 키 관리 |
| Claude.ai 계정 | 브라우저 OAuth 인증 | 개인 사용자 |
Anthropic API 키 발급
- console.anthropic.com 접속
- API Keys → Create Key
- 키 이름 입력 (예:
dev-team-claude-code) - 키 복사 (한 번만 표시됨)
환경 변수 설정
임시 설정 (현재 세션)
1export ANTHROPIC_API_KEY=sk-ant-api03-...영구 설정
1# ~/.zshrc 또는 ~/.bashrc에 추가2echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc3source ~/.zshrc.env 파일 사용 (프로젝트별)
1# .env.local (Git에 커밋하지 않도록 주의)2ANTHROPIC_API_KEY=sk-ant-api03-...
.env파일은 반드시.gitignore에 추가하세요.
팀 환경에서 키 관리
1Password / Vault 활용
1# 1Password CLI로 키 주입2export ANTHROPIC_API_KEY=$(op read "op://Private/Anthropic API Key/credential")CI/CD 환경 변수
1# GitHub Actions2- name: Run Claude Code3 env:4 ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}5 run: claude -p "테스트를 실행하고 실패한 부분을 수정해줘"AWS Secrets Manager
1export ANTHROPIC_API_KEY=$(aws secretsmanager get-secret-value \2 --secret-id prod/anthropic-api-key \3 --query SecretString --output text)사용량 모니터링
1# 현재 세션 비용 확인2/costAnthropic Console에서 팀 전체 사용량 모니터링:
- Usage 탭에서 일별/월별 토큰 사용량 확인
- Billing 탭에서 비용 알림 설정
API 키 교체 정책
- 주기: 분기 1회 또는 퇴직자 발생 시 즉시 교체
- 절차: 새 키 발급 → 배포 → 기존 키 비활성화
- 보안: 키 유출 의심 시 즉시 Console에서 비활성화
키 유출 시 대응
- console.anthropic.com → API Keys → 해당 키 Revoke
- 새 키 발급 및 배포
- Git 히스토리에 커밋된 경우:
git filter-branch또는 BFG Repo Cleaner로 제거 - 필요 시 Anthropic 지원팀에 연락
댓글
아직 댓글이 없습니다.
댓글을 작성하려면 로그인이 필요합니다.