AI Gateway, Claude Code 지원 추가

Vercel AI Gateway를 통해 Claude Code 요청을 라우팅할 수 있게 됐다. 환경 변수 세 개만 설정하면 Claude Code의 API 호출이 Vercel 프록시 레이어를 경유하고, 팀 전체의 사용량과 비용을 단일 대시보드에서 모니터링할 수 있다. 비직관적이지만 핵심적인 설정 포인트가 하나 있다.

핵심 포인트

**세 가지 환경 변수**: `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_API_KEY=""`
**빈 문자열이 핵심**: `ANTHROPIC_API_KEY`를 빈 문자열로 설정해야 함 — Claude Code가 이 변수를 먼저 확인하기 때문
**Gateway 기능**: 모든 Claude Code 호출을 Vercel AI Gateway로 중개, 팀 단위 사용량·비용 추적 가능

상세 정리

Claude Code를 Vercel AI Gateway로 라우팅하려면 다음 환경 변수를 설정한다:

```bash ANTHROPIC_BASE_URL=https://ai-gateway.vercel.sh/v1/anthropic ANTHROPIC_AUTH_TOKEN=<vercel-ai-gateway-token> ANTHROPIC_API_KEY="" ```

여기서 `ANTHROPIC_API_KEY=""`(빈 문자열)가 핵심이다. Claude Code는 시작 시 `ANTHROPIC_API_KEY` 환경 변수를 먼저 확인한다. 이 값이 존재하면 해당 키로 직접 Anthropic API에 연결한다. 빈 문자열로 설정하면 변수 자체는 존재하지만 유효한 값이 없으므로, Claude Code가 `ANTHROPIC_BASE_URL`과 `ANTHROPIC_AUTH_TOKEN`으로 폴백해 Vercel AI Gateway를 통해 연결한다.

이 설정을 하지 않고 `ANTHROPIC_API_KEY`를 실제 키 값으로 설정해 두면, Claude Code는 Gateway를 우회해 직접 Anthropic에 연결하기 때문에 모니터링·비용 추적이 불가능하다. 변수를 아예 unset하는 것도 작동하지만, 빈 문자열이 더 명시적이다.

Vercel AI Gateway를 사용하면 조직 전체의 Claude Code 사용량을 단일 대시보드에서 모니터링할 수 있다. 팀원별 토큰 사용량, 비용, 호출 패턴을 추적하고, 속도 제한이나 캐싱 정책도 Gateway 레벨에서 적용 가능하다.

설정 후 간단한 요청을 보내 Vercel 대시보드에 호출이 표시되는지 확인한다.

왜 읽나Claude Code를 팀 단위로 운영하면서 비용 추적이나 사용량 모니터링이 필요한 엔지니어에게 실질적인 설정 가이드를 제공한다. `ANTHROPIC_API_KEY=""`라는 비직관적인 설정이 왜 필요한지 이해하면, 다른 LLM 도구에서도 유사한 환경 변수 우선순위 문제에 동일한 패턴을 적용할 수 있다.

Vercel Blog 블로그

원문은 여기서 이어서 읽을 수 있어요

원문 읽기

읽음 (0)

·takedown 요청