한국어
로그인시작하기

CODEX CONFIGURATION

Codex 설정 가이드

가져오기 도구 또는 수동 설정으로 Codex가 getaitoken.com의 /v1 엔드포인트를 사용하게 합니다.

사용량 확인로그인 후 API Keys 열기

공개 가이드는 자리 표시자 키만 보여줍니다. 실제 API Key는 로그인 후 API Keys 페이지에서 확인하세요.

Codex CLI / DesktopOpenAI Responses/v1 호환 엔드포인트claude-opus-5-5Usage 검증

Claude Code 및 Codex 설정

아래 스니펫은 API Keys 페이지의 "API 키 사용" 대화상자와 같은 생성기로 만들어집니다. Claude Code는 /v1 없는 API 주소를, Codex는 /v1을 사용합니다. 로그인 후 그룹에서 쓸 수 있는 모델과 셸을 고르면 실제 키가 들어간 설정을 받을 수 있습니다.

Claude Code

Terminal

export ANTHROPIC_BASE_URL='https://api.getaitoken.com'
export ANTHROPIC_AUTH_TOKEN='<getaitoken API key>'
export ANTHROPIC_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-opus-5-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-opus-5-5'

Codex CLI

~/.codex/config.toml

model_provider = "getaitoken"
model = "claude-opus-5-5"
review_model = "claude-opus-5-5"
disable_response_storage = true

[model_providers.getaitoken]
name = "getaitoken.com"
base_url = "https://api.getaitoken.com/v1"
wire_api = "responses"
supports_websockets = false
requires_openai_auth = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "<getaitoken API key>"
}
  • Claude Code: ANTHROPIC_BASE_URL에는 /v1을 붙이지 않습니다. 세 개의 ANTHROPIC_DEFAULT_*_MODEL은 기본적으로 메인 모델을 따라가므로, 백그라운드 작업이 그룹에서 열리지 않은 공식 기본 모델을 요청하지 않습니다. 같은 변수를 ~/.claude/settings.json의 "env" 블록에 넣으면 Finder, Dock, IDE에서 실행해도 셸 설정에 의존하지 않습니다.
  • Codex 기본 인증: config.toml에 requires_openai_auth = true를 쓰고 키는 auth.json의 OPENAI_API_KEY에 둡니다. Codex는 같은 이름의 환경 변수가 아니라 이 파일을 읽으므로 macOS, Linux, Windows 모두 env_key나 환경 변수가 필요 없습니다.
  • env_key는 선택적인 대안일 뿐입니다. env_key = "GETAITOKEN_API_KEY"를 쓰면 requires_openai_auth와 auth.json을 제거하세요. Codex는 env_key를 먼저 확인하며, 변수가 없거나 비어 있으면 Missing environment variable 오류로 실패하고 auth.json으로 돌아가지 않습니다.
  • env_key를 쓰는 경우: macOS zsh는 ~/.zshrc, bash는 ~/.bashrc에 추가하고, Windows는 setx GETAITOKEN_API_KEY "<getaitoken API key>" 실행 후 터미널을 다시 엽니다. Finder나 Dock에서 실행한 Codex 데스크톱 앱은 ~/.zshrc를 읽지 않으므로 launchctl setenv GETAITOKEN_API_KEY "<getaitoken API key>" 후 완전히 재시작하거나 기본 auth.json 방식을 사용하세요.
  • 대화상자의 "API 키를 구성 파일에 저장" 스위치는 requires_openai_auth = false와 experimental_bearer_token을 쓰고 auth.json은 만들지 않으며 기존 로그인에도 영향을 주지 않습니다. 두 방식을 섞지 마세요.
  • 모델 ID는 /v1/models가 반환한 값을 그대로 사용하세요(예: claude-opus-5-5). 접두사를 붙이거나 버전 번호의 -를 .으로 바꾸지 마세요.

내 키가 지원하는 모델 확인하기

"내 계정은 어떤 모델을 쓸 수 있나요?"라는 질문에는 현재 키가 실제로 호출할 수 있는 모델만 반환하는 /v1/models가 가장 정확한 답을 줍니다.

  1. 01

    GET /v1/models 호출

    curl https://api.getaitoken.com/v1/models -H "Authorization: Bearer <getaitoken API key>" 를 실행하면 OpenAI 형식의 {object:"list", data:[{id, owned_by, ...}]} 가 반환되며, id 값이 이 키로 사용할 수 있는 모델입니다(그룹과 플랫폼 화이트리스트로 필터링됨).

  2. 02

    Available Channels 페이지 열기

    로그인 후 /available-channels 에 접속하면 지원 모델, 그룹, 요금 배수를 화면에서 확인할 수 있습니다. 미로그인 시 /login 으로 이동합니다.

  3. 03

    API Keys에서 키 생성 및 그룹 지정

    /keys 에서 키를 생성·관리합니다. 그룹이 지정되지 않은 키는 모델 쿼터가 없으므로 그룹 설정을 확인하세요.

  4. 04

    모델이 없을 때

    모델 id가 /v1/models 에 없다면 해당 키의 그룹에 포함되지 않은 것입니다. /available-channels 에서 확인하거나 지원팀에 문의하세요.

OpenAI 호환 엔드포인트 참조

Base URL은 https://api.getaitoken.com/v1 이며 Authorization: Bearer 로 인증합니다. 아래는 현재 제공 중인 OpenAI 호환 엔드포인트입니다.

모델 및 사용량

  • GET /v1/models — 현재 키가 접근 가능한 모델 목록. 시작 시 모델 목록 조회에 사용.
  • GET /v1/usage — 사용량과 쿼터 확인.

대화 및 Responses

  • POST /v1/chat/completions — 표준 채팅 컴플리션.
  • POST /v1/responses(/v1/responses/* 포함) — Responses API. Codex는 wire_api = "responses" 사용.
  • POST /v1/messages — Anthropic Messages API. Claude Code가 ANTHROPIC_BASE_URL로 호출.

임베딩

  • POST /v1/embeddings — 텍스트 임베딩.

이미지

  • POST /v1/images/generations — 이미지 생성.
  • POST /v1/images/edits — 이미지 편집(그룹에서 이미지 기능 활성화 필요).

/v1 이 없는 루트 별칭도 동작하지만, 클라이언트는 /v1 로 통일해 설정하세요.

권장 도입 경로

getaitoken.com의 OpenAI 호환 Responses API에 Codex를 연결하는 방법입니다.

  1. 01

    OpenAI 그룹 만들기

    상위 계정, 요율, 제한을 먼저 설정합니다.

  2. 02

    API 키 발급

    사용자나 앱마다 독립된 인증 정보와 사용 경계를 부여합니다.

  3. 03

    Usage와 주문 확인

    실제 트래픽을 보고 용량과 팀 기능 확장을 결정합니다.

FAQ

getaitoken.com은 현재 무엇을 지원하나요?

OpenAI API 접속을 제공합니다. Responses, Chat, Images를 완전 호환하며 계정 관리, 결제, 할당량 제어, 사용량 가시성을 포함합니다.

팀이나 자동화에 사용할 수 있나요?

네. OpenAI API 키, 그룹, 제한, 결제 가시성부터 시작하고 사용량이 확인되면 팀 운영과 자동화로 확장할 수 있습니다.

어떤 모델을 사용할 수 있나요?

GPT-6-astra, GPT-5.6 시리즈(sol / terra / luna), GPT-5.5, GPT-5.4, gpt-image 시리즈를 제공합니다. 전체 목록과 실시간 가격은 모델 페이지에서 확인하세요.

실제 Codex 설정 생성

로그인 후 API Keys에서 실제 키를 복사하거나 가져온 뒤 Codex를 다시 시작하세요.

사용량 확인로그인 후 API Keys 열기