Files
odyssey/wiki/topics/AI 编程工具接入.md

49 lines
2.7 KiB
Markdown
Raw 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]
---
# AI 编程工具接入
> 把外部模型接进 Codex 这类编程 Agent 的配置路径、兼容层机制与成本考量。
## 核心观点
1. **接入的本质是换 provider,不是改客户端**。因为 [[Codex]] 的模型调用遵循 [[OpenAI 兼容 API]],只要服务端兼容,改配置文件即可换模型,全程不需要中间件或胶水代码。
2. **配置是耦合的一整套,不是单点开关**。`auth.json`(授权)、`config.toml`(provider 与模型声明)、`deepseek-models.json`(模型目录映射)三件套必须同时到位,缺一项链路就不成立。
3. **兼容层保证「能调通」,不保证「体验一致」**。CLI 端能自动识别模型并推荐 [[DeepSeek V4 Flash]];桌面端则显示 `Custom`,部分参数(思考强度滑块)可见性下降,但执行核心逻辑不受影响。
4. **成本是接入决策的主要变量之一**。素材给出的实测是单次任务交互计费「仅需 0.02」。
<!-- confidence: AMBIGUOUS -->
## 素材汇总
| 素材 | 核心贡献 | 详见 |
|------|----------|------|
| DeepSeek 官方 API 接入 Codex | 给出三文件配置法、V4 Flash 的实机表现与成本观察 | [[wiki/sources/2026-09-15-deepseek官方api接入codex]] |
## 关键概念
- [[Codex]] — 被接入的编程 Agent,接入点是 `.Codex` 目录下的配置
- [[DeepSeek]] — 提供兼容 API 的服务方,预付费制
- [[DeepSeek V4 Flash]] — 本次接入的模型
- [[OpenAI 兼容 API]] — 让「换 provider」成立而不必改代码的协议接缝
- [[Codex 配置三件套]] — provider 声明与模型参数的主配置文件
## 未解决的问题
- **计费口径不明**:素材只说「仅需 0.02」,未标货币单位,也未说明按 token 还是按会话计价,无法与其他模型做严格的成本对比。
- **key 的双写关系不明**:`auth.json` 的 `OPENAI_API_KEY` 与 `config.toml` 的 `experimental_bearer_token` 是各自独立生效还是任一即可,原文未说明。
- **桌面端降级的影响面未验证**:模型显示 `Custom`、思考强度滑块不可验证,是否代表实际能力或参数被裁剪,素材只给了「不影响核心逻辑」的定性判断。
- **`deepseek-models.json` 的内容与来源**:素材只给了网盘与备用下载链接,未说明文件内容结构,也未说明能否自行手写。
- **多 provider 共存可行性**:一套 `config.toml` 是否能同时声明多个兼容 provider 并按需切换,未涉及。
## 相关页面
- [[OpenAI 兼容 API]]
- [[Codex]]
- [[DeepSeek]]
- [[Codex 配置三件套]]
- [[多 Agent 工作流编排]]