---
title: Codex CLI 接入
description: OpenAI Codex CLI 接入 1折AI 的配置方法（~/.codex/config.toml 的 model_providers），通过 Responses 接口调用 GPT 模型。
---

OpenAI / GPT 模型已上线。Codex CLI 使用 OpenAI Responses 接口（`/v1/responses`），通过本站 API 密钥接入。可用模型与价格见[模型目录](https://1zheai.com/model-catalog)。

下面先把 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)查看当前模型，并把模型 ID 填入 `model`。启动 Codex 后发起简短请求，在[调用日志](/docs/usage-logs/)中核对模型和状态。

</Accordion>
</AccordionGroup>