Codex CLI 是 OpenAI 开源的终端 AI 编程 Agent。很多教程默认它只能连 OpenAI 官方接口实际上 Codex 本身只是一个执行框架模型服务完全可以在配置里替换你可以接 DeepSeek 官方 API也可以接本机 Ollama 跑起来的本地模型还可以接任意 OpenAI 兼容的第三方接口服务。只要配置里的 base_url 指向你能访问的服务Codex 在国内网络条件下就能正常启动和使用。Codex CLI 本身开源免费真正要花钱的只有模型 API 费用而且 DeepSeek 很便宜Ollama 更是完全本地推理这就是“零成本”的实际含义。下面按真实落地顺序拆一遍环境准备、DeepSeek 接入、Ollama 接入、第三方接口接入以及我最常遇到的 endpoint 报错和排查方法。1. 先搞清楚 Codex CLI 是什么以及为什么它能接 DeepSeek 和 Ollama1.1 Codex CLI 的定位一个跑在本地终端里的 Agent 执行框架Codex CLI 和 Claude Code、Trae CLI 是一类东西把大模型的能力搬进终端让模型能读文件、看仓库结构、执行命令、修改代码而不是只在对话框里聊天。你给它一个任务它会自己规划步骤调用工具把结果写回文件。这类工作方式现在一般叫 Agent也就是“代理式任务执行”。桌面端这个词的意思很简单它装在你自己的电脑上在终端里运行不依赖网页版 IDE也不需要把整个项目上传到某个云平台。对开发者来说这意味着本地仓库、本地命令、本地 Git 操作都可以被同一个 Agent 串联起来。Codex CLI 的官方定位是 OpenAI 出的开源工具但开源意味着你可以改、可以配、可以换后端。它本质上是一个 Agent 执行框架或者按社区里的说法是一个 harness。harness 负责任务拆解、上下文管理、工具调用循环真正产生能力的是背后那个模型。所以模型换成 DeepSeek、Qwen、Ollama 里跑的任何模型逻辑上都成立。1.2 核心原理OpenAI 兼容接口让模型服务可以被替换Codex CLI 和模型服务之间走的是 HTTP 接口。默认配置下它访问的是 OpenAI 官方接口所以很多人以为这个工具只能在 OpenAI 生态里用。实际上Codex 对模型服务的要求是“OpenAI 兼容”。只要一个服务能提供兼容的接口格式Codex 就能把它当成模型后端。DeepSeek 官方 API 是 OpenAI 兼容的Ollama 从某个版本开始也提供/v1的 OpenAI 兼容接口市面上大量第三方聚合服务同样如此。配置里最核心的两个字段是base_url和wire_api。base_url是模型服务的地址。DeepSeek 的地址指向 DeepSeek APIOllama 的地址通常是http://127.0.0.1:11434/v1第三方服务写它给你的域名。wire_api是 Codex 用哪种接口格式和模型服务通信。新版 Codex 默认会走/responses这个接口也就是 OpenAI 的 Responses API。但 DeepSeek、Ollama 和大部分第三方服务只兼容/chat/completions也就是 Chat Completions API。所以配置里通常要显式写成wire_api chat否则 Codex 会往一个不存在的接口发请求然后报错。很多人配置半天不生效问题就出在这里框架没理解模型服务是什么接口格式决定了你怎么填配置。2. 开始之前环境、模型服务和三个必查项2.1 环境要求终端、Git、Node 与可用的模型端点先别急着装 Codex把基础环境过一遍。操作系统方面Windows、macOS、Linux 都能跑安装方式略有差异。你至少需要一个能打开终端的环境这是前提。Git 建议提前装好。Codex 作为 Agent经常会读 Git 状态、看 diff、帮你提交变更。如果机器上连 Git 都没有很多仓库级任务会跑不通。Node 环境要看你下载的 Codex 版本。早期 Codex CLI 通过 npm 发布需要 Node.js后来官方也有 Rust 实现的版本安装方式不同。这里不纠结具体版本我的建议是去官方仓库看 README 的安装说明挑一种适合你系统的装法。# 以 npm 方式安装为例具体以官方 README 为准 npm install -g openai/codex codex --version然后是模型端点。你至少要有一个能访问的模型服务地址DeepSeek 官方 API需要一个 API Key。Ollama本机服务地址是http://127.0.0.1:11434。第三方兼容接口服务商给你 base_url 和 Key。如果你的电脑配置一般只想先体验 Codex建议直接走 DeepSeek API普通笔记本完全够用。2.2 DeepSeek、Ollama、第三方兼容接口三条路怎么选这三条路各有适用场景不要只看“免费”还是“付费”。路径成本需要什么适合谁DeepSeek 官方 API按量计费价格很低具体以官方价格页为准注册开放平台申请 API Key想立刻体验复杂任务仓库级改动也能顶住本地 Ollama不花 API 费用但消耗本机电费和硬件安装 Ollama下载模型权重代码不想出本机或想完全离线使用第三方兼容接口看服务商定价注册获取 base_url 和 Key需要特定模型或想一个 Key 用多个模型我的选择逻辑很简单先看任务复杂度。如果只是让 Agent 写一个函数、解释一段代码本地小模型就能干如果要做多文件重构、跨模块排查直接上 DeepSeek API如果有特殊模型需求再考虑第三方接口。不要一上来就把所有路径都配一遍先选一条跑通。2.3 先用 curl 确认端点真的通再进 Codex很多 Codex 报错其实不是 Codex 的问题而是模型服务的端点本身有问题。所以我会先绕开 Codex直接用 curl 打一下端点确认服务可达、Key 有效。DeepSeek 官方开放平台的文档里API 地址通常会给出https://api.deepseek.com和https://api.deepseek.com/v1两种写法两者都可以兼容 OpenAI 接口。先测一下curl https://api.deepseek.com/v1/models \ -H Authorization: Bearer $DEEPSEEK_API_KEY如果返回一段 JSON里面有模型列表说明端点通、Key 有效。Ollama 这边更简单curl http://127.0.0.1:11434/v1/models如果提示 connection refused说明 Ollama 服务没启动或者端口不对。这一步能帮你把“网络问题”和“Codex 配置问题”区分开。3. 把 Codex CLI 接到 DeepSeek最省事的入门路径3.1 安装 Codex CLI 并找到配置文件Codex CLI 装好之后第一次运行会在用户目录下创建配置文件夹。macOS / Linux~/.codex/Windows%USERPROFILE%\.codex\里面最重要的两个文件是config.toml和auth.json。不同版本读取的配置不一样新版一般读config.toml老版本可能读auth.json还有的版本同时支持。如果你发现改了某个文件不生效就去看看另一个。我的建议是先运行一次codex让它自己生成默认配置再去改。手动创建配置目录容易漏字段。3.2 在配置里声明 DeepSeek 模型提供方打开~/.codex/config.toml把内容改成下面这样model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY wire_api chat逐行解释一下。model是 Codex 默认使用的模型名。DeepSeek 官方的对话模型叫deepseek-chat还有一个推理模型叫deepseek-reasoner可以按任务切换。model_provider指定默认使用哪一个模型提供方和下面的[model_providers.deepseek]对应。base_url是模型服务地址这里填 DeepSeek 的 OpenAI 兼容地址。env_key告诉 Codex 从哪个环境变量里读取 API Key。这样 Key 不会写死在配置文件里避免误传到 Git 仓库。wire_api chat是关键。DeepSeek 目前兼容的是 Chat Completions 接口不是 Codex 默认的 Responses 接口必须显式切过来。设置环境变量export DEEPSEEK_API_KEYsk-你的keyWindows 下可以setx DEEPSEEK_API_KEY sk-你的key设置完建议重开一个终端窗口确保环境变量生效。如果你的 Codex 版本比较老可能不读config.toml而是读auth.json{ OPENAI_API_KEY: sk-你的key, OPENAI_BASE_URL: https://api.deepseek.com/v1 }两种配置方式在不同版本里都存在认准你自己版本支持的那一种。3.3 跑通第一条对话并判断成功标准配置完成后直接运行codex 用 Python 写一个读取 CSV 并统计每列空值的脚本Codex 会进入 Agent 模式先展示它的计划然后尝试写文件或直接给出代码。成功标准有三个能看到模型输出而不是立刻报错退出。没有 401 或 unauthorized 提示说明 API Key 有效。能继续追问说明 Agent 会话正常。如果第一条就断了先看终端里的报错类型再回到上一步的 curl 测试确认端点。别急着改参数先把链路打通。4. 接入本地 Ollama真正不花 API 费用的本地玩法4.1