auth.json 保存的是 UUcode API Key
按照 doc.uucode.top/guide/codex，auth.json 中的 uucode.api_key 应替换为控制台创建的 API Key。不要把 Key 写进项目仓库，应保存在用户目录下的 .codex 文件夹。
Codex Desktop Config
把 Codex Desktop、CLI 和 VS Code 都接到 UUcode
Codex 文档说明了手动配置与 npx token-uucode 自动配置两条路径。本页聚焦 auth.json、config.toml 和 VS Code 读取配置的开发者搜索意图。
- auth.json
- config.toml
- VS Code 终端
config.toml 决定模型提供商
config.toml 中的 model_provider、base_url 和 base_url_api 会让 Codex 通过 UUcode 访问 OpenAI 兼容或 Anthropic 兼容入口。团队应维护一份标准模板。
VS Code 读取失败通常是会话问题
如果 VS Code 内置终端无法识别 codex 或读取旧配置，先重启 VS Code，再在终端中运行 codex --version 和 codex 进行验证。
01
领取并保存 Key
在 uucode.top 创建 GPT 分组 Key，准备写入 auth.json。
02
选择配置方式
手动创建 config.toml 与 auth.json，或在终端执行 npx token-uucode 按提示完成。
03
验证三种入口
分别打开 Codex Desktop、系统终端和 VS Code 内置终端，确认都能使用 UUcode 网关。
常见问题
auth.json 可以放在项目目录吗？
不建议。Codex 文档使用用户目录下的 .codex/auth.json，避免把密钥带入项目仓库。
base_url 和 base_url_api 都要配置吗？
按 doc.uucode.top 当前 Codex 示例同时保留，可以兼容不同 API 调用路径。