feat(odyssey): 消化《DeepSeek 官方 API 接入 Codex》素材,新增 1 素材页 + 5 实体页 + 1 主题页

This commit is contained in:
2026-09-15 07:10:34 +08:00
parent b0bbdb0a7b
commit 54c4b126b8
12 changed files with 426 additions and 9 deletions

View File

@@ -0,0 +1,67 @@
---
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 配置三件套]]