# Codex 配置指南

## 你可以用它做什么

配置供 MOI 调用的 Codex 编程能力。这里配置的是 API 服务，不是登录 Codex 桌面应用。

## 配置前准备

向模型服务管理员获取一组配套的 Responses 兼容 Base URL、API Key 和可使用的模型。ChatGPT/Codex 登录账号或订阅不能直接填写为此处的 API Key。不要猜测模型名或网关地址。

需要能够在当前 MOI 工作区创建或编辑工具配置。若没有入口或提示无权操作，请联系工作区管理员，不要借用他人的账号。

## 配置页面


```{figure} /assets/images/agents/guide-5-hd/15-codex-config.png
:alt: Codex 配置需提供服务地址和 API Key，再选择模型与思考级别。
:class: agent-guide-image
:figclass: agent-guide-shot

Codex 配置需提供服务地址和 API Key，再选择模型与思考级别。
```

## 在 MOI 中操作

1. 进入「工具库 → 工具市场 → Codex」，选择对应编程能力并创建实例。
2. 填写名称、Base URL 和 API Key。
3. 打开模型下拉框，等待接口返回可用模型，再选择模型。
4. 选择服务支持的思考级别，保存实例并测试连接。
5. 在智能体工具配置中选择该 Codex 实例。

## 字段怎么填写

| 字段 | 何时需要 | 填写说明 |
| --- | --- | --- |
| 实例名称 | 必填 | 例如「开发辅助 Codex」。 |
| Base URL | 必填 | 填写管理员提供的 Responses 基础地址，不填浏览器聊天地址；保留网关要求的路径。 |
| API Key | 必填 | 与 Base URL 配套的服务凭证。 |
| 模型 | 必填 | 填写地址和 Key 后，从下拉框加载并选择可用模型。 |
| 思考级别 | 必填 | 从页面选项中选择，须与服务端模型能力匹配。 |

## 让智能体实际使用

回到目标智能体详情，在工具区域检查对应能力是否已绑定；提供实例选择时，核对目标连接。具体步骤见[绑定并验证工具](../bind-tools.md)。

在测试任务中要求「生成一个对列表求和的 Python 函数和两个测试，不修改仓库，不执行部署」。确认调用记录是 Codex 工具、返回内容符合任务要求。需要操作仓库时，再单独验证工作目录和操作授权。

验收时逐项确认：

- [ ] 保存成功，重新打开后配置仍存在。
- [ ] 测试连接返回成功，而不是只有「已配置」标签。
- [ ] 对话的工具调用记录显示实际调用，结果与目标平台一致。

## 常见问题

| 现象 | 检查方法 |
| --- | --- |
| 模型下拉框为空 | 核对 Base URL、API Key、网络以及服务的模型列表接口。 |
| 模型存在但执行失败 | 模型列表成功不代表 Responses 执行兼容；请服务管理员检查接口及模型能力。 |
| 思考级别被拒绝 | 换成当前模型明确支持的级别，不以页面可选就认定模型必然支持。 |

## 凭证维护与安全

只在 MOI 的敏感字段中输入 Key、Token、密码或私钥，不要放进提示词、截图、Issue 或 Git 仓库。配置更换前先确认有哪些智能体使用该实例；更换后重新测试，再验证一次实际任务。若凭证泄露，应到提供方撤销并生成新凭证。删除或停用配置会影响依赖它的调用，请先确认影响范围。

## 资料与核对范围

- 外部服务参数按管理员提供的实际接入信息填写，不预设可用模型、账号或服务地址。
- 接入范围与资料依据见[指南说明](index.md#tool-configuration-sources)。
- [返回工具配置指南目录](index.md)。