灵眸文档
工具配置

VS Code / Cursor / Trae


常见报错说明

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

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

解决:请再次按教程创建或替换 config.tomlauth.json 两个文件,然后重启 IDE 工具。

遇见报错

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


配置方案

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

配置文件位置:

  • Mac/Linux~/.codex/ 目录
  • WindowsC:\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://clawapi.fulitimes.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 插件安装教程

安装插件

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

退出旧账号

重要

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

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

完成配置

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

关于模型显示

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

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


Trae 原生模型配置

除 Codex 插件外,Trae 编辑器本身支持直接添加自定义 AI 模型,无需插件,配置更简单。

配置步骤

  1. 打开 Trae,进入 设置 → 模型 → 添加模型
  2. 服务商选择 Anthropic
  3. 填写模型名称,例如 claude-opus-4-6(下拉选择或手动输入)
  4. 自定义请求 URL 填写:
    https://clawapi.fulitimes.com/v1/messages
  5. API Key 填写你在灵眸后台生成的密钥(sk- 开头)
  6. 点击保存,切换到该模型即可使用

常用模型参考

模型说明
claude-opus-4-7Claude Opus 4.7(旗舰版)
claude-opus-4-6Claude Opus 4.6
claude-sonnet-4-6Claude Sonnet 4.6(均衡版)

具体可用模型以灵眸后台「可用模型」列表为准。

On this page