本节汇总环境准备阶段的笔记与成果：Codex + DeepSeek 环境配置、Agent 使用日志模板。

1. Codex CLI 安装

1
2
3

npm install -g @openai/codex
codex --version
codex login          # 登录 OpenAI 账号

2. DeepSeek API 配置

在 platform.deepseek.com 创建 API Key，然后设置环境变量：

1

export DEEPSEEK_API_KEY="sk-..."

DeepSeek 提供 OpenAI 兼容接口，base URL 为 https://api.deepseek.com， 可用 curl 快速验证：

1
2
3
4

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"hello"}]}'

3. Codex 接入 DeepSeek（官方一键脚本）

DeepSeek-V4-Flash 原生支持 Responses API 格式，官方针对 Codex 做了适配，并提供一键配置脚本（推荐方式）。

前置条件：已安装 Codex CLI（或 ChatGPT 桌面端）并至少启动过一次，确保 ~/.codex 目录已存在。

第一步：备份现有配置（可选但推荐）

  • 一键脚本会自动备份到 ~/.codex/backup-deepseek/，但只留一份，重复运行会被覆盖
  • 如果 config.toml 里已经配置了 MCP server 或项目信任级别，手动做带时间戳的备份更稳妥：
1

cp ~/.codex/config.toml ~/.codex/config.toml.bak.$(date +%Y%m%d-%H%M%S)

提示文件不存在说明还没有配置文件，跳过即可，脚本会新建。

第二步：运行一键脚本

macOS / Linux：

1

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

Windows PowerShell：

1

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
  • 菜单里选择 deepseek-v4-flash
  • 首次运行会要求填写 sk- 开头的 API Key，去 platform.deepseek.com 获取
  • 脚本行为：自动备份原配置 → 写入模型目录 ~/.codex/models.json → 只修改 config.toml 的必要字段（保留你原有的 MCP server 等设置）→ 写入前先校验语法，校验失败会中止且不动任何文件

第三步：验证

  • 启动横幅显示 model: deepseek-v4-flash 即成功
  • 横幅上模型名后面的推理档位由 config.toml 里的 model_reasoning_effort 决定；接 DeepSeek 官方 API 时只能填 low / high / max 三档，没有 medium，也没有 xhigh
  • 如果横幅里没有 model 这一行：检查是否改配置前就启动的旧会话——Codex 只在启动时读配置，改完必须新开终端
  • ChatGPT 桌面端的模型选择器会显示 Custom，这是正常的：桌面端把所有本地配置的模型都显示成 Custom，实际运行的是 DeepSeek 模型
  • VS Code 插件与 CLI 共享配置，装上直接用

回滚

  • 重新运行脚本，菜单选选项 3，恢复到安装前状态
  • 或用第一步的备份手动还原：cp ~/.codex/config.toml.bak.xxxx ~/.codex/config.toml

注意事项

  • API Key 是明文存在 ~/.codex/config.toml 里的：不要提交到 Git，也不要在截图、录屏、分享配置时带出
  • 官方文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/codex/

4. Agent 使用日志模板

每天记录：用了什么工具 / 完成什么任务 / 哪里好用哪里坑 / 改进点。 后续会以笔记形式发布在站内。