Codex CLI

환경변수 두 개면 돼요.

OpenAI 의 코딩 에이전트예요. 아직 안 깔려 있으면 먼저 설치하시고, 환경변수 두 개만 저희 쪽으로 돌리시면 돼요.

설치

npm install -g @openai/codex

bash

export OPENAI_BASE_URL="https://oneport.kr/v1"
export OPENAI_API_KEY="sk-so-..."

codex

잘 붙었는지 확인#

요금 없이 확인

curl "$OPENAI_BASE_URL/credits" -H "Authorization: Bearer $OPENAI_API_KEY"

잔액이 보이면 붙은 거예요. 이제 평소처럼 쓰시면 되고, 쓴 만큼 그 키에서 빠져요.

실제로 시켜보기

codex -m claude-sonnet-5 "이 저장소의 테스트를 돌리고 실패한 것만 정리해줘"

무엇이 되나#

Codex CLI 는 OpenAI 호환 주소로 붙어요. OpenAI 모델을 부르실 때는 저희가 몸통을 손대지 않고 그대로 넘겨요. Codex 의 웹 검색도 돼요 — 검색 1회에 $0.01씩 토큰과 같이 빠져요. 벤더 서버 도구 중 요금을 셀 수 없는 것(code_interpreter · hosted shell · image_generation)만 400 으로 돌려드려요 — 모델과 단가의 「벤더 서버 도구 요금」을 보세요. Claude 를 부르실 때만 저희가 형식을 옮기는데, 무엇이 옮겨지는지는 글 레퍼런스의 「무엇이 되고 무엇이 안 되나」 표에 적어뒀어요.

모델 고르기#

-m 에 우리 목록의 id 를 그대로 넣으시면 돼요. OpenAI 모델뿐 아니라 Claude 도 여기서 부를 수 있어요 — 저희가 형식을 번역하거든요.

모델 지정

codex -m claude-sonnet-5
codex -m gpt-6-sol

매번 안 치려면#

~/.zshrc 나 ~/.bashrc 에

export OPENAI_BASE_URL="https://oneport.kr/v1"
export OPENAI_API_KEY="sk-so-..."

안 될 때#

404 가 난다 — OPENAI_BASE_URL 에 /v1 이 빠졌는지 보세요. OpenAI 쪽 도구는 /v1 이 필요해요(Anthropic SDK 는 반대로 붙이면 안 돼요).
401 이 난다 — 키가 폐기됐거나 오타예요. 대시보드에서 키 상태를 확인해주세요.
모델을 못 찾는다고 한다 — 이름이 우리 목록에 있는지 GET /v1/models 로 보세요. 비슷한 이름이면 저희가 404 와 함께 가까운 이름을 알려드려요.

원래대로 되돌리기#

OpenAI 직접 연결로

unset OPENAI_BASE_URL OPENAI_API_KEY

이 문서를 AI 에게 넘기시려면 마크다운 원문을 쓰세요 — 주소 끝에 .md 를 붙이면 나와요.