XylemNode

接入指南

Codex

OpenAI 的编码代理，提供命令行、桌面版和 VS Code 插件三种形态；支持任意 OpenAI 兼容服务，配好一次就能长期复用。

获取 API Key
官网 / 下载
  1. 01

    安装并验证

    用 npm 全局安装（注意带上 @openai/ 前缀，别漏写成同名的其它包）；macOS 也可以用 Homebrew。装完运行版本号，确认命令已就绪。

    # npm（全平台）
npm install -g @openai/codex

# macOS Homebrew
brew install --cask codex

# 验证
codex --version
  2. 02

    找到配置文件

    Codex 读取用户目录下的 .codex/config.toml，文件不存在就手动新建。想换个位置，可以用 CODEX_HOME 环境变量指定目录。

    Windows
    %USERPROFILE%\.codex\config.toml
    macOS
    ~/.codex/config.toml
    Linux
    ~/.codex/config.toml
  3. 03

    写入服务商配置

    把 XylemNode 加为模型来源。三个要点：base_url 必须手动带上 /v1；Codex 目前只认 Responses 协议，wire_api 固定填 responses；密钥用 env_key 引用环境变量，别把明文写进文件。

    model = "gpt-5.6-sol"
model_provider = "xylemnode"

[model_providers.xylemnode]
name = "XylemNode"
base_url = "https://api.xylemnode.com/v1"
wire_api = "responses"
env_key = "XYLEMNODE_API_KEY"
  4. 04

    写入密钥

    把密钥存进上一步 env_key 指定的同名环境变量。Windows 用 setx 写入后需要重开终端才生效。

    # Windows（PowerShell / CMD）
setx XYLEMNODE_API_KEY "sk-你的密钥"

# macOS / Linux
export XYLEMNODE_API_KEY="sk-你的密钥"
  5. 05

    启动并测试

    重开终端后运行 codex，发一条简单指令确认通路。也可以在启动时临时切换模型。

    codex

# 临时指定模型
codex --model gpt-5.6-sol

命令行、桌面版、VS Code 插件三端通用

这三个入口读的是同一份用户级 config.toml，上面配好一次即可通用。几个要点：model_provider 与 model_providers 必须写在用户级配置里，项目级配置会忽略这两项；改完配置记得重启客户端——VS Code 里重载窗口后再重新选一次模型；桌面版需在本地模式下打开项目才会读取本机配置。

常见问题

升级 Codex 后每条命令都报错、起不来？

先看 config.toml 里的 wire_api。Codex 已经弃用 chat/completions，只走 Responses 协议——官方的迁移说明写得很明确：凡是自定义服务商写了 wire_api = "chat"、或者干脆没写这一项的，都必须改。把每个 model_providers 条目的 wire_api 都设成 "responses" 即可；顺带确认 base_url 手动带上了 /v1，Codex 这一项不会自动补。