Codex 桌面客户端 · 4399API 使用文档

这一节以 Windows 为例。不用安装 Node.js，不用先装命令行工具。 只需要 Codex 桌面客户端和两个配置文件。

4.1 安装Codex桌面客户端#

打开 OpenAI 官方 Codex 页面，按页面提供的方式安装对应系统的桌面客户端。已经安装的用户跳过这一步。

4.2 打开配置文件夹#

同时按键盘的 Win 键 + R。Win 键就是键盘上带 Windows 图标的键。
把下面这一行复制进去，按回车：

text

%USERPROFILE%\.codex

如果打开了文件夹，继续下一节。
如果提示“找不到”，再按 Win + R，输入 %USERPROFILE% 并回车；在打开的用户文件夹里新建一个文件夹，名字填 .codex，注意开头有一个点。

原来已有配置怎么办？ 先把原有 config.toml、auth.json 复制一份到桌面作为备份。已有 MCP 或插件配置的用户，请合并对应设置，不要直接覆盖。

4.3 准备两个文件#

在 .codex 文件夹里，需要放入下面两个文件：

config.toml：告诉 Codex 使用哪个地址和模型。
auth.json：保存你刚才复制的 API 密钥。

更省事的方法： 下载 Codex 配置模板，右键压缩包选择“全部解压缩”，把解压后里面的 config.toml 和 auth.json 复制到 .codex 文件夹，再按 4.5 替换密钥。模板不包含真实密钥。

如果手动创建：打开记事本，粘贴下一节的内容，点“文件 → 另存为”；保存类型选“所有文件”，编码选 UTF-8，文件名照抄。

最容易出错的地方：文件必须叫 config.toml 和 auth.json，不能多出 .txt。Windows 11 可在文件夹顶部“查看 → 显示 → 文件扩展名”中勾选，检查完整文件名。

4.4 第一个文件：config.toml#

第一次安装、没有旧配置的用户，复制下面整段内容保存到 config.toml。代码块右上角可点击复制。已有配置请先备份，再合并设置。

toml

cli_auth_credentials_store = "file"
model_provider = "4399ai"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
model_auto_compact_token_limit = 200000
openai_base_url = "https://api.4399ai.cn/v1"

[model_providers."4399ai"]
name = "4399API"
base_url = "https://api.4399ai.cn/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

[model_providers."4399ai".capabilities]
remote_compaction = "unsupported"

[desktop]
localeOverride = "zh-CN"

这里先照抄，不需要理解每一行。示例模型为 gpt-6.1-sol，需要你的密钥所在分组支持；如提示模型不可用，请找管理员确认模型名。

这份模板按日常省费使用： 聊天内容累积到约 20 万 token 时，让 Codex 整理成摘要再继续。这个数字是“何时整理历史”，不是把模型的最大容量限制成 20 万。压缩也会消耗 token，实际费用仍取决于任务和使用量。

4.5 第二个文件：auth.json#

复制下面三行，保存到 auth.json：

json

{
  "OPENAI_API_KEY": "在这里粘贴你刚才复制的完整密钥"
}

你只需要替换中文那句话，保留两边的英文双引号。 粘贴后保存。完整密钥通常以 sk- 开头；不要把用户名、登录密码、兑换码或带星号的文字填进去。

最后检查：两个文件都在同一个 .codex 文件夹，auth.json 中已经填上你自己的密钥。

4.6 打开Codex测试#

先保存文件。如果 Codex 正在执行任务，等任务结束后再退出。
完全退出 Codex，再重新打开，让它读取新设置。
点击“新聊天”，输入：只回复 OK。
收到 OK 或正常回复，说明可以开始使用。
想确认是否走了 4399API，可回网站点左侧“使用日志”，查看刚才时间是否有调用记录。

以前的聊天仍报错，但新聊天正常？ 先在新聊天继续使用，旧聊天保留。部分旧聊天会记住旧设置，不要因此删掉聊天记录。

macOS 用户看这里#

在 Finder 菜单点“前往 → 前往文件夹”，输入 ~/.codex。目录不存在时，在自己的用户文件夹里创建 .codex。两个文件的内容与第4步相同；保存后重新打开 Codex，用新聊天测试。

接入之后，试试这样用#

不用记命令，也不用故意使用专业术语。你可以这样说：

“把这段话改得更容易懂，读者是不懂技术的人。”
“帮我整理这份表格，告诉我哪些地方需要检查。”
“帮我检查这个项目的问题，先说明要修改哪里。”

第一次先用简单任务测试。软件如果要运行命令、修改文件或请求权限，先看清说明再决定。

到这里，你已完成接入。接下来可以看看省费建议，让日常使用更省心。