macOS / Linux 安装指南

本指南面向 macOS 和 Linux 用户，使用放心API 作为 API 服务商，完成 Codex CLI 的完整安装与配置。

系统要求

macOS

Linux

macOS 10.15 (Catalina) 及以上

需要已安装 Node.js（npm）或 Homebrew

网络可正常访问（无需科学上网，放心API已做国内加速）

安装步骤

步骤 1：安装 Codex

npm（推荐）

Homebrew（macOS）

安装完成后验证：

输出版本号说明安装成功。

步骤 2：注册放心API并获取 API Key

打开浏览器，访问 https://fangxinapi.com 注册账号并登录

进入「API 密钥」或「令牌管理」页面，点击「新建密钥」，选择 Codex 分组

复制生成的 API Key，妥善保存，页面关闭后无法再次查看

步骤 3：初始化配置目录

清空并重建 Codex 配置目录：

步骤 4：创建 auth.json

在 ~/.codex/ 目录下新建 auth.json，填入步骤 2 中复制的 API Key：

写入以下内容（将 你的API_KEY 替换为实际密钥）：

{
  "OPENAI_API_KEY": "你的API_KEY"
}

保存退出（Ctrl + X → Y → 回车）。

步骤 5：创建 config.toml

在 ~/.codex/ 目录下新建 config.toml：

写入以下内容，原封不动粘贴，不要修改：

model_provider = "fangxin"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.fangxin]
name = "fangxin"
base_url = "https://fangxinapi.com/v1"
wire_api = "responses"

保存退出（Ctrl + X → Y → 回车）。

步骤 6：验证安装

重新打开终端，运行：

然后进入任意项目目录，启动 Codex：

开始使用

常用命令：

Codex 完全支持 VSCode 官方插件，安装后可在 VSCode 中直接使用。

常见问题

❌ command not found: codex

原因：npm 全局安装路径不在 $PATH 中。

macOS

Linux

❌ 401 Unauthorized / Invalid API Key

排查步骤：

确认 ~/.codex/auth.json 中的 OPENAI_API_KEY 已替换为实际密钥

登录放心API控制台，确认该 Key 属于 Codex 分组，且处于启用状态并有余额

重新打开终端后再试

❌ 连接失败 / 无法访问模型

排查步骤：

确认 config.toml 中的 base_url 为 https://fangxinapi.com/v1

确认 wire_api = "responses" 未被修改

用以下命令校验 JSON 格式是否正确：

系统要求#

安装步骤#

步骤 1：安装 Codex#

步骤 2：注册放心API并获取 API Key#

步骤 3：初始化配置目录#

步骤 4：创建 auth.json#

步骤 5：创建 config.toml#

步骤 6：验证安装#

开始使用#

常见问题#

❌ command not found: codex#

❌ 401 Unauthorized / Invalid API Key#

❌ 连接失败 / 无法访问模型#