TokiLabsDocs
工具接入

Codex CLI

Codex CLI 是 OpenAI 的命令行编程助手。通过自定义 model provider，即可使用 Toki Labs 的 GPT 系列模型。

一个密钥可以调用所有模型。密钥只保存在你自己的浏览器里，不会上传到任何服务器。
Codex 属于 OpenAI 格式的工具，接口地址需要在末尾加 /v1，密钥与其他工具通用。

安装

Terminal / PowerShell
npm install -g @openai/codex

配置 config.toml

系统文件位置
Windows%USERPROFILE%\.codex\config.toml
macOS / Linux~/.codex/config.toml
config.toml
model_provider = "tokilabs"
model = "gpt-6.1-sol"

[model_providers.tokilabs]
name = "Toki Labs"
base_url = "https://api.tokilabs.xyz/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

用命令一键写入：

PowerShell
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
[IO.File]::WriteAllText("$HOME\.codex\config.toml", @'
model_provider = "tokilabs"
model = "gpt-6.1-sol"

[model_providers.tokilabs]
name = "Toki Labs"
base_url = "https://api.tokilabs.xyz/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@)
会覆盖已有的 config.toml，已有配置请手动合并。

设置密钥

env_key = "OPENAI_API_KEY" 表示 Codex 从这个环境变量读取密钥。如果还没设置：

PowerShell (设置后重开终端)
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的密钥", "User")

启动与切换模型

Terminal
codex
# 临时指定模型
codex -m gpt-6-sol

在会话中输入 /model 也可以切换。可用模型见 模型列表。

常见问题

  • 仍然要求登录 ChatGPT：确认 model_provider = "tokilabs" 写在文件最顶部（任何 [...] 段落之前）。
  • 401 / Missing API key：当前终端读不到 OPENAI_API_KEY，重开终端后执行 echo $OPENAI_API_KEY（PowerShell 用 $env:OPENAI_API_KEY）检查。
  • 模型不存在：检查模型名是否与 模型列表 完全一致。