最后核对

资料核对日期：2026-07-27。网关地址以 www.mlai.online 为准；Codex 配置字段参考 OpenAI Codex config reference。

用马良 AI 连接 Codex

本篇是马良用户的主路径：用控制台 API Key + 自定义 base_url，让 Codex CLI / 桌面端走马良网关，使用已适配的 OpenAI 最新能力。

安全

API Key 等同密码。不要写进仓库、不要发群截图、不要分享给他人。泄露后立刻在控制台禁用。

你需要准备

1. 已开通马良套餐（见 马良 AI 套餐与 API Key）
2. 一把可用的 API Key
3. 已安装 Codex 桌面 App 或 Codex CLI

推荐配置（手动 config.toml）

配置文件路径：

~/.codex/config.toml

先备份：

cp ~/.codex/config.toml ~/.codex/config.toml.backup 2>/dev/null || true

写入示例如下（按你的 Key 与模型名修改）：

model = "gpt-5.6-sol"
model_reasoning_effort = "medium"
preferred_auth_method = "apikey"

[model_providers.maliang]
name = "maliang"
base_url = "https://www.mlai.online/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
requires_openai_auth = false

[profiles.maliang]
model_provider = "maliang"
model = "gpt-5.6-sol"

本机注入 Key（不要把 Key 写进 toml）：

export OPENAI_API_KEY='sk-你的马良密钥'

启动时指定 profile（CLI）：

codex --profile maliang

桌面 App：在设置里选择对应 provider / profile，或确认启动环境已带上 OPENAI_API_KEY。不同版本菜单位置可能略有差异，以你本机界面为准。

字段说明

字段	建议值	说明
base_url	https://www.mlai.online/v1	马良 OpenAI 兼容入口
wire_api	responses	Codex 常用 Responses 协议
env_key	OPENAI_API_KEY	从环境变量读 Key
model	gpt-5.6 / gpt-5.6-sol 等	以马良控制台可用模型为准

第一次怎么验收

1. 开一个空目录或小仓库
2. 让 Codex 回答「当前目录有什么文件」这类只读任务
3. 能正常流式回复、马良控制台用量有增长 → 即接通

再去做 第一个任务。

常见问题

现象	先查什么
401 / 鉴权失败	Key 是否复制完整、是否已禁用、环境变量是否生效
模型不存在 / 404	模型名是否在马良可用列表；可先试 gpt-5.6
额度不足	套餐周额度或余额；控制台订阅页
很慢或超时	请求体是否过大（整仓上下文）；换轻量任务对比
桌面端仍走官方	是否未选 maliang profile / 未设置 preferred_auth_method = "apikey"

其它工具（可选）

社区也有 Codex++、CC Switch 等图形化切换工具，可把马良填成其中一个供应商。原理相同：Base URL + API Key + 模型名。工具本身非马良出品，自行评估安全性。

下一步

• 了解 Codex 基本组成
• 用 Codex 完成第一个任务
• CLI 安装与登录
• 排障手册