> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> 在 Codex CLI 或 Codex 本地配置中使用 Moxus AI 的 OpenAI 兼容接口。

Codex 类工具通常通过本地配置文件选择模型提供方。若你的 Codex 版本支持自定义 OpenAI 兼容提供方，可以把模型请求转到 Moxus AI。

<Warning>
  Codex 不同版本和不同产品形态的配置项可能不同。本页适用于支持 `config.toml` 自定义 `model_providers` 的本地 Codex CLI / 桌面环境；如果你的版本没有这些配置项，请以当前工具内置说明为准。
</Warning>

## 配置值

| 项        | 值                     |
| -------- | --------------------- |
| Base URL | `https://moxus.ai/v1` |
| API Key  | `sk-你的密钥`             |
| 模型       | 在“模型广场”复制完整模型名称       |

## 配置文件示例

打开 Codex 配置文件，例如 `~/.codex/config.toml`，加入或调整：

```toml theme={null}
model_provider = "moxus"
model = "gpt-4o"

[model_providers.moxus]
name = "Moxus AI"
base_url = "https://moxus.ai/v1"
requires_openai_auth = true
wire_api = "responses"
```

然后在启动 Codex 的终端中设置 API Key：

```bash theme={null}
export OPENAI_API_KEY="sk-你的密钥"
```

如果你的 Codex 版本使用 Chat Completions 而不是 Responses API，可以尝试把 `wire_api` 改为当前版本支持的 OpenAI 兼容模式，或删除该项后按工具报错提示调整。

## 使用建议

* 先用一个明确支持代码任务的聊天模型测试，不要使用 embedding、rerank 或图像生成模型。
* 每个项目可以单独设置模型和推理强度，避免所有任务都走高成本模型。
* 大型代码修改会产生较多上下文和多轮请求，建议给 Codex 单独创建一把 API 密钥并设置额度上限。

## 其他 Codex 环境

如果你在 VS Code 中使用 Codex 相关扩展或本地 Codex 环境，仍然按同一套 OpenAI 兼容配置处理：

| 配置项      | 值                     |
| -------- | --------------------- |
| API Key  | `sk-你的密钥`             |
| Base URL | `https://moxus.ai/v1` |
| Model    | “模型广场”中的完整模型名称        |

若某个 Codex 环境只要求 OpenAI 兼容参数，就使用上表；若它没有 Base URL 配置项，则不能直接接入 Moxus AI。

## 验证方式

配置后运行一个简单任务：

```bash theme={null}
codex "用一句话说明当前项目是什么"
```

如果调用成功，再到 [控制台与用量](/zh/platform/dashboard-and-usage) 查看 API 活动记录，确认请求来自对应密钥。

## 常见问题

<AccordionGroup>
  <Accordion title="提示认证失败">
    确认启动 Codex 的同一个终端里存在 `OPENAI_API_KEY`，并且值是 Moxus AI 的 `sk-` 密钥。
  </Accordion>

  <Accordion title="提示模型不存在">
    把 `model` 改成“模型广场”里的完整模型名称。不要使用客户端内置展示名或简称。
  </Accordion>

  <Accordion title="提示接口或 wire_api 不支持">
    说明当前 Codex 版本的自定义提供方格式不同。保留 `base_url` 和 API Key，按当前 Codex 的配置文档调整 `wire_api` 或提供方类型。
  </Accordion>
</AccordionGroup>

## 相关文档

* [快速入门](/zh/overview/quickstart)
* [API 密钥](/zh/platform/account-and-keys)