适用系统:Ubuntu22.04文档用途:按顺序复制粘贴命令,即可完成 Codex 中转站配置
一、前置检查
打开终端(快捷键 Ctrl + Alt + T),执行以下命令确认当前用户:
whoami如果输出不是 用户名,请先执行 su – 用户名 切换用户。
二、安装 Codex 扩展(图形化操作)
此步骤需在 VS Code 界面中手动完成,终端无法执行。
- 打开 VS Code。
- 点击左侧 扩展 图标(或按 Ctrl + Shift + X)。
- 搜索 Codex 或 openai.chatgpt。
- 点击 安装。
如果已经安装过此扩展,请直接跳过本步骤。
三、自动获取 Codex CLI 路径(设置变量)
在终端中执行以下整段脚本,它会自动找到扩展安装目录并设置 CODEX_BIN 变量:
EXT_DIR=$(ls -d ~/.vscode/extensions/openai.chatgpt-* 2>/dev/null | head -1) if [ -z "$EXT_DIR" ]; then echo "错误:未找到 Codex 扩展,请先安装。" exit 1 fi export CODEX_BIN="$EXT_DIR/bin/linux-x86_64/codex" echo "Codex CLI 路径: $CODEX_BIN"预期输出:显示类似 /home/sr/.vscode/extensions/openai.chatgpt-26.803.41515-linux-x64/bin/linux-x86_64/codex 的路径。
四、创建配置目录
mkdir -p ~/.codex**无输出,继续执行下一步
说明:~/.codex 是 Codex 存放配置文件和认证信息的目录。
五、使用 API Key 登录
执行以下命令,粘贴 API Key 后按回车(输入时不会显示字符):
read -s -p '请输入 API Key(粘贴后按回车): ' CODEX_KEY echo printf '%s' "$$CODEX_KEY" | "$$CODEX_BIN" login --with-api-key unset CODEX_KEY**代码输入后会显示
复制API Key 然后粘贴至此处,粘贴后不会显示密钥
然后回车
预期效果:终端显示登录成功或 Logged in successfully 类似信息。
六、写入中转站配置文件 config.toml
执行以下命令,将中转站配置写入文件:
cat > ~/.codex/config.toml << "EOF" model = "gpt-5.6-sol" model_provider = "cliproxyapi" model_reasoning_effort = "high" [model_providers.cliproxyapi] base_url = "http://38.175.220.213:8080/v1" name = "cliproxyapi" wire_api = "responses" EOF**此处输入后无显示
base_url 末尾必须包含 /v1。
七、收紧文件权限(安全设置)
chmod 700 ~/.codex chmod 600 ~/.codex/config.toml ~/.codex/auth.json**输入后无显示
确保只有用户能读取配置和认证文件,防止 Key 泄露。
八、验证配置是否成功
执行以下测试命令:
"$CODEX_BIN" exec --skip-git-repo-check 'Reply with exactly: CONNECTION_OK'成功标志:终端输出包含 CONNECTION_OK,并且在日志中能看到:
- provider: cliproxyapi
- model: gpt-5.6-sol
九、重启 VS Code 使配置生效
- 完全退出 VS Code(关闭所有窗口,检查系统托盘或任务管理器确保进程已结束)。
- 重新打开 VS Code。
- 打开 Codex 面板,输入测试消息验证是否正常回复。