클라이언트 및 SDK 설정 도구

Claude Code, Codex 및 Cursor API 설정 생성기

AI 코딩 에이전트나 백엔드 SDK를 고르고 활성 카탈로그 모델 ID를 선택해 검증된 설정 파일과 최소 연결 스모크 테스트를 복사하세요.

실행 방식로그인 불필요 · 100% 브라우저 로컬프로토콜 템플릿 확인: 2026년 11월 11일

대상 클라이언트 또는 SDK카탈로그 모델 ID환경 변수 이름스트리밍 모드

1. Configuration file or SDK snippet

request.example

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://app.llmfly.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CLAUDE_GROUP_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-5-5"
  }
}

2. Minimal connectivity smoke test

request.example

claude -p "Reply with OK." --model claude-sonnet-5-5

엔지니어링 참고 및 배포 점검

Claude Code, Codex CLI 및 Cursor의 프로토콜 차이

동일한 게이트웨이 도메인에 연결하더라도 개발 도구마다 사용하는 와이어 포맷은 서로 다릅니다. Claude Code는 Anthropic 네이티브 Messages 프로토콜을 사용하므로 끝에 /v1을 붙이지 않은 https://app.llmfly.ai를 ANTHROPIC_BASE_URL로 설정하고 Claude Code 그룹 키와 함께 써야 합니다.

반면 Codex CLI와 최신 OpenAI 추론 모델(gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6.1-terra 등)은 멀티턴 실행에서 추론 요약, 패치, 셸 도구 호출을 유지하기 위해 OpenAI /v1/responses API를 사용합니다. Cursor와 표준 채팅 라이브러리는 https://app.llmfly.ai/v1에 연결하여 /v1/chat/completions를 사용합니다.

클라이언트 / SDK	Base URL	와이어 프로토콜	설정 파일 위치
Claude Code	https://app.llmfly.ai	Anthropic Messages API	~/.claude/settings.json
Codex CLI	https://app.llmfly.ai/v1	OpenAI Responses API (responses)	~/.codex/config.toml
Cursor IDE	https://app.llmfly.ai/v1	OpenAI Chat Completions	Cursor 설정 -> Models
OpenAI Python / TS SDK	https://app.llmfly.ai/v1	Responses 또는 Chat Completions	서버 환경 변수

초기 설정 시 401, 403, 404 오류 예방하기

초기 연결 실패의 90% 이상은 /v1 중복 추가(/v1/v1/chat/completions 404 발생), 정확한 소문자 카탈로그 ID gpt-6-astra 대신 표시 이름 "GPT-6 Astra" 입력, 또는 요청 라우트와 다른 모델 그룹에 할당된 API 키 사용이라는 세 가지 실수에서 발생합니다.

CLI 세션이 잘못된 계정으로 과금되지 않도록 공식 제공사 자격 증명과 LLMFly AI 게이트웨이 키를 별도의 셸 프로필이나 프로젝트 디렉터리에 분리해 보관하세요.
MCP 서버, 저장소 인덱싱 또는 백그라운드 서브 에이전트를 켜기 전에 2단계의 비스트리밍 스모크 테스트를 먼저 실행하세요.
유출되거나 만료된 키를 개별 폐기할 수 있도록 개발자 노트북, CI 러너, 스테이징 서비스마다 별도의 API 키를 발급하세요.

자주 묻는 질문

Claude Code의 ANTHROPIC_BASE_URL에서 /v1을 생략하는 이유는 무엇인가요?

Claude Code는 Anthropic SDK 규칙에 따라 내부적으로 /v1/messages를 자동 추가합니다. ANTHROPIC_BASE_URL에 /v1을 포함하면 경로가 /v1/v1/messages가 되어 HTTP 404 오류가 발생합니다.

Python이나 TypeScript 앱에서 chat.completions.create 대신 client.responses.create를 써야 할 때는 언제인가요?

GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol, GPT-6.1 Terra를 호출할 때—특히 추론 강도 설정과 함수 호출이나 내장 Responses 도구를 결합할 때 client.responses.create를 사용하세요.

하나의 API 키를 Claude Code와 GPT 모델 모두에 사용할 수 있나요?

LLMFly AI 콘솔에서 해당 키의 그룹 할당을 확인하세요. Claude Code 라우트와 OpenAI Codex/GPT 라우트는 모델 플라자에서 각기 지정된 과금 그룹에 속합니다.

코딩 환경 전용 API 키 만들기

콘솔에서 범위 지정 API 키를 발급하고 1분 안에 첫 CLI 또는 SDK 요청을 검증하세요.

API 키 만들기