文档

Codex 配置

按量付费的 MiMo API 和 Token Plan 均支持 Codex,可参考本文进行配置与使用。

前置工作

获取凭证

支持两种使用方式,但对应的凭证获取方式不同:

使用方式 说明 获取方式(以下为 BASE_URL 和 API Key 均为示例)
按量付费 API 调用 按实际使用量计费,适合轻度使用
  • BASE_URL
    • OpenAI 兼容协议:https://api.xiaomimimo.com/v1
  • API Key
    • 格式:sk-xxxxx

前往 API Keys 创建 API Key
Token Plan 固定订阅费,按套餐限量调用
  • BASE_URL
    • OpenAI 兼容协议:https://token-plan-cn.xiaomimimo.com/v1
  • API Key
    • 格式(个人版):tp-xxxxx
    • 格式(团队版):ttp-xxxxx

成功订阅后,前往 Token Plan 获取专属 Base URL 和 API Key

安装 Codex

前置要求: 需先安装 Node.js 18 或更新版本

安装命令:

npm install -g @openai/codex

验证安装(如有版本号输出,则表示安装成功):

codex --version

编辑配置文件

注意

  • 在配置基本信息时,先检查是否存在 MIMO_API_KEY 的环境变量,如果存在,请先清除或者将值替换为对应使用方式获取的 API Key。

配置文件路径如下:

  • macOS/Linux

    • config.toml:~/.codex/config.toml

    • model-catalogs.json:~/.codex/model-catalogs.json

  • Windows

    • config.toml:用户目录\.codex\config.toml

    • model-catalogs.json:用户目录\.codex\model-catalogs.json

以下为完整配置示例,model 字段可按需修改为其他支持的模型(如 mimo-v2.6-pro),其中 model_catalog_json 配置请根据所使用的系统配置文件路径,文件下载地址:model-catalogs.json。

按量付费

编辑或创建配置文件 config.toml

# 配置模型元数据
model_catalog_json = "~/.codex/model-catalogs.json"
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"

# 开启模型推理摘要,如果设置为false,即使设置了 model_reasoning_effort 也不会生效
model_supports_reasoning_summaries = true
model_reasoning_summary = "none"
model_context_window = 1048576

web_search = "disabled"

[model_providers.mimo]
name = "mimo"
base_url = "https://api.xiaomimimo.com/v1"
experimental_bearer_token = "sk-your-api-key-here"
wire_api = "responses"

Token Plan

编辑或创建配置文件 config.toml

# 配置模型元数据
model_catalog_json = "~/.codex/model-catalogs.json"
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"

# 开启模型推理摘要,如果设置为false,即使设置了 model_reasoning_effort 也不会生效
model_supports_reasoning_summaries = true
model_reasoning_summary = "none"
model_context_window = 1048576

web_search = "disabled"

[model_providers.mimo]
name = "mimo"
base_url = "https://token-plan-cn.xiaomimimo.com/v1"
experimental_bearer_token = "tp-your-api-key-here"
wire_api = "responses"

使用 Codex CLI

以上配置完成后,开启一个新终端,执行以下命令启动 Codex。

codex

配置模型源数据文件后,可在 Codex 中通过 /model 命令切换模型。

使用 Codex IDE 插件

Codex 配套提供 VS Code 插件,前往 VS Code 扩展市场搜索「Codex」即可完成安装。插件会自动复用本地已存在的 Codex 配置;若你从未使用过 Codex 命令行工具,请参照「编辑配置文件」章节规范完成配置。

图片

使用 Codex 桌面端

Codex 桌面端会复用本地 Codex 中的配置,使用前请参照「编辑配置文件」章节完成配置。

图片

常见问题

Codex 报错 “ custom tools require MiMo freeform Responses lite mode.”?

不支持在非 lite 模式下使用 custom 工具,如果遇到此报错,请按照「编辑配置文件」章节配置模型元数据文件 model-catalogs.json,并重启 Codex。

更新时间 2026 年 09 月 22 日

Copyright©2026 Xiaomi. All Rights Reserved | Cookie Policy | Cookie Preferences

We use cookies and similar technologies of our own to ensure the proper functioning of the website, customize content according to user preferences and analyze users' interactions on the website, as well as their browsing habits. You can find more information in our Cookie Policy. Select an option or go to Cookie Settings to manage your preferences. Learn More.