Files
odyssey/wiki/entities/Codex 配置三件套.md

63 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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 编程工具接入]]