Claude Code 연동

시작 전 준비

• AI 게이트웨이 API 키

  현재 사용할 수 있는 AI 게이트웨이 API 키를 준비합니다.

• Claude 모델 코드

  에셋에 표시된 정확한 모델 코드를 확인합니다.

• Claude Code

  로컬 환경에 Claude Code가 설치되어 있어야 합니다.

연결 설정

환경 변수로 설정

아래 Bash 명령은 키 입력을 화면과 셸 히스토리에 남기지 않고 현재 셸 세션에만 설정합니다. 새 터미널을 열면 다시 설정해야 합니다.

export ANTHROPIC_BASE_URL="https://gw.letsur.ai"
printf 'Letsur API 키: '
IFS= read -rs ANTHROPIC_API_KEY
printf '\n'
export ANTHROPIC_API_KEY

이후 평소처럼 claude 명령을 실행합니다.

settings.json으로 설정

base URL과 기본 모델은 ~/.claude/settings.json의 env 블록에 기록할 수 있습니다. API 키는 설정 파일에 넣지 않고 위와 같이 실행할 셸에서 설정합니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gw.letsur.ai",
    "ANTHROPIC_MODEL": "<MODEL_CODE>"
  }
}

환경에 기존 값이 있다면 이 가이드의 설정과 충돌하지 않는지 확인합니다.

모델 선택

claude --model "<MODEL_CODE>"

또는 환경 변수로 지정합니다.

export ANTHROPIC_MODEL="<MODEL_CODE>"

연결 확인

claude -p "ping" --output-format text

응답이 정상으로 오면 연결된 것입니다.

대화형 세션에서 /status를 실행하면 Anthropic base URL과 활성 credential source를 함께 확인할 수 있습니다.

지원 범위와 제약

공통 인증 형식과 다른 도구의 연결 방식은 외부 도구 연동에서 비교합니다.

설정 기준: Claude Code 게이트웨이 연결 , Claude Code CLI reference 에서 환경 변수, 설정 파일, 모델 옵션을 2026년 8월 7일에 확인했습니다.

문제 해결