# Codex 插件（VS Code / Cursor / Trae）

> 在 VS Code、Cursor、Trae 等编辑器中接入灵眸 API 插件，通过 OpenAI 兼容接口使用 Claude / Codex。

URL: https://docs.lmuai.ai/cn/docs/tools/vscode-plugin



<Callout type="info" title="如果你用 Trae 编辑器">
  想用 &#x2A;*Claude 或国产模型（GLM / Qwen 等）** 的话，Trae 有更简单的原生方式（不装插件、GUI 里点几下即可），见 [Trae 原生模型配置](./trae)。

  本页 Codex 插件方式适合想用 **GPT / Codex** 系列的用户。
</Callout>

***

## 常见报错说明 [#常见报错说明]

**报错：配置后发现 401 提示密钥不正确**

原因：请求走的还是 OpenAI 官方，没有请求我们的中转站，或者没有重启工具重新加载配置文件。

解决：请再次按教程**创建或替换** `config.toml` 和 `auth.json` 两个文件，然后重启 IDE 工具。

<Callout type="info" title="遇见报错">
  截图错误信息进行翻译，自己就能知道是什么原因报错了！
</Callout>

***

## 配置方案 [#配置方案]

### 第1步：创建/覆盖配置文件 [#第1步创建覆盖配置文件]

配置文件位置：

* **Mac/Linux**：`~/.codex/` 目录
* **Windows**：`C:\users\你的用户名\.codex\` 目录

<Callout type="warn" title="Windows 注意">
  若之前使用官方或其他平台登录过，请先退出账号登录，再进行配置！
</Callout>

如果没有 `.codex` 文件夹，使用终端命令创建：

```bash
# Mac/Linux
rm -rf ~/.codex && mkdir ~/.codex
```

```powershell
# Windows（在终端执行）
rm -rf C:\users\你的用户名\.codex
mkdir C:\users\你的用户名\.codex
```

### 第2步：写入 config.toml [#第2步写入-configtoml]

在 `.codex` 目录下创建或覆盖 `config.toml`：

```toml
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.lmuai.ai"
wire_api = "responses"
requires_openai_auth = true
```

### 第3步：写入 auth.json [#第3步写入-authjson]

在 `.codex` 目录下创建或覆盖 `auth.json`：

```json
{
  "OPENAI_API_KEY": "这里填入后台生成的sk-开头的密钥"
}
```

配置完成后，打开 VS Code、Cursor、Trae，里面的 Codex 插件就能自动登录。

***

## Visual Studio Code 插件安装教程 [#visual-studio-code-插件安装教程]

### 安装插件 [#安装插件]

1. 打开 VS Code，先选择任意项目文件夹进入工作区（&#x2A;*不然会提示弹窗要求你打开项目文件夹！**）
2. 点击左侧插件扩展界面（Extensions 图标）
3. 搜索 **Codex**，找到 OpenAI 官方插件「Codex – OpenAI's coding agent」点击安装
4. 安装完成后，左侧栏会出现 Codex 入口（如没有则在界面右上角找）

### 退出旧账号 [#退出旧账号]

<Callout type="warn" title="重要">
  若之前使用官方或其他平台登录过，请先退出登录，再进行配置！
</Callout>

1. 点击 Codex 面板右上角的设置图标
2. 点击「**Log out**」退出登录

### 完成配置 [#完成配置]

配置好 `config.toml` 和 `auth.json` 后，重新打开 Codex 插件，点击「**Continue**」完成登录流程。

<Callout type="info" title="关于模型显示">
  GPT-5.3 的模型不会在下拉列表展示，鼠标移动到「自定义」可以看到当前正在使用的模型。

  也可以在后台「使用记录」中查看实际的请求模型。
</Callout>

***

## 想用 Claude 或国产模型？ [#想用-claude-或国产模型]

如果你只用 Trae 且目标是 **Claude / GLM / Qwen** 等模型，不用装 Codex 插件 —— 用 [Trae 原生模型配置](./trae)（Anthropic 协议、GUI 直接填几项）更简单。