---
title: "Codex CLI 연결"
description: "OpenAI Codex CLI를 1折AI에 연결하는 구성 방법(~/.codex/config.toml의 model_providers), Responses 인터페이스를 통해 GPT 모델 호출."
headingIds: {"구성 파일":"section-1","Codex 설치":"section-2","자주 묻는 질문":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
OpenAI / GPT 모델이 출시되었습니다. Codex CLI는 OpenAI Responses 인터페이스(`/v1/responses`)를 사용하며, 본 사이트 API 키로 연결합니다. 사용 가능한 모델과 가격은 [모델 카탈로그](https://1zheai.com/model-catalog?lng=ko)에서 확인하세요.

먼저 Codex 사용자 지정 공급자 구성 방식을 명확히 설명하겠습니다. 형식은 [Codex 공식 구성 문서](https://developers.openai.com/codex/config-reference)에서 가져왔습니다.

## 구성 파일

Codex의 구성은 `~/.codex/config.toml`에 있습니다. 사용자 지정 공급자는 이 사용자 수준 파일에만 작성할 수 있으며, 프로젝트의 `.codex/config.toml`에서 `model_provider`을(를) 설정하면 무시됩니다.

```toml title="~/.codex/config.toml"
model_provider = "onezhe"
model = "gpt-6-astra"

[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```

예제는 `gpt-6-astra`을(를) 사용하며, 키가 지원하는 다른 GPT 모델 ID로 교체할 수 있습니다.

각 필드의 의미:

| 필드 | 설명 |
|---|---|
| `model_provider` | 어떤 공급자를 사용할지, 아래 `[model_providers.<id>]`의 id에 해당합니다. `openai`, `ollama`, `lmstudio`은(는) 예약된 이름이므로 사용할 수 없습니다 |
| `base_url` | `/v1`을(를) 포함해야 합니다 |
| `env_key` | Codex가 이 환경 변수에서 API 키(API key)를 읽습니다. 이름이 export한 것과 정확히 일치해야 합니다 |
| `wire_api` | 공식 문서에 따르면 현재 `responses`만 지원하며, 생략 시에도 동일합니다 |

그런 다음 API 키를 환경 변수에 넣습니다:

<CodeGroup>
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows PowerShell"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
```
</CodeGroup>

## Codex 설치

다음 명령은 Codex 공식 문서에서 가져왔습니다:

<CodeGroup>
```bash title="npm"
npm install -g @openai/codex
```
```bash title="Homebrew"
brew install --cask codex
```
```bash title="macOS / Linux 脚本"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell title="Windows"
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
</CodeGroup>

## 자주 묻는 질문

<AccordionGroup>
<Accordion title="401？">

`env_key`에 작성된 변수 이름이 실제 export한 것과 일치하지 않거나, 환경 변수를 설정하기 전에 터미널을 열었습니다. 양쪽 이름을 다시 확인하고, 터미널을 다시 열어 재시도하세요.

</Accordion>
<Accordion title="wire_api를 chat으로 변경할 수 있나요?">

불가능합니다. Codex 공식 구성 문서에서 `wire_api`은(는) `responses`만 허용합니다. Chat Completions 인터페이스만 제공하는 서비스는 Codex에 연결하려면 별도의 프로토콜 변환 도구가 필요합니다.

</Accordion>
<Accordion title="GPT 모델을 어떻게 선택하나요?">

[모델 카탈로그](https://1zheai.com/model-catalog?lng=ko)에서 현재 모델을 확인하고, 모델 ID를 `model`에 입력하세요. Codex를 시작한 후 짧은 요청을 보내고, [호출 로그](/ko/docs/usage-logs/)에서 모델과 상태를 확인하세요.

</Accordion>
</AccordionGroup>