Codex 安装与配置完全指南：多平台安装到小米模型接入

macOS 安装教程

系统要求

操作系统：macOS 12 (Monterey) 或更高版本

处理器：Apple Silicon (M1/M2/M3/M4) 或 Intel

内存：至少 4GB RAM

磁盘空间：至少 500MB 可用空间

网络：需要互联网连接

其他：可选 Node.js 22+（用于 npm 安装）

第一步：安装 Codex CLI

macOS 提供三种安装方式，任选其一：

方式一：通过 npm 安装（国内推荐）

npm install -g @openai/codex

使用国内 npm 镜像加速：

npm config set registry https://registry.npmmirror.com && npm install -g @openai/codex

如果尚未安装 Node.js，请先从 nodejs.org 下载并安装 LTS 版本。

方式二：官方脚本安装

curl -fsSL https://chatgpt.com/codex/install.sh | sh

注意： 官方脚本需要访问 chatgpt.com，国内网络可能长时间无响应甚至超时失败，失败时请改用上方的 npm 方式。

方式三：通过 Homebrew 安装

brew install --cask codex

第二步：验证安装

安装完成后，运行以下命令验证：

codex --version

如果看到版本号输出（如 0.157.0），说明安装成功。

第三步：运行诊断

Codex CLI 内置了诊断工具，可以帮助排查问题：

codex doctor

注意： codex doctor 需要在真实终端（TTY）中运行。在脚本、CI 或 SSH 管道等非交互环境中执行会报 stdin is not a terminal，本地终端使用不受影响。

该命令会检查：
- 网络连接状态
- API Key 是否有效
- 配置文件是否正确
- 系统环境是否兼容

第四步：登录账号（可选）

如果你有 OpenAI 账号，可以登录以使用官方功能：

codex login

按照提示在浏览器中完成授权即可。

接入小米 MiMo 大模型

小米 MiMo 是小米自研的大语言模型系列，国内可直接访问、按量付费，提供 OpenAI 兼容接口。我们可以将 Codex CLI 配置为使用 MiMo 作为后端模型。

获取 API Key

1. 访问 小米 MiMo 开放平台
2. 注册并登录账号
3. 进入「API Keys」页面
4. 点击「创建 API Key」
5. 复制生成的 Key（仅显示一次，请妥善保存）

创建配置目录

mkdir -p ~/.codex

编辑配置文件

cat > ~/.codex/config.toml << 'EOF'
# ===== 小米 MiMo 模型配置 =====
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

# 关键配置：关闭 Codex 默认的 web_search 工具
# MiMo 网关不支持该工具类型，不关闭会导致每次请求都被拒绝
web_search = "disabled"

# ===== 自定义模型提供者 =====
[model_providers.mimo]
name = "MiMo"
base_url = "https://api.xiaomimimo.com/v1"
env_key = "MIMO_API_KEY"
env_key_instructions = "从 https://platform.xiaomimimo.com 获取 API Key"
wire_api = "responses"
EOF

注意： web_search = "disabled" 是本配置的关键项。Codex 0.157 起默认在请求中携带 web_search 工具，而 MiMo 网关不支持该工具类型，会直接返回 responses_feature_not_supported 错误。该配置项必须写在配置文件的顶层（所有 [小节] 之前），值为字符串 "disabled"，写在 [tools] 或 [features] 小节里均不生效。

设置环境变量

Zsh 用户（macOS 默认 Shell）：

echo 'export MIMO_API_KEY="***"' >> ~/.zshrc && source ~/.zshrc

Bash 用户：

echo 'export MIMO_API_KEY="***"' >> ~/.bash_profile && source ~/.bash_profile

请将 *** 替换为你实际的小米 MiMo API Key。

验证配置

codex --version

然后尝试运行 Codex：

codex "Hello, write a Python hello world program"

如果正常返回结果，说明小米 MiMo 接入成功！

非交互场景（脚本、CI）可使用 codex exec：

bash codex exec "Hello, write a Python hello world program"

在非 Git 目录中执行需追加 --skip-git-repo-check；通过脚本调用时建议将标准输入重定向，例如 codex exec "你的指令" </dev/null，否则会等待标准输入导致挂住。

高级配置

切换不同模型：

编辑 ~/.codex/config.toml 中的 model 字段：

# 旗舰模型（推荐，能力最强）
model = "mimo-v2.6-pro"

# 快速模型（响应快，适合轻量任务）
model = "mimo-v2.6-flash"

# 极速版本（旗舰模型的加速版）
model = "mimo-v2.6-pro-ultraspeed"

提示： mimo-v2.5 系列模型官方已公告将于 2026 年 10 月 21 日下线，新配置请使用 mimo-v2.6 系列。可执行以下命令查看当前账号可用的模型列表：

bash curl -H "Authorization: Bearer $MIMO_API_KEY" https://api.xiaomimimo.com/v1/models

使用 Ollama 接入本地模型：

[model_providers.ollama]
name = "Ollama (本地模型)"
base_url = "http://localhost:11434/v1"
env_key = "OLLAMA_API_KEY"  # Ollama 不校验 Key，任意非空值即可
wire_api = "responses"

Profile 模式：

Codex 支持使用 Profile 区分不同配置：

codex --profile mimo-pro "优化这段代码"
codex --profile mimo-flash "解释这个概念"

常用环境变量

对接飞书

通过 cc-connect 工具，可以将 Codex CLI 与飞书机器人对接。

安装 cc-connect

npm install -g cc-connect

部分系统（如通过 NodeSource 安装 Node.js 的 Linux）npm 全局目录归 root 所有，需要加 sudo。

个别网络环境下安装后置脚本下载二进制可能长时间无响应，可改用 npm install -g cc-connect --ignore-scripts 跳过，再从 GitHub Releases 下载对应平台的压缩包，将其中的 cc-connect 可执行文件放到 npm 全局目录的 cc-connect/bin/ 下并添加执行权限。

快速配置

cc-connect feishu setup --project my-project

该命令提供交互式引导：按提示扫码可在飞书开放平台创建新应用并自动绑定；如已有应用，也可用 --app-id 和 --app-secret 参数直接绑定。配置文件路径可用 cc-connect config path 确认。

手动配置

cc-connect 的配置文件位于 ~/.cc-connect/config.toml（可用 cc-connect config path 确认）。注意它与 Codex 的配置文件 ~/.codex/config.toml 是两个不同的文件：

[[projects]]
name = "my-project"

[projects.agent]
type = "codex"

[projects.agent.options]
work_dir = "/home/yourname/project"  # 改成你的代码目录
mode = "suggest"                    # suggest / auto-edit / full-auto / yolo

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

cc-connect 通过 WebSocket 长连接接收飞书消息，不需要 encrypt_key 和 verification_token。

配置采用「项目」结构：一个 [[projects]] 条目把一个代码目录、一个 Agent 类型和若干消息平台绑定在一起，单个 cc-connect 进程可以同时管理多个项目。完整的带注释配置示例可执行 cc-connect config example 查看。

飞书应用配置步骤

1. 登录 飞书开放平台
2. 创建企业自建应用，并开启「机器人」能力
3. 在「权限管理」中开启以下权限：
4. im:message:send_as_bot（以机器人身份发送消息）
5. im:chat:readonly（读取群信息，按需开通）
6. 在「事件订阅」中添加 im.message.receive_v1（接收消息）事件，订阅方式选择 WebSocket 长连接
7. 将 App ID 和 App Secret 填入配置文件
8. 发布应用并添加到目标群聊

选择 WebSocket 长连接模式后无需填写公网回调地址，cc-connect 会通过 App 凭证自动建立连接。

守护进程运行

测试无误后，可以将 cc-connect 注册为系统服务常驻运行：

# 安装为系统服务（必须显式指定配置文件路径，否则找不到配置）
cc-connect daemon install --config ~/.cc-connect/config.toml

# 查看运行状态 / 跟随日志
cc-connect daemon status
cc-connect daemon logs -f

注意： systemd 服务不会读取 ~/.bashrc，写在 shell 配置文件里的 API Key 不会注入到服务中，需要创建 drop-in 文件：

bash mkdir -p ~/.config/systemd/user/cc-connect.service.d cat > ~/.config/systemd/user/cc-connect.service.d/env.conf <<'CONF' [Service] Environment=MIMO_API_KEY=你的Key CONF systemctl --user daemon-reload && cc-connect daemon restart

常见问题

Q: codex 命令找不到？

A: 请确认安装路径已添加到 PATH 环境变量：

# 查看 codex 安装位置
which codex

# 如果未找到，尝试手动添加路径
export PATH="$HOME/.local/bin:$PATH"

如果通过 npm 安装，可能需要：

export PATH="$(npm bin -g):$PATH"

Q: MiMo 连接失败？

A: 请检查以下几项：

1. API Key 是否正确设置：echo $MIMO_API_KEY
2. 网络是否能访问 api.xiaomimimo.com：curl -I https://api.xiaomimimo.com/v1/models
3. 配置文件格式是否正确：cat ~/.codex/config.toml
4. 是否漏掉了 web_search = "disabled"：如果报错提示 tool type 'web_search' is not supported，就是因为没有关闭 web_search 工具

Q: 如何更新到最新版？

A: 根据安装方式选择对应的更新命令：

# 官方脚本安装的
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm 安装的
npm update -g @openai/codex

# Homebrew 安装的
brew upgrade --cask codex

Q: 如何查看当前配置？

A: Codex 没有 config 子命令，直接查看配置文件即可：

# 查看 Codex 配置
cat ~/.codex/config.toml

# 查看 cc-connect 配置路径及完整示例
cc-connect config path
cc-connect config example

Q: 为什么选择小米 MiMo 而不是 OpenAI？

对于国内开发者来说，MiMo 国内直连、中文友好、提供 OpenAI 兼容接口，接入 Codex CLI 省心省力。模型价格与免费额度请以小米 MiMo 开放平台公示为准。

常用管理命令速查

注意：Codex 没有 config 子命令，查看配置请直接编辑 ~/.codex/config.toml。

相关资源

• Codex 官方文档 - 官方使用指南和 API 文档
• Codex GitHub 仓库 - 源代码和 Issue 反馈
• 小米 MiMo 开放平台 - 注册和管理 API Key
• Codex 完全卸载教程 - 不再需要时的卸载方法

Windows 安装教程

系统要求

操作系统：Windows 10 (64位) 或更高版本

处理器：x64 架构 CPU

内存：至少 4GB RAM

磁盘空间：至少 500MB 可用空间

网络：需要互联网连接

其他：PowerShell 5.1+ 或 PowerShell 7+；可选 Node.js 22+

第一步：安装 Codex CLI

Windows 用户请以管理员身份运行 PowerShell

右键点击「开始」菜单 → 选择「Windows Terminal (管理员)」或「PowerShell (管理员)」

方式一：通过 npm 安装（国内推荐）

npm install -g @openai/codex

使用国内 npm 镜像加速：

npm config set registry https://registry.npmmirror.com && npm install -g @openai/codex

如果尚未安装 Node.js，请先从 nodejs.org 下载并安装 LTS 版本。

方式二：官方脚本安装

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

注意： 官方脚本需要访问 chatgpt.com，国内网络可能长时间无响应甚至超时失败，失败时请改用上方的 npm 方式。

第二步：验证安装

安装完成后，重新打开一个 PowerShell 窗口，然后运行：

codex --version

如果看到版本号输出（如 0.157.0），说明安装成功。

第三步：运行诊断

Codex CLI 内置了诊断工具，可以帮助排查问题：

codex doctor

注意： codex doctor 需要在真实终端（TTY）中运行。在脚本、CI 或 SSH 管道等非交互环境中执行会报 stdin is not a terminal，本地终端使用不受影响。

该命令会检查：
- 网络连接状态
- API Key 是否有效
- 配置文件是否正确
- 系统环境是否兼容

第四步：登录账号（可选）

如果你有 OpenAI 账号，可以登录以使用官方功能：

codex login

按照提示在浏览器中完成授权即可。

接入小米 MiMo 大模型

小米 MiMo 是小米自研的大语言模型系列，国内可直接访问、按量付费，提供 OpenAI 兼容接口。我们可以将 Codex CLI 配置为使用 MiMo 作为后端模型。

获取 API Key

1. 访问 小米 MiMo 开放平台
2. 注册并登录账号
3. 进入「API Keys」页面
4. 点击「创建 API Key」
5. 复制生成的 Key（仅显示一次，请妥善保存）

创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

编辑配置文件

@"
# ===== 小米 MiMo 模型配置 =====
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

# 关键配置：关闭 Codex 默认的 web_search 工具
# MiMo 网关不支持该工具类型，不关闭会导致每次请求都被拒绝
web_search = "disabled"

# ===== 自定义模型提供者 =====
[model_providers.mimo]
name = "MiMo"
base_url = "https://api.xiaomimimo.com/v1"
env_key = "MIMO_API_KEY"
env_key_instructions = "从 https://platform.xiaomimimo.com 获取 API Key"
wire_api = "responses"
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding utf8

注意： web_search = "disabled" 是本配置的关键项。Codex 0.157 起默认在请求中携带 web_search 工具，而 MiMo 网关不支持该工具类型，会直接返回 responses_feature_not_supported 错误。该配置项必须写在配置文件的顶层（所有 [小节] 之前），值为字符串 "disabled"，写在 [tools] 或 [features] 小节里均不生效。

设置环境变量

设置永久环境变量（用户级别）：

[Environment]::SetEnvironmentVariable("MIMO_API_KEY", "***", "User")

设置当前会话环境变量（立即生效）：

$env:MIMO_API_KEY="***"

请将 *** 替换为你实际的小米 MiMo API Key。
设置永久环境变量后，需要重新打开 PowerShell 窗口才能生效。

验证配置

codex --version

然后尝试运行 Codex：

codex "Hello, write a Python hello world program"

如果正常返回结果，说明小米 MiMo 接入成功！

非交互场景（脚本、CI）可使用 codex exec：

powershell codex exec "Hello, write a Python hello world program"

在非 Git 目录中执行需追加 --skip-git-repo-check；通过脚本调用时建议将标准输入重定向，例如 codex exec "你的指令" < $null，否则会等待标准输入导致挂住。

高级配置

切换不同模型：

编辑 ~/.codex/config.toml 中的 model 字段：

# 旗舰模型（推荐，能力最强）
model = "mimo-v2.6-pro"

# 快速模型（响应快，适合轻量任务）
model = "mimo-v2.6-flash"

# 极速版本（旗舰模型的加速版）
model = "mimo-v2.6-pro-ultraspeed"

提示： mimo-v2.5 系列模型官方已公告将于 2026 年 10 月 21 日下线，新配置请使用 mimo-v2.6 系列。可执行以下命令查看当前账号可用的模型列表：

powershell curl -H "Authorization: Bearer $env:MIMO_API_KEY" https://api.xiaomimimo.com/v1/models

使用 Ollama 接入本地模型：

[model_providers.ollama]
name = "Ollama (本地模型)"
base_url = "http://localhost:11434/v1"
env_key = "OLLAMA_API_KEY"  # Ollama 不校验 Key，任意非空值即可
wire_api = "responses"

Profile 模式：

Codex 支持使用 Profile 区分不同配置：

codex --profile mimo-pro "优化这段代码"
codex --profile mimo-flash "解释这个概念"

常用环境变量

对接飞书

通过 cc-connect 工具，可以将 Codex CLI 与飞书机器人对接。

安装 cc-connect

npm install -g cc-connect

个别网络环境下安装后置脚本下载二进制可能长时间无响应，可改用 npm install -g cc-connect --ignore-scripts 跳过，再从 GitHub Releases 下载 Windows 版压缩包，将其中的可执行文件放到 npm 全局目录的 cc-connect\bin\ 下。

快速配置

cc-connect feishu setup --project my-project

该命令提供交互式引导：按提示扫码可在飞书开放平台创建新应用并自动绑定；如已有应用，也可用 --app-id 和 --app-secret 参数直接绑定。配置文件路径可用 cc-connect config path 确认。

手动配置

cc-connect 的配置文件位于 ~/.cc-connect/config.toml（Windows 下为 %USERPROFILE%\.cc-connect\config.toml，可用 cc-connect config path 确认）。注意它与 Codex 的配置文件 ~/.codex/config.toml 是两个不同的文件：

[[projects]]
name = "my-project"

[projects.agent]
type = "codex"

[projects.agent.options]
work_dir = 'C:\Users\yourname\project'  # 改成你的代码目录
mode = "suggest"                       # suggest / auto-edit / full-auto / yolo

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

cc-connect 通过 WebSocket 长连接接收飞书消息，不需要 encrypt_key 和 verification_token。

配置采用「项目」结构：一个 [[projects]] 条目把一个代码目录、一个 Agent 类型和若干消息平台绑定在一起，单个 cc-connect 进程可以同时管理多个项目。完整的带注释配置示例可执行 cc-connect config example 查看。

Windows 下可以通过以下命令快速创建：

@"
[[projects]]
name = "my-project"

[projects.agent]
type = "codex"

[projects.agent.options]
work_dir = 'C:\Users\yourname\project'
mode = "suggest"

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
"@ | Out-File -FilePath "$env:USERPROFILE\.cc-connect\config.toml" -Encoding utf8

飞书应用配置步骤

1. 登录 飞书开放平台
2. 创建企业自建应用，并开启「机器人」能力
3. 在「权限管理」中开启以下权限：
4. im:message:send_as_bot（以机器人身份发送消息）
5. im:chat:readonly（读取群信息，按需开通）
6. 在「事件订阅」中添加 im.message.receive_v1（接收消息）事件，订阅方式选择 WebSocket 长连接
7. 将 App ID 和 App Secret 填入配置文件
8. 发布应用并添加到目标群聊

选择 WebSocket 长连接模式后无需填写公网回调地址，cc-connect 会通过 App 凭证自动建立连接。

守护进程运行

测试无误后，可以将 cc-connect 注册为系统服务常驻运行：

# 安装为系统服务（必须显式指定配置文件路径，否则找不到配置）
cc-connect daemon install --config ~/.cc-connect/config.toml

# 查看运行状态 / 跟随日志
cc-connect daemon status
cc-connect daemon logs -f

注意： systemd 服务不会读取 ~/.bashrc，写在 shell 配置文件里的 API Key 不会注入到服务中，需要创建 drop-in 文件：

bash mkdir -p ~/.config/systemd/user/cc-connect.service.d cat > ~/.config/systemd/user/cc-connect.service.d/env.conf <<'CONF' [Service] Environment=MIMO_API_KEY=你的Key CONF systemctl --user daemon-reload && cc-connect daemon restart

守护进程运行

测试无误后，可以让 cc-connect 常驻运行（Windows 下通过「任务计划程序」实现）：

# 安装常驻任务（必须显式指定配置文件路径，否则找不到配置）
cc-connect daemon install --config "$env:USERPROFILE\.cc-connect\config.toml"

# 查看运行状态 / 跟随日志
cc-connect daemon status
cc-connect daemon logs -f

注意： Windows 下请确认 API Key 已设置为用户级环境变量；修改环境变量后需要重新登录，后续启动的任务才能读取到。

常见问题

Q: codex 命令找不到？

A: 请确认安装路径已添加到 PATH 环境变量：

# 查看 codex 安装位置
Get-Command codex -ErrorAction SilentlyContinue

# 如果未找到，尝试手动添加路径
$env:PATH += ";$env:APPDATA\npm"

你也可以在「系统属性 → 环境变量」中手动将 %APPDATA%\npm 添加到 PATH。

Q: MiMo 连接失败？

A: 请检查以下几项：

1. API Key 是否正确设置：echo $env:MIMO_API_KEY
2. 网络是否能访问 api.xiaomimimo.com：Test-NetConnection api.xiaomimimo.com -Port 443
3. 配置文件格式是否正确：Get-Content $env:USERPROFILE\.codex\config.toml
4. 是否漏掉了 web_search = "disabled"：如果报错提示 tool type 'web_search' is not supported，就是因为没有关闭 web_search 工具

Q: 如何更新到最新版？

A: 重新运行安装命令即可：

# 官方脚本安装的
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npm 安装的
npm update -g @openai/codex

Q: 如何查看当前配置？

A: Codex 没有 config 子命令，直接查看配置文件即可：

# 查看 Codex 配置
Get-Content $env:USERPROFILE\.codex\config.toml

# 查看 cc-connect 配置路径及完整示例
cc-connect config path
cc-connect config example

Q: 为什么选择小米 MiMo 而不是 OpenAI？

对于国内开发者来说，MiMo 国内直连、中文友好、提供 OpenAI 兼容接口，接入 Codex CLI 省心省力。模型价格与免费额度请以小米 MiMo 开放平台公示为准。

常用管理命令速查

注意：Codex 没有 config 子命令，查看配置请直接编辑 ~/.codex/config.toml。

相关资源

• Codex 官方文档 - 官方使用指南和 API 文档
• Codex GitHub 仓库 - 源代码和 Issue 反馈
• 小米 MiMo 开放平台 - 注册和管理 API Key
• Codex 完全卸载教程 - 不再需要时的卸载方法

Linux 安装教程

系统要求

操作系统：Ubuntu 20.04+、Debian 11+、CentOS 8+、Fedora 36+ 或其他主流发行版

处理器：x64 架构 CPU

内存：至少 4GB RAM

磁盘空间：至少 500MB 可用空间

网络：需要互联网连接

其他：可选 Node.js 22+（用于 npm 安装）

第一步：安装 Codex CLI

方式一：通过 npm 安装（国内推荐）

npm install -g @openai/codex

使用国内 npm 镜像加速：

npm config set registry https://registry.npmmirror.com && npm install -g @openai/codex

注意： 如果 Node.js 是通过 NodeSource 安装的，npm 全局目录（/usr/lib/node_modules）归 root 所有，需要加 sudo：

bash sudo npm install -g @openai/codex

如果尚未安装 Node.js，可以使用以下命令安装（以 Ubuntu 为例）：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

方式二：官方脚本安装

curl -fsSL https://chatgpt.com/codex/install.sh | sh

注意： 官方脚本需要访问 chatgpt.com，国内网络可能长时间无响应甚至超时失败，失败时请改用上方的 npm 方式。

第二步：验证安装

安装完成后，运行以下命令验证：

codex --version

如果看到版本号输出（如 0.157.0），说明安装成功。

如果提示命令找不到，请检查安装路径是否在 PATH 中：

export PATH="$HOME/.local/bin:$PATH"

第三步：运行诊断

Codex CLI 内置了诊断工具，可以帮助排查问题：

codex doctor

注意： codex doctor 需要在真实终端（TTY）中运行。在脚本、CI 或 SSH 管道等非交互环境中执行会报 stdin is not a terminal，本地终端使用不受影响。

该命令会检查：
- 网络连接状态
- API Key 是否有效
- 配置文件是否正确
- 系统环境是否兼容

第四步：登录账号（可选）

如果你有 OpenAI 账号，可以登录以使用官方功能：

codex login

按照提示在浏览器中完成授权即可。

接入小米 MiMo 大模型

小米 MiMo 是小米自研的大语言模型系列，国内可直接访问、按量付费，提供 OpenAI 兼容接口。我们可以将 Codex CLI 配置为使用 MiMo 作为后端模型。

获取 API Key

1. 访问 小米 MiMo 开放平台
2. 注册并登录账号
3. 进入「API Keys」页面
4. 点击「创建 API Key」
5. 复制生成的 Key（仅显示一次，请妥善保存）

创建配置目录

mkdir -p ~/.codex

编辑配置文件

cat > ~/.codex/config.toml << 'EOF'
# ===== 小米 MiMo 模型配置 =====
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"
approval_policy = "never"
sandbox_mode = "danger-full-access"

# 关键配置：关闭 Codex 默认的 web_search 工具
# MiMo 网关不支持该工具类型，不关闭会导致每次请求都被拒绝
web_search = "disabled"

# ===== 自定义模型提供者 =====
[model_providers.mimo]
name = "MiMo"
base_url = "https://api.xiaomimimo.com/v1"
env_key = "MIMO_API_KEY"
env_key_instructions = "从 https://platform.xiaomimimo.com 获取 API Key"
wire_api = "responses"
EOF

注意： web_search = "disabled" 是本配置的关键项。Codex 0.157 起默认在请求中携带 web_search 工具，而 MiMo 网关不支持该工具类型，会直接返回 responses_feature_not_supported 错误。该配置项必须写在配置文件的顶层（所有 [小节] 之前），值为字符串 "disabled"，写在 [tools] 或 [features] 小节里均不生效。

设置环境变量

echo 'export MIMO_API_KEY="***"' >> ~/.bashrc && source ~/.bashrc

请将 *** 替换为你实际的小米 MiMo API Key。

验证配置

codex --version

然后尝试运行 Codex：

codex "Hello, write a Python hello world program"

如果正常返回结果，说明小米 MiMo 接入成功！

非交互场景（脚本、CI）可使用 codex exec：

bash codex exec "Hello, write a Python hello world program"

在非 Git 目录中执行需追加 --skip-git-repo-check；通过脚本调用时建议将标准输入重定向，例如 codex exec "你的指令" </dev/null，否则会等待标准输入导致挂住。

高级配置

切换不同模型：

编辑 ~/.codex/config.toml 中的 model 字段：

# 旗舰模型（推荐，能力最强）
model = "mimo-v2.6-pro"

# 快速模型（响应快，适合轻量任务）
model = "mimo-v2.6-flash"

# 极速版本（旗舰模型的加速版）
model = "mimo-v2.6-pro-ultraspeed"

提示： mimo-v2.5 系列模型官方已公告将于 2026 年 10 月 21 日下线，新配置请使用 mimo-v2.6 系列。可执行以下命令查看当前账号可用的模型列表：

bash curl -H "Authorization: Bearer $MIMO_API_KEY" https://api.xiaomimimo.com/v1/models

使用 Ollama 接入本地模型：

[model_providers.ollama]
name = "Ollama (本地模型)"
base_url = "http://localhost:11434/v1"
env_key = "OLLAMA_API_KEY"  # Ollama 不校验 Key，任意非空值即可
wire_api = "responses"

Profile 模式：

Codex 支持使用 Profile 区分不同配置：

codex --profile mimo-pro "优化这段代码"
codex --profile mimo-flash "解释这个概念"

常用环境变量

对接飞书

通过 cc-connect 工具，可以将 Codex CLI 与飞书机器人对接。

安装 cc-connect

npm install -g cc-connect

部分系统（如通过 NodeSource 安装 Node.js 的 Linux）npm 全局目录归 root 所有，需要加 sudo。

个别网络环境下安装后置脚本下载二进制可能长时间无响应，可改用 npm install -g cc-connect --ignore-scripts 跳过，再从 GitHub Releases 下载对应平台的压缩包，将其中的 cc-connect 可执行文件放到 npm 全局目录的 cc-connect/bin/ 下并添加执行权限。

快速配置

cc-connect feishu setup --project my-project

该命令提供交互式引导：按提示扫码可在飞书开放平台创建新应用并自动绑定；如已有应用，也可用 --app-id 和 --app-secret 参数直接绑定。配置文件路径可用 cc-connect config path 确认。

手动配置

cc-connect 的配置文件位于 ~/.cc-connect/config.toml（可用 cc-connect config path 确认）。注意它与 Codex 的配置文件 ~/.codex/config.toml 是两个不同的文件：

[[projects]]
name = "my-project"

[projects.agent]
type = "codex"

[projects.agent.options]
work_dir = "/home/yourname/project"  # 改成你的代码目录
mode = "suggest"                    # suggest / auto-edit / full-auto / yolo

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_xxxxxxxxxxxxxxxx"
app_secret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

cc-connect 通过 WebSocket 长连接接收飞书消息，不需要 encrypt_key 和 verification_token。

配置采用「项目」结构：一个 [[projects]] 条目把一个代码目录、一个 Agent 类型和若干消息平台绑定在一起，单个 cc-connect 进程可以同时管理多个项目。完整的带注释配置示例可执行 cc-connect config example 查看。

飞书应用配置步骤

1. 登录 飞书开放平台
2. 创建企业自建应用，并开启「机器人」能力
3. 在「权限管理」中开启以下权限：
4. im:message:send_as_bot（以机器人身份发送消息）
5. im:chat:readonly（读取群信息，按需开通）
6. 在「事件订阅」中添加 im.message.receive_v1（接收消息）事件，订阅方式选择 WebSocket 长连接
7. 将 App ID 和 App Secret 填入配置文件
8. 发布应用并添加到目标群聊

选择 WebSocket 长连接模式后无需填写公网回调地址，cc-connect 会通过 App 凭证自动建立连接。

守护进程运行

测试无误后，可以将 cc-connect 注册为系统服务常驻运行：

# 安装为系统服务（必须显式指定配置文件路径，否则找不到配置）
cc-connect daemon install --config ~/.cc-connect/config.toml

# 查看运行状态 / 跟随日志
cc-connect daemon status
cc-connect daemon logs -f

注意： systemd 服务不会读取 ~/.bashrc，写在 shell 配置文件里的 API Key 不会注入到服务中，需要创建 drop-in 文件：

bash mkdir -p ~/.config/systemd/user/cc-connect.service.d cat > ~/.config/systemd/user/cc-connect.service.d/env.conf <<'CONF' [Service] Environment=MIMO_API_KEY=你的Key CONF systemctl --user daemon-reload && cc-connect daemon restart

常见问题

Q: codex 命令找不到？

A: 请确认安装路径已添加到 PATH 环境变量：

# 查看 codex 安装位置
which codex

# 如果未找到，尝试手动添加路径
export PATH="$HOME/.local/bin:$PATH"

如果通过 npm 安装，可能需要：

export PATH="$(npm bin -g):$PATH"

Q: MiMo 连接失败？

A: 请检查以下几项：

1. API Key 是否正确设置：echo $MIMO_API_KEY
2. 网络是否能访问 api.xiaomimimo.com：curl -I https://api.xiaomimimo.com/v1/models
3. 配置文件格式是否正确：cat ~/.codex/config.toml
4. 是否漏掉了 web_search = "disabled"：如果报错提示 tool type 'web_search' is not supported，就是因为没有关闭 web_search 工具

Q: 如何更新到最新版？

A: 根据安装方式选择对应的更新命令：

# 官方脚本安装的
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# npm 安装的
npm update -g @openai/codex

Q: 如何查看当前配置？

A: Codex 没有 config 子命令，直接查看配置文件即可：

# 查看 Codex 配置
cat ~/.codex/config.toml

# 查看 cc-connect 配置路径及完整示例
cc-connect config path
cc-connect config example

Q: 为什么选择小米 MiMo 而不是 OpenAI？

对于国内开发者来说，MiMo 国内直连、中文友好、提供 OpenAI 兼容接口，接入 Codex CLI 省心省力。模型价格与免费额度请以小米 MiMo 开放平台公示为准。

常用管理命令速查

注意：Codex 没有 config 子命令，查看配置请直接编辑 ~/.codex/config.toml。

相关资源

• Codex 官方文档 - 官方使用指南和 API 文档
• Codex GitHub 仓库 - 源代码和 Issue 反馈
• 小米 MiMo 开放平台 - 注册和管理 API Key
• Codex 完全卸载教程 - 不再需要时的卸载方法