跳到主要内容
国芯词元

Codex 配置

全部文档Codex

在 Codex 中使用平台的模型。Codex 使用 OpenAI Responses 接口。

准备工作

  • API 密钥：在控制台的 API 密钥 页新建，把下文配置里的 sk-... 换成你的密钥。
  • 接入地址：https://api.gxcy.com/v1（OpenAI 接口）。
  • 模型：可以调用的模型见控制台的 模型 页，下文以 deepseek-flash 为例。

安装

macOS / Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以用 npm 安装：

npm install -g @openai/codex

验证安装，输出版本号即安装成功：

codex --version

配置

编辑 config.toml，目录不存在时自行创建：

  • macOS / Linux：~/.codex/config.toml
  • Windows：%USERPROFILE%\.codex\config.toml
model = "deepseek-flash"
model_provider = "custom"
# 关闭 Codex 自带的联网搜索
web_search = "disabled"

[model_providers.custom]
name = "国芯词元"
base_url = "https://api.gxcy.com/v1"
experimental_bearer_token = "sk-..."
wire_api = "responses"
  • custom 是服务商的名称，可以自取，与 model_provider 一致即可。
  • model、model_provider 与 web_search 要写在第一个 [...] 之前，写在后面会被当成服务商的设置。
  • 不想把密钥写进配置文件时，把 experimental_bearer_token 换成 env_key = "环境变量名"，再把密钥放进这个环境变量。

使用 Codex 命令行

配置完成后，新开一个终端执行：

codex

换模型时改 config.toml 里的 model，或在启动时指定：codex -m 模型名称。

使用 VS Code 插件与桌面端

在 VS Code 扩展市场搜索「Codex」，安装发布者为 OpenAI 的「Codex – OpenAI's coding agent」。插件与 ChatGPT 桌面端中的 Codex 都沿用本机的 config.toml，按上文配置后重启 VS Code 或桌面端即可。

用 env_key 时，从开始菜单或程序坞打开的应用可能读不到在终端里设置的环境变量，这时改用 experimental_bearer_token。

常见问题

启动时提示 Model metadata not found

Codex 内置的模型信息里没有平台的模型时会这样提示，并改用默认参数，仍可以正常调用。