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

# 在 Codex App 中配置 Sub2API

> 通过 Codex App 图形界面将 Sub2API 设置为自定义 API 提供商，在桌面端体验 AI 编程助手功能。

Codex App 是 OpenAI 推出的桌面端 AI 编程助手。通过将 Sub2API 配置为自定义 API 提供商，你可以在桌面端使用 Sub2API 支持的 OpenAI、Claude、Gemini 等多种模型。

## 前置条件

* 已下载并安装 Codex App
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

## 配置步骤

<Steps>
  <Step title="打开 Codex App">
    启动 Codex App，进入主界面。
  </Step>

  <Step title="进入设置">
    点击菜单栏或侧边栏中的「设置」/「Settings」选项。

    <Note>
      TODO：请在后台确认实际配置后填写。（菜单路径可能因版本不同而有所变化，请以实际界面为准）
    </Note>
  </Step>

  <Step title="选择 API 提供商">
    找到「API Provider」或「API 提供商」设置项，选择「Custom」或「OpenAI Compatible」选项。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="填写 Base URL">
    在 Base URL 或 API URL 字段中输入：

    ```text theme={null}
    https://sub2api.ruilinlu.com
    ```

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="填写 API Key">
    在 API Key 或密钥字段中输入你的 Sub2API API Key。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="保存并测试">
    点击保存按钮，然后尝试发送一段简单的对话测试连接是否成功。
  </Step>
</Steps>

## 故障排查

<Accordion title="保存后无法连接">
  * 确认 Base URL 填写正确，应为 `https://sub2api.ruilinlu.com`
  * 检查 API Key 是否完整复制，无多余空格
  * 参考 [Base URL 配置](/configuration/base-url)
</Accordion>

<Accordion title="返回 401 错误">
  * 确认使用的是 Sub2API 控制台生成的 API Key
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="无法选择自定义 API 提供商">
  * 确保 Codex App 版本支持自定义 OpenAI 兼容 API
  * TODO：请在后台确认实际配置后填写。（已知版本兼容性信息）
</Accordion>