上手指南
上手指南 / Codex

Codex 命令行版

Codex 是 OpenAI 出的编程助手，在终端里运行。它可以连到 AIPlayer 演示站，用 Claude 模型干活。分三步：安装 → 写配置 → 启动验证。

还没有密钥的，先看 创建密钥（厂商选 Anthropic）。不知道怎么打开终端的，先看 开始前先看这一页。

一、安装

macOS

打开「终端」，复制下面这行命令，粘贴后按回车：

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

看到 installed successfully 就装好了。关掉终端窗口，重新打开一个，检查：

bash
codex --version

显示 codex-cli 加一串版本号就成功了。

注意

如果提示 command not found: codex，复制下面这行运行一次，再试 codex --version：

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Windows

打开「Windows PowerShell」，复制下面这行命令，粘贴后按回车：

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

装完后关掉 PowerShell，重新打开一个，检查：

powershell
codex --version

显示 codex-cli 加一串版本号就成功了。

二、写配置（连到本站）

这一步把"本站地址"和"你的密钥"写进 Codex 的配置文件。写好之后，Codex 不会要求你登录 ChatGPT，直接走本站。

先把你的密钥粘贴到页面顶部的输入框里，下面命令中的 sk-你的密钥 会自动换掉。然后复制对应系统的整段命令，粘贴到终端，按回车。

macOS：

bash
mkdir -p ~/.codex
[ -f ~/.codex/config.toml ] && cp ~/.codex/config.toml ~/.codex/config.toml.bak
cat > ~/.codex/config.toml <<'EOF'
model_provider = "sub2api"
model = "claude-sonnet-5-5"
review_model = "claude-sonnet-5-5"

[model_providers.sub2api]
name = "Sub2API"
base_url = "https://demo.aiplayer.club/v1"
model_catalog_url = "https://demo.aiplayer.club/v1/models"
experimental_bearer_token = "sk-你的密钥"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

[features]
api_key_model_discovery = true
EOF
cat ~/.codex/config.toml

Windows（PowerShell）：

powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
$f = "$env:USERPROFILE\.codex\config.toml"
if (Test-Path $f) { Copy-Item $f "$f.bak" -Force }
@'
model_provider = "sub2api"
model = "claude-sonnet-5-5"
review_model = "claude-sonnet-5-5"

[model_providers.sub2api]
name = "Sub2API"
base_url = "https://demo.aiplayer.club/v1"
model_catalog_url = "https://demo.aiplayer.club/v1/models"
experimental_bearer_token = "sk-你的密钥"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

[features]
api_key_model_discovery = true
'@ | Set-Content -Encoding ascii $f
Get-Content $f

运行完，终端里会把文件内容显示一遍。检查两点：

  • base_url 后面是 https://demo.aiplayer.club/v1。
  • experimental_bearer_token 后面是你自己的密钥，不是 sk-你的密钥 这几个字。
说明
  • requires_openai_auth = false 这一行的作用是跳过 ChatGPT 登录，不要删。
  • 以前用过 Codex 的，旧配置已经自动备份成 config.toml.bak。原来有其他自定义设置的，从备份里手动合并回去。
  • 这份配置同时给 Codex 桌面版使用，配好一次，两边都能用。

三、启动并验证

1. 新建一个文件夹并进去启动：

macOS：

bash
mkdir -p ~/ai-demo && cd ~/ai-demo && codex

Windows（PowerShell）：

powershell
New-Item -ItemType Directory -Force "$HOME\ai-demo" | Out-Null; cd "$HOME\ai-demo"; codex

2. 看到输入框就成功了。 界面上会显示 OpenAI Codex 和版本号，下方有一个 › 开头的输入框，旁边显示当前模型（如 Claude Sonnet 5.5）。不会出现登录页面。

如果问你是否信任这个文件夹（trust），选 Yes 回车。

3. 发一句话试试。 输入 你好，回复 OK 就行，按回车，几秒后看到回复，就说明连通了。

4. 到网站上确认。 回到 https://demo.aiplayer.club，点左侧「使用记录」，能看到一条新记录。

说明

运行 codex login status 会显示 Not logged in（未登录），这是正常的：连本站不需要登录 ChatGPT。

日常怎么用

  • 启动：打开终端，进入你的项目文件夹，输入 codex。
  • 退出：连按两次 Ctrl + C。
  • 换模型：在输入框里输入 /model 回车选择；想长期换，把配置文件里 model 和 review_model 两行改掉。
  • 只问一句不进界面：codex exec "你的问题"。

遇到报错，看 常见问题。