Codex 命令行

Codex 命令行接入 Token Share

安装 Codex CLI,用现成的 config.toml 接入 Token Share,覆盖 macOS、Linux 和 Windows。另附一条不改任何配置的临时命令。

安装 Codex CLI

  1. 1登录 Token Share,打开 API Keys 页面。
  2. 2点击「创建 Key」,类型选「推理」,复制以 sk-token- 开头的密钥。完整密钥只显示这一次。
  3. 3在 账单页面 用 USDT 充值。Claude 系列模型只能用充值余额支付。

Codex CLI 通过 npm 安装,需要先装好 Node.js 22 或更新版本。

  1. 1到 Node.js 官网 下载:版本选 LTS,点「macOS 安装程序 (.pkg)」,下载后双击安装。Linux 用系统的包管理器安装即可。
  1. 2打开「终端」:按 ⌘ + 空格,输入「终端」后回车;也可以在启动台的「其他」里找到它。
  1. 1到 Node.js 官网 下载:版本选 LTS,点「Windows 安装程序 (.msi)」,安装时一路默认「下一步」即可。
  1. 2打开终端:按 Win + S,搜索「终端」(Windows 10 搜「PowerShell」)并打开。下面所有命令都在这里输入。

如果 PowerShell 提示「无法加载文件 …\npm.ps1,因为在此系统上禁止运行脚本」,先执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,输入 Y 回车,再重新运行刚才的命令。

然后在终端里执行:

npm install -g @openai/codex
codex --version

国内网络下载慢或卡住,在安装命令末尾加上 --registry=https://registry.npmmirror.com 再试。

接入 Token Share

这一步会把 Token Share 写进 ~/.codex/config.toml,并把 Key 保存为环境变量 TOKEN_SHARE_KEY。原有的配置文件会备份成 config.toml.bak。

整段只需要改一处:把 <your-pool-api-key> 换成你的 Key,两边的引号保留。然后把整段粘贴进终端,回车。

mkdir -p ~/.codex
[ -f ~/.codex/config.toml ] && cp ~/.codex/config.toml ~/.codex/config.toml.bak
cat > ~/.codex/config.toml <<'EOF'
model_provider = "token_share"
model = "gpt-5.6-sol"

[model_providers.token_share]
name = "OpenAI"
base_url = "https://token-share.app/v1"
wire_api = "responses"
env_key = "TOKEN_SHARE_KEY"
requires_openai_auth = false
EOF
[ -f ~/.codex/auth.json ] || printf '%s\n' '{"OPENAI_API_KEY":"sk-placeholder"}' > ~/.codex/auth.json

SHELL_RC="$HOME/.zshrc"; case "$SHELL" in *bash*) SHELL_RC="$HOME/.bashrc";; esac
echo 'export TOKEN_SHARE_KEY="<your-pool-api-key>"' >> "$SHELL_RC"
source "$SHELL_RC"
$key = "<your-pool-api-key>"

$dir = "$HOME\.codex"
New-Item -ItemType Directory -Force -Path $dir | Out-Null
if (Test-Path "$dir\config.toml") { Copy-Item "$dir\config.toml" "$dir\config.toml.bak" -Force }
[IO.File]::WriteAllText("$dir\config.toml", @'
model_provider = "token_share"
model = "gpt-5.6-sol"

[model_providers.token_share]
name = "OpenAI"
base_url = "https://token-share.app/v1"
wire_api = "responses"
env_key = "TOKEN_SHARE_KEY"
requires_openai_auth = false
'@)
if (-not (Test-Path "$dir\auth.json")) { [IO.File]::WriteAllText("$dir\auth.json", '{"OPENAI_API_KEY":"sk-placeholder"}') }

[Environment]::SetEnvironmentVariable("TOKEN_SHARE_KEY", $key, "User")
$env:TOKEN_SHARE_KEY = $key

重新打开一个终端,进入项目文件夹,执行 codex 即可。

想换模型,把 ~/.codex/config.toml 里的 model = "gpt-5.6-sol" 改成 模型列表 里任意一个 GPT 模型。

不改配置,临时试用

这条命令和控制台「快速开始」里的一样。所有设置都通过命令行参数传入,除了首次运行时写一个占位的 auth.json,不改动任何文件。

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME"

# API key
export TOKEN_SHARE_KEY="<your-pool-api-key>"

# First-time initialization
[ -f "$CODEX_HOME/auth.json" ] || {
  printf '%s\n' '{"OPENAI_API_KEY":"sk-placeholder"}' > "$CODEX_HOME/auth.json"
  chmod 600 "$CODEX_HOME/auth.json"
}

# Run Codex
codex \
  --config 'model_provider=token_share' \
  --config 'model_providers.token_share.name="OpenAI"' \
  --config 'model_providers.token_share.base_url="https://token-share.app/v1"' \
  --config 'model_providers.token_share.wire_api="responses"' \
  --config 'model_providers.token_share.env_key="TOKEN_SHARE_KEY"' \
  --config 'model_providers.token_share.requires_openai_auth=false' \
  --config 'check_for_update_on_startup=false' \
  --config 'analytics.enabled=false' \
  --config 'feedback.enabled=false' \
  --model 'gpt-5.6-sol'

这条命令适用于 macOS 和 Linux 终端。Windows 请使用上面的配置文件。

换回 ChatGPT 账号

把 ~/.codex/config.toml.bak 改回 config.toml;如果之前没有备份文件,直接删掉 config.toml。然后重启 Codex。

常见问题

现象解决办法
Missing environment variable: TOKEN_SHARE_KEYCodex 是在保存 Key 之前启动的。彻底退出后重新打开;Windows 上还要重新开一个终端。
401 invalid api keyKey 粘贴有误。重新复制 Key,再执行一次 配置命令。
仍然要求登录 ChatGPT配置没有被读到。确认 ~/.codex/config.toml 第一行是 model_provider = "token_share",然后重启 Codex。

不想改文件?用 CC Switch 点几下也能完成同样的配置。

准备好了?三步即可开始

  1. 1登录控制台
  2. 2充值余额
  3. 3创建 API Key