Codex 安装配置

安装 Codex，并配置 OpenAI 兼容端点 https://api.sshgoodapi.cc/v1。

开始之前：在控制台创建 API Key。OpenAI 兼容端点为 https://api.sshgoodapi.cc/v1。

OpenAI 兼容 Base URLhttps://api.sshgoodapi.cc/v1

安装

Codex 是面向终端的 AI 编程 CLI。请先确保已安装 Node.js / npm。

全局安装 Codex CLI

bash

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

包名若随上游更新有变，以 OpenAI Codex 官方文档为准。

确认配置目录

常见配置目录为 ~/.codex/。若不存在可手动创建：

bash

mkdir -p ~/.codex
ls -la ~/.codex

配置

编写 config.toml

在 ~/.codex/config.toml 中指定模型与兼容端点（字段名以你安装的 Codex 版本为准，下列为常见写法）：

toml

model = "gpt-4o"
model_provider = "sshgood"

[model_providers.sshgood]
name = "SSH Good API"
base_url = "https://api.sshgoodapi.cc/v1"
wire_api = "chat"

编写 auth.json

json

{
  "OPENAI_API_KEY": "sk-xxx"
}

将 sk-xxx 换成控制台真实 Key。文件权限建议仅本人可读：

bash

chmod 600 ~/.codex/auth.json

环境变量备选

bash

export OPENAI_API_KEY="sk-xxx"
export OPENAI_BASE_URL="https://api.sshgoodapi.cc/v1"

验证

bash

codex "用一句话说明你已就绪"

安装（Windows）

安装 Node.js 与 Codex

powershell

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

配置目录

配置通常位于用户目录下的 .codex 文件夹，例如 %USERPROFILE%\.codex\。

powershell

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

配置（Windows）

config.toml / auth.json

内容与 macOS 相同：Base URL 使用 https://api.sshgoodapi.cc/v1，Key 使用控制台密钥。

powershell

$env:OPENAI_API_KEY = "sk-xxx"
$env:OPENAI_BASE_URL = "https://api.sshgoodapi.cc/v1"

验证

powershell

codex "用一句话说明你已就绪"

常见排查

401 / 鉴权失败：核对 Key 是否完整、是否误加空格；确认未过期/未吊销。
连错地址：OpenAI 兼容路径需带 /v1；Anthropic 风格 Claude Code 则不要擅自加 /v1。
模型不存在：请在控制台查看可用模型 ID，或参考模型 API 中的 GET /v1/models。
配置未生效：新开终端，确认读取的是你编辑的那份 config.toml / auth.json。