安装Codex

2026/06/03

我没有给OpenAI直接充钱,而是购买了Poe平台的套餐以便使用多家模型进行对话。所以本文配置的前提是使用者拥有Poe平台账户和一定额度。直接参见第一个参考文献链接。

已知Codex需要Node.js 22或更新版本1

安装node、npm2

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 24

# Verify the Node.js version:
node -v # Should print "v24.16.0".

# Verify npm version:
npm -v # Should print "11.13.0".

设置npm镜像(针对大陆特殊网络环境)

npm config set registry https://registry.npmmirror.com 

安装Codex

npm install -g @openai/codex

获取Poe API密钥

通过点击链接手动生成一个API密钥,保存待用。

将Codex连接到Poe,官方推荐的Poe Code流程(在特殊网络环境下无法实施,从这里开始跳过):

单次会话:

临时会话 — 不会对您的系统进行永久性更改。

npx poe-code@latest wrap codex

永久配置:

运行一次 — 所有后续会话将自动通过Poe连接。

npx poe-code@latest configure codex

上述配置过程实测,要nodejs能和poe授权页面通信才行,但我在终端折腾半天命令并不能实现。

所以跳过上述,改为手动配置:

Codex 使用~/.codex/config.toml进行配置(先直接运行一次codex,就会在该目录生成对应toml文件了)。添加自定义提供商以通过Poe连接:

model = "gpt-5.2-codex"
model_provider = "poe"
model_reasoning_effort = "medium"
personality = "pragmatic"

[model_providers.poe]
name = "poe"
base_url = "https://api.poe.com/v1"
env_key = "POE_API_KEY"
wire_api = "responses"

上述内容唯一变化是我改用了model = "gpt-5.5"

然后将Poe API密钥设置为环境变量:

export POE_API_KEY="your_poe_api_key"

要使此更改永久生效,请将导出命令添加到您的shell配置文件(~/.bashrc~/.zshrc)中。

开始会话

codex

参考文献


  1. Codex ↩︎

  2. Node.js ↩︎