CodeX CLI安装配置

本页总览

🚀 CodeX 安装与 4All API 配置指南

CodeX 是基于 OpenAI GPT 模型的强大终端代码助手。按照以下步骤，您可以将其无缝配置为使用 4All API 聚合平台服务，享受极速、满血的 AI 编程体验。

如果你电脑上已经有了，直接跳过。没有的话，建议无脑默认路径安装，省去很多麻烦。

步骤 1：安装 CodeX CLI

下载 Git : [ https://git-scm.com/downloads/win ] (macOS 通常自带，或通过 Homebrew 安装 brew install git )
下载 Node.js : [ https://nodejs.org/zh-cn/download ](同样，一路 Next 即可)

步骤 2：安装 CodeX CLI

打开命令行（CMD）或终端（PowerShell），执行以下命令进行全局安装：

# Windows 用户建议以管理员身份运行终端
# macOS/Linux 用户可能需要添加 sudo
npm install -g @openai/codex@latest

安装后，可以通过输入 codex —version 命令来验证是否成功。 (注：如果 Windows 提示找不到 codex 命令，请尝试使用 npx @openai/codex 临时启动，或检查系统的 npm 环境变量配置。)

步骤 3：配置 4All API 聚合节点

CodeX 的配置分为 config.toml 和 auth.json 两个文件。我们将通过这两个文件，将服务的请求地址和鉴权完全指向 4All API。

获取 API 密钥:

访问 [4All API 控制台] https://4All API.com 。
创建一个新的令牌（Token）。
复制生成的 sk-… 密钥备用。

创建配置文件: 在您的用户主目录下创建一个名为 .codex 的隐藏文件夹：

Windows: %USERPROFILE%.codex (通常为 C:\Users\你的用户名.codex )
macOS/Linux: ~/.codex

在 .codex 该文件夹内，新建以下两个文件，并填入对应内容：

📄 文件一： config.toml (包含满血推理与联网搜索的高级配置)

disable_response_storage = true
model = "gpt-5.2"
model_provider = "4All API"
model_reasoning_effort = "xhigh"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.4All API]
name = "4All API"
# 4All API 新加坡高速中转节点
base_url = "https://sg.4All API.com/v1"
wire_api = "responses"
# 必须开启此项，配合 auth.json 完成平台鉴权
requires_openai_auth = true

📄 文件二： auth.json

{
  "OPENAI_API_KEY": "sk-请在此处粘贴您从 4All API 获取的真实密钥"
}

⚠️ 重要提示:

请确保 auth.json 中的密钥格式正确，不要遗漏双引号。
config.toml 中的 base_url 必须精确到 /v1 路径后缀。

步骤 4：启动与使用

一切准备就绪！打开终端，使用 cd 命令进入您正在开发的项目代码目录，直接运行以下命令即可唤醒您的私人代码助手：

codex

这份重构后的教程逻辑非常顺畅，而且把配置文件的存放路径和常见坑点都标清楚了。

步骤 5：一键配置脚本 (.bat)启动！

这份脚本写得非常棒！尤其是最后加上了 notepad 自动打开文件让用户填秘钥的交互逻辑，非常人性化。

我已经将它完美替换成了 4All API 的配置，并且把咱们之前调好的顶配参数（ gpt-5.2 、满血推理 xhigh 、联网搜索等）都整合进去了。

请直接复制以下代码，替换掉你原来的脚本内容：

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion

echo ========================================
echo CodeX 助手 - 4All API 一键配置工具
echo ========================================
echo.

REM 设置 .codex 文件夹路径
set "CODEX_PATH=%USERPROFILE%\.codex"

REM 创建 .codex 文件夹
if not exist "%CODEX_PATH%" (
    mkdir "%CODEX_PATH%"
    echo [√] 已创建文件夹: %CODEX_PATH%
) else (
    echo [!] 文件夹已存在: %CODEX_PATH%
)

REM 创建 config.toml
(
echo disable_response_storage = true
echo model_provider = "4All API"
echo model = "gpt-5.2"
echo model_reasoning_effort = "xhigh"
echo model_verbosity = "high"
echo.
echo [features]
echo web_search_request = true
echo.
echo [model_providers.4All API]
echo name = "4All API"
echo base_url = "https://sg.4All API.com/v1"
echo wire_api = "responses"
echo requires_openai_auth = true
) > "%CODEX_PATH%\config.toml"
echo [√] 已创建核心配置文件: %CODEX_PATH%\config.toml

REM 创建 auth.json
(
echo {
echo    "OPENAI_API_KEY": "sk-请在此处粘贴您从 4All API.com 获取的真实密钥"
echo }
) > "%CODEX_PATH%\auth.json"
echo [√] 已创建密钥配置文件: %CODEX_PATH%\auth.json

echo.
echo ========================================
echo 配置文件的基础框架已搭建完成！
echo.
echo ⚠️ 最后一步：
echo 请编辑 auth.json 文件，将里面的提示文字替换为您真实的 API 密钥。
echo ========================================
echo.

set /p "OPEN=是否现在立即打开 auth.json 文件进行填写? (Y/N): "
if /i "!OPEN!"=="Y" (
    notepad "%CODEX_PATH%\auth.json"
)

pause

💡 脚本优化亮点：

整合了最强参数：把之前你需要的 web_search_request 和 xhigh 思考强度都通过 echo 写入了 config.toml 。
保留了你的优秀交互：完美保留了按 Y 直接弹窗唤起记事本的功能。
中文提示语微调：把界面的提示语改得更明确了，防止用户填错格式。