OpenAI Codex CLI

OpenAI 공식 터미널 코딩 agent. 표준 OpenAI API를 사용하므로 동일한 두 개의 환경 변수로 다음을 사용할 수 있습니다 모든 생태계 내 OpenAI 호환 도구 — Codex가 작동하면 Aider / Continue / LangChain / 순수 openai CLI도 모두 작동합니다.

시작하기 전에

다음 위치에서 API key를 생성하세요 Console → API Keys. 즉시 복사하세요 — 한 번만 표시됩니다.

1단계 — 환경 변수 설정

# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..."   # your Synthorai key

⚠

OpenAI 호환 base URL 는 다음으로 끝나야 합니다 /v1. Anthropic SDK와 달리 OpenAI SDK는 자동으로 추가하지 않습니다. 흔한 실수는 다음을 붙여넣는 것입니다 https://synthorai.io; 그러면 요청이 다음으로 전송되어 /chat/completions （404）이 되어 다음 대신 전송됩니다 /v1/chat/completions.

2단계 — 첫 번째 요청 보내기

# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py

# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"

동일한 구성이 다음에도 적용됩니다 openai CLI, Python/Node SDK, Aider 및 기타 모든 OpenAI 호환 도구 — 이들은 모두 다음을 읽습니다 OPENAI_BASE_URL 및 OPENAI_API_KEY.

권장 모델

매개변수	유형	설명
`gpt-5.3-codex`	`coding`	코드 생성에 맞게 튜닝됨. Codex CLI의 기본 선택입니다.
`gpt-5.4`	`reasoning`	플래그십 추론 성능. 아키텍처 수준의 리팩터링에 사용하세요.
`gpt-5.4-mini`	`fast`	빠르고 저렴하면서도 여전히 매우 뛰어납니다. 짧은 작업에 적합한 기본 선택입니다.
`gpt-5.4-nano`	`cheapest`	가장 저렴한 OpenAI 옵션. 소규모 편집 및 분류에 사용하세요.

문제 해결

/chat/completions에서 "404 Not Found" — 당신의 OPENAI_BASE_URL 에 다음이 없습니다 /v1 접미사. 수정 방법: export OPENAI_BASE_URL="https://synthorai.io/v1".

"여전히 api.openai.com으로 요청됨" — 새 환경 변수는 새 셸에만 적용됩니다. 새 터미널을 열거나 source 프로필을 다시 불러오세요.

"Model not found" — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" 워크스페이스에서 사용 가능한 정확한 목록을 확인할 수 있습니다.

프로젝트별 재정의 — 이 변수들을 전역으로 설정하고 싶지 않다면 프로젝트의 .envrc （direnv와 함께）또는 셸별 함수에 넣으세요.

네 가지 등급의 가격 비교는 model price comparison에서 확인하세요.