GetAPI.ONE용 Codex CLI 설정

범위와 사전 조건

이 가이드는 터미널 Codex CLI를 다룹니다. 모든 데스크톱 클라이언트, IDE 확장, 모델, Codex 기능의 호환성을 확정하지 않습니다.

• 사용 가능한 잔액 또는 적용 가능한 패키지가 있는 GetAPI.ONE 계정.
• 이름과 범위가 있고 비공개로 보관한 GetAPI.ONE 키.
• Responses 엔드포인트를 명시적으로 나열하는 현재 카탈로그 모델.
• Codex CLI를 설치하고 사용자 수준 Codex 설정을 수정할 권한.

• 범위가 제한된 키 생성
• 엔드포인트 호환 모델 확인

1. Codex CLI 설치 및 확인

현재 공식 Codex CLI 페이지에서 운영체제에 맞는 설치 도구를 확인하세요. 2026-09-07에 검토한 공식 macOS/Linux 독립 설치 도구는 아래 명령을 사용합니다. Windows 사용자는 Unix 셸 명령을 무조건 실행하지 말고 공식 페이지의 Windows 탭을 따르세요.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

codex --version

2. 터미널에 키 로드

Codex를 시작하기 전에 현재 셸에 키를 설정하세요. 예시는 의도적으로 자리표시자를 포함합니다.

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. ONE 공급자 설정

사용자 수준 Codex config.toml(보통 .codex 디렉터리)을 열고 아래 공급자를 추가하세요. YOUR_RESPONSES_MODEL을 Responses 엔드포인트를 명시하는 현재 GetAPI.ONE 카탈로그 모델로 교체하세요.

model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. 실행 및 확인

1. 환경 변수를 영구 설정했다면 새 터미널을 여세요. 그렇지 않으면 변수가 설정된 현재 터미널을 유지하세요.
2. 프로젝트 디렉터리에서 codex를 실행하세요. 표시된 공급자와 모델이 의도한 설정과 일치하는지 확인하세요.
3. 과금 가능성을 수락한 경우에만 최소 프롬프트 하나를 보내세요.
4. 성공 확인에는 유효한 CLI 응답과 일치하는 GetAPI.ONE 콘솔 요청 또는 사용 기록이 필요합니다. 이 가이드를 만드는 동안 모델을 호출하지 않았습니다.

순서대로 문제 해결

• 전체 문제 해결 가이드
• 안전한 지원 보고 준비