> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teio.me/llms.txt
> Use this file to discover all available pages before exploring further.
# Codex Desktop
> 在 Codex 桌面应用中配置 Teio API
> Codex 桌面客户端是 OpenAI 官方提供的独立 GUI 应用，提供图形化界面进行 AI 编程，无需使用命令行。
## 前置条件
* 已 [创建 API 密钥](/create-token)
## 安装
前往 [Codex 下载页面](https://openai.com/zh-Hans-CN/codex/)，下载对应系统的安装包，按提示完成安装。
## 配置
Codex 桌面客户端与 CLI 共享配置文件，如果你已经配置过 Codex CLI，桌面客户端会自动读取，无需重复配置。
通过 Teio 站点一键导入，无需手动复制 Key 和地址。需要先安装 [CC Switch](/cc-switch)。
1. 打开 Teio **密钥**页面，点击密钥右侧下拉按钮，选择 **"CC 切换"**
2. CC Switch 自动打开导入面板，补充供应商名称并选择模型
3. 点击"导入"完成
创建 `~/.codex/config.toml` 和 `~/.codex/auth.json`（Windows 路径为 `C:\Users\<用户名>\.codex\`）。
```bash theme={null}
mkdir -p ~/.codex
```
`config.toml`：
```toml theme={null}
model_provider = "teio"
model = "gpt-5.5" # [!code --]
model_reasoning_effort = "medium" # [!code --]
disable_response_storage = true
[model_providers.teio]
name = "teio"
base_url = "https://teio.me/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"
```
`auth.json`：
```json theme={null}
{
"OPENAI_API_KEY": "你的密钥"
}
```
## 使用
1. 启动 Codex 桌面客户端
2. 在对话框中输入编程需求，Codex 会直接在项目中读取和编辑代码
## 在 Codex 中使用 DeepSeek 模型
前置条件：需要安装 [CC Switch](/cc-switch)，并通过一键导入方式完成配置。
1. 在 Teio 密钥页面选择一键导入
2. 跳转到 CC Switch，确认并导入配置
3. 进入已导入配置的编辑页面
4. 展开高级选项，将**上游格式**设置为 **Chat Completions**
5. 在模型映射中获取模型列表，添加需要使用的 DeepSeek 模型并保存
6. 打开 CC Switch 设置页面
7. 开启对应路由，使配置生效
8. 返回 Codex 即可正常使用。使用期间请保持 CC Switch 运行
## 常见问题
三者共享相同的配置文件，功能基本一致。桌面客户端提供独立的图形化界面，适合不习惯命令行的用户。
不需要。桌面客户端会自动读取 `~/.codex/` 下的配置文件。
这通常表示模型映射没有生效。请确认 CC Switch 和 Codex 均已更新到最新版本，然后重新检查模型映射配置并开启对应路由。使用期间请保持 CC Switch 运行。
遇到其他问题？请参考 [常见问题](/faq)。