跳到主要内容

ChatGPT 客户端（Codex）配置

本页配置的是 Codex 终端客户端（OpenAI 官方 CLI，命令行 codex）。 在鹊桥侧走 OpenAI 兼容接口。推荐用 CC-Switch 一键写入。

一、安装 Codex CLI​

npm（推荐，全平台）​

先确保已安装 Node.js：

npm i -g @openai/codex

Homebrew（macOS / Linux）​

brew install codex

验证​

codex --version

二、配置鹊桥（推荐：CC-Switch）​

  1. 打开 CC-Switch
  2. 选择 Codex
  3. 右上角 「+」 → 自定义配置
  4. 填写：
字段填写内容
名称鹊桥-Codex（可自定义）
请求地址 / Base URLhttps://5202828.xyz/v1
API Key / 密钥控制台复制的 sk-...
  1. 保存并 启用
  2. 新开终端 后运行：
cd 你的项目目录
codex
注意 /v1

Codex / OpenAI 兼容地址必须带 /v1： https://5202828.xyz/v1 不要只写 https://5202828.xyz。

更细步骤：配置鹊桥 · 令牌：创建 API 令牌

三、备用：环境变量方式​

Windows PowerShell（用户级永久）：

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的令牌", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://5202828.xyz/v1", "User")

macOS / Linux：

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://5202828.xyz/v1"

可写入 ~/.bashrc / ~/.zshrc 使其永久生效。

四、开始使用​

cd 你的项目目录
codex

首次启动按提示完成初始化，再试一问「回复 OK」。

常见问题​

现象处理
命令找不到npm 全局目录未进 PATH；重开终端
401令牌错误/禁用
模型不可用到 模型广场 换你分组开放的模型
路径 404确认 Base URL 带了 /v1
配置不生效CC-Switch 是否启用；是否新开终端

下一步：配置编辑器插件 → Codex 插件（VS Code）