搜索文档...

开始输入以搜索文档

Codex
Codex CLI

OpenAI Codex CLI 配置指南

在 Windows、macOS 和 Linux 上安装 Codex CLI 并配合 Wanmo Test 配置。

概览

Codex CLI 是 OpenAI 面向终端的编程智能体。它通过沙箱化、可审阅的补丁读取、编写并运行代码。把自定义提供商指向 Wanmo Test 的基础 URL,即可使用目录中的任意模型。

快速配置

把这些粘贴到客户端。已登录时会自动填入你的密钥。

text
基础 URL: https://testapi.wanmo.ai/v1
API 密钥: YOUR_API_KEY

登录以自动填入您的 API 密钥

兼容性

Chat CompletionsResponses API流式传输工具调用

逐步设置

  1. 1
    安装 Codex CLI

    用 npm 全局安装 Codex CLI。

    bash
    npm install -g @openai/codex

    登录以自动填入您的 API 密钥

  2. 2
    配置模型提供商

    编辑 `~/.codex/config.toml`。设置模型 id,并用 responses 线路 API 添加一个指向 Wanmo Test 基础 URL 的自定义提供商。

    toml
    # ~/.codex/config.toml
    model = "YOUR_MODEL_ID"
    model_provider = "unorouter"
    
    [model_providers.unorouter]
    name = "UnoRouter"
    base_url = "https://testapi.wanmo.ai/v1"
    wire_api = "responses"
    env_key = "OPENAI_API_KEY"

    登录以自动填入您的 API 密钥

  3. 3
    导出你的 API 密钥

    导出 env_key 所指定的那个变量。Codex 从环境变量读取自定义提供方的密钥;auth.json 只用于登录 OpenAI。

    bash
    export OPENAI_API_KEY="YOUR_API_KEY"

    登录以自动填入您的 API 密钥

  4. 4
    启动 Codex

    在项目目录中运行 `codex`。

  5. 5
    Codex 桌面应用

    桌面应用读取同一个 `~/.codex/config.toml`,但从 Dock 或开始菜单启动时看不到你的 shell 变量。请在提供商配置块中用 `experimental_bearer_token` 代替 env_key 写入密钥,然后完全退出应用再重新打开。

    toml
    # ~/.codex/config.toml
    model = "YOUR_MODEL_ID"
    model_provider = "unorouter"
    
    [model_providers.unorouter]
    name = "UnoRouter"
    base_url = "https://testapi.wanmo.ai/v1"
    wire_api = "responses"
    experimental_bearer_token = "YOUR_API_KEY"

    登录以自动填入您的 API 密钥

powershell
$env:OPENAI_BASE_URL="https://testapi.wanmo.ai/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

登录以自动填入您的 API 密钥

适合 Codex CLI 的最佳免费模型

在这里可用的免费模型。把任意模型 id 粘贴到客户端即可。

注意事项

  • 出现端点不受支持的错误时,确认 `wire_api` 为 `responses`,且基础 URL 以 `/v1` 结尾。
  • 如果请求处于未认证状态,请检查 env_key 指定的变量在运行 codex 的 shell 中是否真的已经导出。
  • 你不能把保留 ID openai 复用给自定义提供方。换成其他任意 ID 都可以,无论是在 model_providers 中还是在 model_provider 中。
  • 桌面应用的模型选择器显示 OpenAI 模型,以及一个对应你顶层模型的 Custom 条目。要切换模型,请修改 config.toml 中的 `model` 并重启应用。

相关文章

生成 API 密钥模型