외부 도구를 Letsur Gateway에 연동하기

Letsur Gateway는 OpenAI·Anthropic API 프로토콜과 호환됩니다. 보통 Base URL과 Gateway 키 두 가지만 바꾸면 기존 도구를 그대로 연결할 수 있습니다.

시작 전 준비

• 본인의 Gateway 키 한 개
• 사용할 모델 코드(에셋 카탈로그)
• 도구가 쓰는 API 형식: OpenAI 호환인지 Anthropic 네이티브인지

Claude Code

Claude Code는 Anthropic 네이티브 경로를 사용합니다. ANTHROPIC_BASE_URL에는 /v1을 붙이지 않습니다.

환경 변수로 설정하기

export ANTHROPIC_BASE_URL="https://gw.letsur.ai"
export ANTHROPIC_AUTH_TOKEN="<Letsur에서 발급받은 키>"

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

settings.json으로 설정하기

쉘 환경에 의존하지 않으려면 ~/.claude/settings.json의 env 블록에 직접 기록합니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gw.letsur.ai",
    "ANTHROPIC_AUTH_TOKEN": "<Letsur에서 발급받은 키>"
  }
}

모델 지정

claude --model claude-sonnet-4-6

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

export ANTHROPIC_MODEL="claude-sonnet-4-6"

연결 확인

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

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

Codex

Codex는 ~/.codex/config.toml에 Gateway를 provider로 등록한 뒤 profile로 선택합니다.

model = "gpt-5"
model_provider = "letsur"
 
[model_providers.letsur]
name = "Letsur Gateway"
base_url = "https://gw.letsur.ai/v1"
env_key = "GATEWAY_API_KEY"

키는 환경 변수로 저장합니다.

export GATEWAY_API_KEY="<Letsur에서 발급받은 키>"

연결 확인:

codex exec --skip-git-repo-check "ping"

다른 모델을 쓰려면 model 값을 카탈로그의 모델 코드로 바꿉니다.

기타 OpenAI 호환 도구

OpenAI 호환 도구는 보통 다음 두 값을 설정하면 동작합니다.

export OPENAI_BASE_URL="https://gw.letsur.ai/v1"
export OPENAI_API_KEY="<Letsur에서 발급받은 키>"

도구 화면에 직접 입력하는 경우에도 같은 값을 사용합니다.

알려진 미지원

관련 문서