Create 文章 “codex-cli简单配置第三方兼容api”

content/blog/codex-cli简单配置第三方兼容api.md

@@ -0,0 +1,126 @@
+---
+title: Codex CLI简单配置第三方兼容API
+date: 2026-03-08T23:56:00.000+08:00
+author: 线粒体
+---
+## 引言
+
+Codex CLI是OpenAI推出的AI编程Agent工具，类似Claude Code。据说它可以取代Claude Code，成为最好的CLI编程工具；不过在下对此不置可否。CLI相较于GUI插件的一个显著的好处是，大部分代码编辑器都可以用，因为它的运行只依赖终端，而且也比较稳定。所以我个人还是比较喜欢CLI。
+
+最近我有幸用到了大佬的Codex中转站，故在此将我配置Codex CLI的经验作一分享。
+
+> [!NOTE]
+> 本文所用环境是Windows和Windows PowerShell，Linux可以参考适用，大同小异。
+
+## 安装
+
+安装Codex CLI，运行如下命令：
+
+```powershell
+npm i -g @openai/codex
+```
+
+验证安装是否成功，运行：
+
+```powershell
+codex --version
+```
+
+若输出版本号，即代表安装成功。
+
+## 配置文件介绍
+
+如果仅仅是使用OpenAI官方提供的接口来使用模型，那么直接运行：
+
+```powershell
+codex
+```
+
+然后按照交互式指引，登录OpenAI账号或填入API Key即可。但是本文介绍的是使用第三方中转站（即OpenAI兼容API）来使用模型，因此需要关注一些配置文件。
+
+Codex CLI的配置文件位于用户家目录（即`C:\Users\<用户名>\.codex`）中。为了配置第三方API，需要修改这里的`config.toml`。在初次安装且未进行配置的情况下，`config.toml`应该是不存在的，因此需要手动创建。创建好后，编辑该文件，写入如下模板内容：
+
+```toml
+model_provider = "custom"
+model = "gpt-5.3-codex"
+model_reasoning_effort = "medium"
+preferred_auth_method = "apikey"
+
+[model_providers.custom]
+name = "custom"
+base_url = "http://api.custom.ai/v1"
+wire_api = "responses"
+env_key = "CUSTOM_OPENAI_API_KEY"
+requires_openai_auth = true
+```
+
+这个内容等一下还要进行修改。我们要确认已经获得了以下三项必要信息：
+
+- 第三方API的Base URL
+- 第三方API的Key
+- 第三方API可用的模型名
+
+才能进行这里的配置。因此需要先从第三方站那里获取这些信息，各家不同，此不赘述。
+
+## 修改配置文件
+
+首先，Codex CLI支持配置多个`model_provider`。每个定义时用`[model_providers.xxx]`开头，然后写入各项参数。文件开头的：
+
+```toml
+model_provider = "xxx"
+```
+
+即CLI默认选用的`model_provider`。接下来我们自定义一个`[model_providers.custom]`。
+
+修改模板中的`base_url`为第三方API的Base URL：
+
+```toml
+base_url = "http://api.custom.ai/v1"
+```
+
+修改`env_key`为一个自定义的环境变量名，比如：
+
+```toml
+env_key = "CUSTOM_OPENAI_API_KEY"
+```
+
+这行配置的意思是，CLI要去这个环境变量里找API Key。所以需要修改环境变量。对于Windows 11，打开系统设置—系统信息—高级系统设置—环境变量，然后添加一个用户变量，名为刚才定义的名字，值为第三方API提供的API Key。
+
+> [!NOTE]
+> 有些人认为配置环境变量很麻烦，所以在此也有第二种方法。
+> 
+> 首先，删去`env_key`字段。当一个`model_provider`没有配置`env_key`的时候，CLI就会去读取和`config.toml`同目录的`auth.json`，来获取API Key。
+> 
+> 新建`auth.json`文件，写入：
+> 
+> ```json
+> {
+> "OPENAI_API_KEY": "apikey-xxxxxx"
+> }
+> ```
+> 
+> 这里`"OPENAI_API_KEY"`这个变量名是不能改的，否则就会读取不到。只要将后面的值替换成自己的API Key即可。
+> 
+> 这样做的缺点是，如果配置了多个`model_provider`，且都没有设置`env_key`，那么它们就会读取同一个Key。
+
+最后配置使用的模型。这个配置在CLI里也可以以交互式方式设置（通过`/model`指令）。修改文件开头的`model`为第三方API提供的任一可用模型，例如：
+
+```toml
+model = "gpt-5.3-codex"
+```
+
+然后就可以使用了。至于详细的配置文档，可以参考[官方文档](https://developers.openai.com/codex/config-basic)。
+
+## 使用
+
+在任意文件夹运行：
+
+```powershell
+codex
+```
+
+即可启动Codex CLI，使用的是我们刚才配置的`custom`。可以根据提示进行个性化配置。
+
+## 结语
+
+本文所述方法只是最简单的配置，更多用法可以参考[官方文档](https://developers.openai.com/codex/cli)。不当之处，欢迎指正！