Claude한테 말 거는 방법 네 가지
Claude 표면에 인증하는 길은 네 갈래. Anthropic Console에서 받은 API 키, Pro/Max 구독으로 CLI가 쓰는 Claude Code OAuth, AWS 자격증명 쓰는 Amazon Bedrock, GCP 자격증명 쓰는 Google Vertex AI. 각 경로마다 쿼터, 과금 표면, 리전 제약, 기능 노출이 달라. 호환되는 게 아니야 — 결정.
각 경로가 실제로 어떻게 굴러가
API 키는 가장 직접적: ANTHROPIC_API_KEY 환경변수 잡고 SDK 부르면 끝. OAuth는 Claude Code CLI가 Pro/Max 구독으로 로그인한 토큰을 쓰는 방식 — Agent SDK도 같은 인증으로 굴러가. 이게 cwkPippa의 Claude 브레인이 토큰당 과금 안 하고 아빠의 기존 Max 구독 위에 사는 이유야. Bedrock이랑 Vertex는 호출 표면 자체를 바꾸고(SDK 클라이언트가 따로) 엔터프라이즈 쿼터·리전 거주성을 풀지만, 기능 신선도는 직접 API보다 한 박자 늦어.
2-of-2 안전망, 단일 장애점 X
프로덕션이면 어느 경로가 primary고 어느 게 보험인지 알아야 해. cwkPippa의 Gemini 베리언트는 OAuth(Cloud Code Assist) 디폴트, OAuth 쿼터/인증 실패 시 유료 Gemini API 키로 자동 전환 — 조용히 말고 sticky 토스트로 보이게. Claude 브레인은 OAuth-only로 설계 (Anthropic API 키는 미래용 reserved scaffolding이지 런타임 경로 아님). 정책을 글로 박아두는 게 새벽 3시 즉흥 회피의 시작이야.