---
tags: [实体, 工具, 配置]
created: 2026-09-15
updated: 2026-09-15
sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
---

# Codex 配置三件套

> Codex 接入第三方模型的配置三件套：`auth.json` 授权、`config.toml` 声明 provider 与模型、`deepseek-models.json` 做模型目录映射。

## 简介

素材把接入 DeepSeek 拆成三个文件（都在 `.Codex` 目录下），其中 `config.toml` 被明确点名为「这一步最关键」——它承担的不是填个 key 这么简单的事，而是**向 Codex 声明一个新的模型 provider 并指定其协议语义**。本页把三件套一并记录，便于对照。

## 关键信息

- **类型**：工具（配置文件）
- **所属**：[[Codex]]
- **位置**：用户根目录下的 `.Codex` 隐藏文件夹
- **相关概念**：[[OpenAI 兼容 API]]、[[DeepSeek V4 Flash]]

## 详细内容

素材给出的配置片段（API key 已脱敏；`...` 表示原文此处省略的其余默认内容）：

```toml
model_provider = "DPWorking"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"

...

model_catalog_json = "deepseek-models.json"

[model_providers.DPWorking]
name = "OpenAI"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.deepseek.com/v1"
experimental_bearer_token = "sk-xxxxxxxx"
```

要点：

1. **两层配置**：顶层 `model_provider` / `model` 决定用哪家、哪个模型；`[model_providers.<名字>]` 段定义该 provider 怎么调。
2. **provider 名可自定义**：`DPWorking` 是演示用的命名，替换成任意标识皆可，只需与顶层 `model_provider` 一致。
3. **`wire_api = "responses"` + `requires_openai_auth = true`**：声明走 OpenAI 兼容语义，这是 [[OpenAI 兼容 API]] 概念在图中的落点。
4. **`base_url`** 指向 DeepSeek 官方端点 `https://api.deepseek.com/v1`；换成别的兼容服务只改这一行。
5. **key 写两处**：`experimental_bearer_token`（本文件）与 `auth.json` 的 `OPENAI_API_KEY` 各写一份。
6. **`model_catalog_json`** 指向同目录下的 `deepseek-models.json`，负责模型目录映射。

## 不同素材中的观点

暂无其他素材讨论该文件。

## 相关页面

- [[Codex]]
- [[OpenAI 兼容 API]]
- [[DeepSeek V4 Flash]]
- [[AI 编程工具接入]]