index

Codex 接入 DeepSeek

将 DeepSeek 配置为模型提供方

DeepSeek 官方提供了两种接入方式,推荐优先使用方式一。

方式一:一键配置脚本(推荐)

macOS / Linux,在终端执行:

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

Windows,在 PowerShell 中执行:

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

运行后按菜单提示选择要使用的模型,首次运行会要求输入你的 API Key。

我们第一次运行,选择 1 选项 修改 Codex 配置,使用 deepseek-v4-flash 模型:

|700x171
|700x171

后期我们要恢复默认配置,也可以执行这个脚本,并选择 3 来恢复。

接下来会提示 API key 输入,如果已经在环境变量中配置过会使用环境变量 DEEPSEEK_API_KEY 提供的 API key,跳过询问:

|700x374
|700x374

之后重新 ChatGPT,就可以看到 DeepSeek 的模型了:

|700x405
|700x405

这个脚本会自动完成以下工作:

  • 备份现有配置:把 ~/.codex/config.toml 备份到 ~/.codex/backup-deepseek/,方便随时还原。

  • 写入模型目录 ~/.codex/models.json:向 Codex 声明 DeepSeek 模型的元数据(上下文窗口长度、支持的推理强度档位、工具调用格式等),使 Codex 能像调用内置模型一样调用 DeepSeek。

  • 修改 ~/.codex/config.toml:只改写必要字段(见下文字段说明),新增 [model_providers.deepseek] 配置段,原有的 MCP 服务器、项目信任级别等配置都会保留,若发现有冲突字段会自动删除并打印删除原因。

  • 语法校验:写入前会先校验 config.toml / models.json 的合法性,校验不通过则中止,不会破坏原有文件。

之后随时可以再次运行该脚本,用来切换模型,或者恢复到安装前的默认配置(菜单里的第 3 项)。

友链

冬月
冬月

分享自己的一些学习心得和生活琐事