CQTAI

Codex 配置(VS Code)

除命令行外,也可以在 VS Code 中安装官方 Codex 插件,直接在编辑器内使用 CQT AI。

建议先完成命令行版配置(见「CLI 配置 → Codex 配置」,写好 ~/.codex/config.toml),VS Code 插件会复用同一份配置。

前置条件

  • 已申请 CQT AI 的 APIKey(在控制台「APIKey 管理」创建)。
  • 已安装 VS Code。

配置步骤

  1. 打开 VS Code,按 Ctrl+Shift+X 打开扩展面板。

  2. 搜索 Codex,找到 "Codex - OpenAI's coding agent"(发布者:OpenAI),点击安装。

  3. 关闭并重新打开 VS Code(必须重启才能激活插件)。

  4. Ctrl+, 打开设置,搜索 codex,填入以下信息:

    配置项填写内容
    API Base URLhttps://api.cqtai.com/v1
    API Key你的 APIKey
    Modelgpt-5.3-codex
  5. 填写完成后再次重启 VS Code 使配置生效。

可用模型

  • gpt-5.3-codex:当前开放模型,速度快、适合日常编码。

常见问题

  • 插件找不到 Codex 选项 / 配置不生效:确认插件已启用后,完全关闭 VS Code 再重新打开(点右上角 × 关闭,不是最小化),配置需重启两次(装好一次、填完一次)。
  • 401 Unauthorized(认证失败):检查 API Key 是否填对、无多余空格;确认 APIKey 未过期/未禁用。
  • 503 model_not_found:确认 Model 填写为 gpt-5.3-codex,拼写完全一致。
  • macOS 安装权限错误:命令行安装时用 sudo npm install -g @openai/codex

命令行用法(含 ~/.codex/config.toml 两种密钥写法、沙箱设置)见「CLI 配置 → Codex 配置」。