Ollama Codex CLI

Codex CLI 是 OpenAI 的终端编码代理。它内置了 --oss 参数（OSSM = open source models），本来就为接本地模型准备好了入口。

版本基线 v0.40.12，官方 docs.ollama.com/integrations/codex。

一、安装

npm install -g @openai/codex

想用桌面版 ChatGPT 里的 Codex 模式，见 12.10 Ollama ChatGPT Desktop。

二、上下文：必须 ≥ 64k

Codex 是本篇所有集成里对上下文要求最高的之一，至少 64k tokens。这是硬门槛，调不够会表现为模型无响应或提前截断。

OLLAMA_CONTEXT_LENGTH=65536 ollama serve

三、快速启动

ollama launch codex

通过 ollama launch codex 启动时，Ollama 会刷新模型目录，并为这次会话使用独立的 Codex profile。

会话内切换模型

在 Codex 里输入 /model 即可在已安装的、支持工具调用的 Ollama 模型之间切换，不用重启。

设计上有几个细节值得注意：

• 起始模型保持选中状态
• 每个模型保留各自的上下文窗口、视觉、思考设置
• 想让它出现在选择器里，启动前先 ollama pull <model>

只配置不启动：

ollama launch codex --config

清除 Ollama 的 profile 和生成的模型目录：

ollama launch codex --restore

四、手动配置：最简路径

直接用 --oss：

codex --oss

指定模型：

codex --oss -m gpt-oss:120b

云端模型加 -cloud 后缀：

codex --oss -m gpt-oss:120b-cloud

五、持久化配置：profile 方式

想每次都用同一套配置，创建 ~/.codex/ollama-launch.config.toml：

model = "gpt-oss:120b"
model_provider = "ollama-launch"
model_catalog_json = "/Users/you/.codex/model.json"

[model_providers.ollama-launch]
name = "Ollama"
base_url = "http://localhost:11434/v1/"
wire_api = "responses"

然后：

codex --profile ollama-launch

四个字段的作用：

六、联网搜索

通过 Ollama profile 发出的联网搜索请求，由 Ollama 执行，本地和云端模型都一样。需要 ollama signin。

单次会话禁用联网搜索：

codex --profile ollama-launch -c 'web_search="disabled"'

常见问题

动手试

## ① 拉一个带 tools 能力的模型
ollama pull gpt-oss:120b

## ② 启动并自动配置
ollama launch codex

## ③ 进去后切换模型
## /model