跳转到主要内容
OpenAI Codex 通过 Responses API 与 Tokios 通信。在 ~/.codex/config.toml 中将 Tokios 添加为模型提供商，指向 https://api.tokios.com/v1，Codex 即可通过你的私有隧道，在任意位置运行你自己的本地模型——支持 Ollama、LM Studio 或任何兼容 OpenAI 的后端。

​
前置条件

  • 已运行 Tokios 连接器并完成本地模型配对——参见 Connector install
  • 已注册模型部署名称——参见 Register a model
  • 已获取 Tokios API 密钥——参见 API Keys
  • 已安装 OpenAI Codex

​
Codex 配置

在环境中设置 Tokios 密钥，然后在 ~/.codex/config.toml 中添加 Tokios 提供商和配置文件：
~/.codex/config.toml
wire_api = "responses" 和 disable_response_storage = true 均为必需项。Tokios 以无状态方式提供 Responses 接口，因此 Codex 不能依赖服务器端的响应存储。
然后使用 Tokios 配置文件运行 Codex：
将 gemma-tunnel 替换为你在控制台中注册的公共部署名称。

​
使用 OpenAI Python SDK

要通过 OpenAI SDK 以编程方式调用本地模型，请将客户端指向 Tokios 基础 URL：
openai_tokios.py
OpenAI SDK 的基础 URL 必须以 /v1 结尾。Tokios 端点为 https://api.tokios.com/v1。

​
故障排除

你的 sk-tok-… 密钥缺失或错误。请确认环境中已设置 OPENAI_API_KEY，且 env_key = "OPENAI_API_KEY" 在 config.toml 中匹配。请在 Keys 标签页中检查密钥——密钥仅在创建时显示一次。
当前 model 在 config.toml 中与任何部署名称都不匹配。请在 Models 标签页中检查你注册的准确名称——名称区分大小写。
该部署的连接器已离线或已达到并发上限。请在 Connectors 标签页中检查——连接器需要显示为 Online，且运行连接器的机器必须处于开机状态。
请确认你在命令行中传递了 --profile tokios。如果不加该参数，Codex 会使用默认配置文件，指向 OpenAI 的托管 API。你也可以将 default_profile = "tokios" 放在 [general] 部分的 config.toml 中，使其成为默认配置。

​
后续步骤

Compatible clients

查看其他兼容 OpenAI 和 Anthropic 的客户端的基础 URL 和密钥设置。

API keys

为团队成员和代理创建、设置权限范围并轮换 sk-tok-… 密钥。