68 lines
4.3 KiB
Markdown
68 lines
4.3 KiB
Markdown
---
|
||
tags: [素材摘要]
|
||
created: 2026-09-15
|
||
updated: 2026-09-15
|
||
sources: [raw/notes/2026-09-15-deepseek官方api接入codex.md]
|
||
source_type: notes
|
||
source_path: raw/notes/2026-09-15-deepseek官方api接入codex.md
|
||
images: 0
|
||
image_paths: []
|
||
---
|
||
|
||
# DeepSeek 官方 API 接入 Codex
|
||
|
||
> DeepSeek 官方支持 OpenAI 兼容 API 后，改 `.Codex` 目录下三个配置文件即可把 DeepSeek V4 Flash 接进 Codex，无需任何中间件，实测单次任务成本极低。
|
||
|
||
## 基本信息
|
||
|
||
- **来源类型**：笔记（视频教程剪藏，作者 DP / dpit.lib00.com，视频时长 08:12）
|
||
- **原文位置**：raw/notes/2026-09-15-deepseek官方api接入codex.md
|
||
- **原始链接**：https://dpit.lib00.com/zh/content/1251/ultimate-guide-connect-deepseek-official-api-to-codex-using-the-v4-flash-model
|
||
- **素材日期**：2026-09-02
|
||
- **消化日期**：2026-09-15
|
||
- **敏感信息处理**：原文含 1 个 DeepSeek API Key（出现 3 处），入库前已统一替换为 `sk-xxxxxxxx`
|
||
- **图片**：0 张（文中的 `![[deepseek-models.json]]` 是 Obsidian 文件嵌入，不是图片）
|
||
|
||
## 核心观点
|
||
|
||
1. **前提是 DeepSeek 官方支持了 OpenAI 兼容类型的 API**。这是整条链路成立的根因：客户端只要认 OpenAI 协议，就能把 DeepSeek 当成 provider 接进去，不需要为 DeepSeek 单独写适配。
|
||
2. **接入成本集中在三个配置文件**（位于用户根目录下的 `.Codex` 隐藏文件夹）：`auth.json` 负责授权、`config.toml` 负责声明 provider 与模型、`deepseek-models.json` 负责模型目录映射，且该 JSON 必须直接放在 `.Codex` 目录最底层，不能套多余的文件夹。
|
||
3. **`config.toml` 是最关键的一步**。provider 名可以自定义（素材里叫 `DPWorking`），但 `wire_api = "responses"`、`requires_openai_auth = true`、`base_url = "https://api.deepseek.com/v1"` 这些兼容语义字段必须对齐；API key 在 `auth.json` 与 `config.toml` 里各写一份。
|
||
4. **实机可用，且 CLI 表现优于桌面端**。CLI 里 Codex 能自动识别 Flash 与 Pro 模型，V4 Flash 对 Codex 的兼容性更好，被推荐为日常开发首选；桌面端 APP 模型会显示为 `Custom`，思考强度滑块的实际作用无法直观验证，但代码生成与执行表现稳定。
|
||
5. **成本极低是主要卖点**。教材给出的实测数据是「一次完整的任务交互后计费刷新显示仅需 0.02」。
|
||
<!-- confidence: AMBIGUOUS -->
|
||
|
||
## 关键概念
|
||
|
||
- [[Codex]] — 被接入的编程 Agent，接入点是 `.Codex` 目录下的配置
|
||
- [[DeepSeek]] — 提供 API 与模型的开放平台，预付费制
|
||
- [[DeepSeek V4 Flash]] — 本次接入的模型，`model = "deepseek-v4-flash"`
|
||
- [[OpenAI 兼容 API]] — 让这次接入「不需要胶水代码」的协议约定
|
||
- [[Codex 配置三件套]] — provider 声明与模型参数的主配置文件
|
||
|
||
## 与其他素材的关联
|
||
|
||
- 与 [[Hermes API Server]] 的关系：本素材讲的是「**作为客户端**接入一个 OpenAI 兼容服务」，另一篇素材讲的是「**作为服务端**对外提供 OpenAI 兼容端点」。两者是同一协议约定的两侧实现，共同构成 [[OpenAI 兼容 API]] 的完整图景。
|
||
<!-- confidence: INFERRED -->
|
||
- 与 [[多 Agent 工作流编排]] 的关系：编排侧的素材讨论「多个 Agent 怎么串起来」，本素材讨论「单个编程 Agent 怎么换模型」。两者目前没有直接的内容重叠，暂不做横向对比。
|
||
<!-- confidence: INFERRED -->
|
||
- 同批 nexus 笔记中还有《Codex接入阿里云百炼Token Plan配置方法》，题材高度同构（同一个 Codex，换一个 provider），消化后可考虑做成对比页。
|
||
|
||
## 原文精彩摘录
|
||
|
||
> 随着 DeepSeek 官方正式支持了 OpenAI 兼容类型的 API, 开发者迎来了更多的集成可能.
|
||
|
||
> 这一步最关键. 你需要对应修改 `provider` (如自定为 DPWorking), 将 `model` 指定为 `Deepseek V4 Flash`, 调整 `URL` 为 DeepSeek API 官方接口地址, 并将你的 API key 再次同步更新.
|
||
|
||
> CLI 里 Codex 能够自动识别出 `Flash` 和 `Pro` 模型. 由于 V4 Flash 模型对 Codex 的兼容性更好, 推荐作为日常开发首选.
|
||
|
||
> 一次完整的任务交互后, 系统计费刷新显示仅需 **0.02**, 彰显了 DeepSeek 的极致性价比.
|
||
|
||
## 相关页面
|
||
|
||
- [[AI 编程工具接入]]
|
||
- [[Codex]]
|
||
- [[DeepSeek V4 Flash]]
|
||
- [[OpenAI 兼容 API]]
|
||
- [[Codex 配置三件套]]
|