在 Paseo 中同时使用 OpenAI Codex 与 DeepSeek

发表于 分类于 阅读次数：

今天（2026 年 7 月 31 日），DeepSeek 更新了 DeepSeek-V4-Flash 的正式版本，官方公告如下：

deepseek-v4-flash 原生支持 Responses API 并完全适配 Codex（配置细节见官方文档），正好可以直接接进 Paseo 使用。

Paseo 内置支持 Codex。通过派生 Provider，可以在保留官方 OpenAI GPT 的同时，增加一个使用 DeepSeek 的 Codex Provider。

最终效果：

  • Codex：使用 OpenAI GPT 和 Codex 登录状态。
  • Codex (DeepSeek)：使用 DeepSeek 或兼容 Responses API 的网关。
  • 两个 Provider 在 Paseo 中独立显示，可以按任务选择。

1. 配置 Paseo

Paseo 配置文件位置：

  • 正常安装：~/.paseo/config.json
  • 仓库开发环境：.dev/paseo-home/config.json

加入两个 Provider：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
  "version": 1,
  "agents": {
    "providers": {
      "codex": {
        "enabled": true,
        "order": 10
      },
      "codex-deepseek": {
        "extends": "codex",
        "label": "Codex (DeepSeek)",
        "description": "Codex using DeepSeek",
        "order": 20,
        "env": {
          "OPENAI_BASE_URL": "https://api.deepseek.com",
          "OPENAI_API_KEY": "<your-api-key>"
        },
        "models": [
          {
            "id": "deepseek-v4-flash",
            "label": "DeepSeek",
            "isDefault": true
          }
        ]
      }
    }
  }
}

重载 Paseo 配置后，Provider 列表中会同时出现：

1
2
Codex
Codex (DeepSeek)

其中：

  • Codex 使用 OpenAI 登录和 GPT 模型。
  • Codex (DeepSeek) 继承 Paseo 的 Codex adapter，但使用独立的 API 地址、密钥和模型。

有了 codex-deepseek 配置后，DeepSeek 所需信息已经由 Paseo 注入 Codex app-server：

  • OPENAI_BASE_URL
  • OPENAI_API_KEY
  • 模型 ID
  • model_provider 和 model_providers

因此：

  • ~/.codex/config.toml 只需保留标准 OpenAI Codex 配置，甚至可以不配置，完成 codex login 即可。
  • ~/.codex/deepseek.config.toml 不是 Paseo 所必需的。
  • 只有想在终端直接运行 codex --profile deepseek 时，才需要 DeepSeek profile。

最简结构就是：

1
2
3
4
5
OpenAI Codex
└── codex login

Paseo DeepSeek
└── ~/.paseo/config.json 中配置 codex-deepseek

2. （可选）配置 DeepSeek Codex Profile（仅终端使用）

以下配置只影响在终端直接运行 codex --profile deepseek，Paseo 不依赖它。

如果需要在终端中直接使用 DeepSeek，创建：

1
~/.codex/deepseek.config.toml

示例：

1
2
3
4
5
6
7
8
9
model = "deepseek-chat"
model_provider = "deepseek"

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com/v1"
wire_api = "responses"
env_key = "DEEPSEEK_API_KEY"
requires_openai_auth = false

设置 API Key：

1
export DEEPSEEK_API_KEY="<your-api-key>"

运行：

1
codex --profile deepseek

如果使用代理或内部网关，将 base_url 和模型 ID 替换为网关提供的值。该接口必须兼容 OpenAI Responses API。

3. 排查问题

检查 Codex 是否可用：

1
codex --version

检查 DeepSeek profile：

1
codex --profile deepseek

检查 Paseo Provider：

1
2
npm run cli -- provider ls
npm run cli -- provider models codex-deepseek

查看开发环境日志：

1
tail -f .dev/paseo-home/daemon.log

生产环境日志通常位于：

1
tail -f ~/.paseo/daemon.log

如果 DeepSeek Provider 可见但模型不可选，确认 Paseo 配置中的模型 ID 与 DeepSeek profile 使用的模型 ID 一致。