> ## Documentation Index
> Fetch the complete documentation index at: https://docs.okab.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> 安装客户端，保存控制台生成的配置与模型目录

推荐通过 [CC Switch](https://docs.okab.ai/integrations/cc-switch.md) 导入。手动配置按以下步骤操作。

## 安装

安装 Node.js 和 npm 后运行：

```bash theme={"system"}
npm install -g @openai/codex
codex --version
```

系统要求与其他安装方式见 [官方安装说明](https://developers.openai.com/codex/cli/)。

## 保存配置和模型目录

1. 在控制台对应服务的 **访问密钥** 列表中，点击 **使用 → 客户端配置**，选择 **Codex** 和操作系统。
2. 在 **Codex 模型目录** 中点击 **获取目录**，选择可用模型。
3. 按窗口显示的路径保存生成的配置；已有文件先备份并合并。`config.toml` 的顶层字段放在任何 `[表名]` 之前，避免重复字段或表。
4. 点击 **下载目录**，把 `codex-models.json` 保存到配置中 `model_catalog_json` 指向的位置。

默认配置目录为 `~/.codex/`，Windows 为 `%USERPROFILE%\.codex\`。设置过 `CODEX_HOME` 时使用该目录，并同步修改 `model_catalog_json`；WSL 使用 WSL 用户目录。详见 [官方配置说明](https://developers.openai.com/codex/config-basic/)。

不同密钥和认证模式生成的内容可能不同，按控制台显示保存文件或设置环境变量。若生成了 `auth.json`，但之前使用系统凭据存储，按 [官方认证说明](https://developers.openai.com/codex/auth/) 在 `config.toml` 顶层设置：

```toml theme={"system"}
cli_auth_credentials_store = "file"
```

地址以控制台为准，不要重复追加 `/v1` 或 `/responses`。可用模型变化后，重新获取并下载目录，替换本地文件。

## 验证

重启 `codex`，发送“只回答 OK”，在 [仪表盘](https://console.okab.ai/usage) 的 **调用记录** 核对请求。请求失败见 [常见问题](https://docs.okab.ai/troubleshooting.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.