Codex 插件（VS Code / Cursor / Trae）

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

如果你用 Trae 编辑器

想用 Claude 或国产模型（GLM / Qwen 等） 的话，Trae 有更简单的原生方式（不装插件、GUI 里点几下即可），见 Trae 原生模型配置。

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

常见报错说明

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

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

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

遇见报错

截图错误信息进行翻译，自己就能知道是什么原因报错了！

配置方案

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

配置文件位置：

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

Windows 注意

若之前使用官方或其他平台登录过，请先退出账号登录，再进行配置！

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

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

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

第2步：写入 config.toml

在 .codex 目录下创建或覆盖 config.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.com"
wire_api = "responses"
requires_openai_auth = true

第3步：写入 auth.json

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

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

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

Visual Studio Code 插件安装教程

安装插件

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

退出旧账号

重要

若之前使用官方或其他平台登录过，请先退出登录，再进行配置！

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

完成配置

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

关于模型显示

GPT-5.3 的模型不会在下拉列表展示，鼠标移动到「自定义」可以看到当前正在使用的模型。

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

想用 Claude 或国产模型？

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

最后更新：2026-07-01