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

# Codex Desktop

> 在 Codex Desktop 中使用 4096bytes 接入参数

Codex Desktop 使用和 Codex CLI 相同的本机配置。你需要先安装 Codex Desktop，然后把控制台生成的 `config.toml` 和 `auth.json` 写入 Codex 配置目录。

如果你已经按 [Codex](/clients/codex) 页面完成配置，可以直接打开或重启 Codex Desktop。无需重新创建 API Key。

## 准备工作

* 已完成 [创建账号](/quickstart/create-account)。
* 已完成 [获取 API Key](/quickstart/get-api-key)。
* 已安装 Codex Desktop。
* 已从控制台打开目标 API Key 的 **使用密钥** 弹窗。

<Warning>
  `auth.json` 中的 API Key 是明文保存的本机凭证。不要把 `~/.codex/auth.json`、截图或终端输出提交到仓库，也不要发到聊天工具里。
</Warning>

## 安装客户端

请从 [OpenAI Codex app 文档](https://developers.openai.com/codex/app) 下载并安装 Codex Desktop。安装完成后打开应用，并按应用提示完成初始设置。

如果你的系统暂时没有 Codex Desktop 安装入口，可以先使用 [Codex CLI](/clients/codex) 完成命令行接入。

## 从控制台复制配置

<Steps>
  <Step title="进入 API 密钥页面">
    打开控制台，进入 **API 密钥** 页面。
  </Step>

  <Step title="选择 Codex CLI">
    找到要给 Codex Desktop 使用的 Key，点击 **使用密钥**，然后选择 **Codex CLI**。
  </Step>

  <Step title="选择系统">
    按你的电脑选择 **macOS / Linux** 或 **Windows**。控制台会显示对应配置文件路径。
  </Step>

  <Step title="写入本机配置">
    按 [Codex](/clients/codex) 页面中的对应系统步骤写入 `config.toml` 和 `auth.json`。
  </Step>

  <Step title="重启 Codex Desktop">
    保存配置后，完全退出并重新打开 Codex Desktop。
  </Step>
</Steps>

## 配置文件位置

| 系统            | `config.toml`                      | `auth.json`                      |
| ------------- | ---------------------------------- | -------------------------------- |
| macOS / Linux | `~/.codex/config.toml`             | `~/.codex/auth.json`             |
| Windows       | `%USERPROFILE%\.codex\config.toml` | `%USERPROFILE%\.codex\auth.json` |

如果你在 WSL 中使用 Codex，请配置 WSL 用户目录下的 `~/.codex/`，不要只改 Windows 用户目录。

`model`、`review_model`、`base_url` 和 API Key 都以控制台显示为准。字段含义见 [Codex](/clients/codex) 页面。

## 验证

打开 Codex Desktop，选择一个本地项目，然后发送一个低风险任务：

```text theme={null}
请用一句话说明当前项目用途，不要修改文件。
```

如果 Codex Desktop 可以正常回复，并且没有认证失败或找不到模型的错误，说明配置已生效。

## 常见问题

<AccordionGroup>
  <Accordion title="我已经配置过 Codex CLI，还需要重复配置吗？">
    不需要。Codex Desktop 读取同一套 `~/.codex/` 配置。完全退出并重新打开 Codex Desktop 即可。
  </Accordion>

  <Accordion title="Codex Desktop 仍然使用旧模型或旧地址">
    确认新的配置放在 `config.toml` 文件开头。保存后完全退出 Codex Desktop，再重新打开。
  </Accordion>

  <Accordion title="Codex Desktop 报认证失败">
    检查 `auth.json` 是否是合法 JSON。确认 API Key 没有漏字符、换行或多余空格。
  </Accordion>

  <Accordion title="Codex Desktop 找不到模型">
    `model` 和 `review_model` 必须使用控制台显示的模型名。不要直接复制其他用户截图里的模型名。
  </Accordion>
</AccordionGroup>