# Codex CLI

> 환경변수 두 개면 돼요.

> 원문: https://oneport.kr/docs/guides/codex-cli

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

**설치**

```bash
npm install -g @openai/codex
```

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

codex
```

## 잘 붙었는지 확인

**요금 없이 확인**

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

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

**실제로 시켜보기**

```bash
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 도 여기서 부를 수 있어요 — 저희가 형식을 번역하거든요.

**모델 지정**

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

## 매번 안 치려면

**~/.zshrc 나 ~/.bashrc 에**

```bash
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 직접 연결로**

```bash
unset OPENAI_BASE_URL OPENAI_API_KEY
```