연동 가이드

Claude Code CLI 연동

요약

Anthropic의 공식 AI 코딩 도우미 Claude Code를 영남대학교 AI@YU Gateway와 함께 사용해보세요!

환경 변수 2개만 설정하면 Claude Code의 모든 기능을 Gateway를 통해 사용할 수 있습니다. 스트리밍, 도구 사용, 확장 사고 등 모든 Anthropic 기능이 완벽하게 지원됩니다.

공식 레퍼런스: Claude Code 문서

시작하기 전에 영남대학교 AI@YU API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.

설정


bash
# 1단계: Anthropic 호환 게이트웨이 접두사로 Base URL 설정
export ANTHROPIC_BASE_URL=https://factchat-cloud.mindlogic.ai/v1/gateway/claude

# 2단계: API 키 설정
# 참고: 커스텀 Base URL에서는 ANTHROPIC_API_KEY가 아닌 ANTHROPIC_AUTH_TOKEN을 사용
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

# 3단계: 연결 확인
claude "Say hello"

왜 ANTHROPIC_API_KEY가 아닌 ANTHROPIC_AUTH_TOKEN인가요?

영구 설정

~/.zshrc 또는 ~/.bashrc에 추가:


bash
export ANTHROPIC_BASE_URL=https://factchat-cloud.mindlogic.ai/v1/gateway/claude
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

또는 프로젝트에 .env 파일 생성:


env
ANTHROPIC_BASE_URL=https://factchat-cloud.mindlogic.ai/v1/gateway/claude
ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

모델 지정


bash
# 특정 모델 사용
claude --model claude-sonnet-4-6 "Explain async/await"

# CLAUDE_MODEL 환경 변수로 사용
export CLAUDE_MODEL=claude-sonnet-4-6
claude "Explain async/await"

지원 기능

기능	지원 여부
스트리밍 응답	지원
도구 사용 (function calling)	지원
비전 (이미지 입력)	지원
확장 사고	지원
프롬프트 캐싱	지원
다중 턴 대화	지원

트러블슈팅

401 Unauthorized

ANTHROPIC_API_KEY가 아닌 ANTHROPIC_AUTH_TOKEN이 설정되어 있는지 확인
API 키가 유효한지 확인

모델을 찾을 수 없음 / 404

ANTHROPIC_BASE_URL이 /v1/gateway/claude로 끝나는지 확인
SDK가 Base URL에 /v1/messages를 자동으로 추가합니다

Gateway 해제 (Anthropic 직접 연결로 복원)


bash
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_API_KEY=YOUR_REAL_ANTHROPIC_KEY

마지막 수정 날짜: Apr 15, 2026

OpenAI SDK

OpenCode