必须先启动codex生成.config目录，再配置auth.json和config.toml，将请求导向第三方api；否则会因认证失败导致401或stream disconnected错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Codex调用GPT-5.5、DeepSeek-V3或Claude-3.7这类第三方大模型，而不是被绑定在OpenAI官方服务上，就必须绕过默认认证链，把请求精准导向你已付费开通的API中转站或直连端点。这一步不做对，后续所有提示词工程和代码生成都会卡在401或stream disconnected错误里。
确认Codex运行环境与基础文件路径
先打开终端（macOS/Linux）或命令提示符（Windows），执行以下命令验证Codex是否已初始化配置目录：
macOS/Linux：ls -la ~/.codex；Windows：dir %USERPROFILE%\.codex
如果返回“系统找不到指定的路径”或目录为空，说明Codex尚未首次启动——【必须先打开一次Codex桌面客户端，让它自动生成 .codex 文件夹】。不执行这步，config.toml和auth.json将无处落脚，后续所有编辑都无效。
首次启动后，关闭Codex再继续下一步。
准备API密钥与中转服务信息
从你选用的第三方服务商（如Token侠、EasyAPI、Codeilab或One API）控制台获取三项关键信息：
① base_url：必须以 /v1 结尾，例如 https://api.tokenxia.com/v1 或 https://token.easyapi.com/v1；
② model ID：不是“gpt-4o”这种泛称，而是服务商后台明确列出的模型标识符，如 gpt-5.5-sol、deepseek-v3、claude-3.7-sonnet；
③ API Key：长度通常为51位，以 sk- 开头，注意不要复制到空格或换行符。
特别提醒：若使用CC Switch等图形化工具，跳过手动编辑环节，直接导入即可；但本教程默认你选择原始配置方式，确保每处字段可控可查。
配置 auth.json —— 认证凭证唯一入口
用文本编辑器（推荐VS Code或Notepad++）打开 ~/.codex/auth.json（Windows为 %USERPROFILE%\.codex\auth.json）。
文件内容必须严格为单个JSON对象，且仅含一个键值对：
{"OPENAI_API_KEY":"sk-your-real-api-key-here"}
⚠️ 常见致命错误：添加逗号、换行、多余字段（如 "MODEL":"gpt-5.5"）、中文引号、末尾逗号——任何偏差都会触发 Failed to refresh token: 403 Forbidden 并阻断全部请求。
保存后，执行 chmod 600 ~/.codex/auth.json（macOS/Linux）或右键属性→安全→仅当前用户有读写权限（Windows），防止密钥被其他进程窃取。
编辑 config.toml —— 路由与协议核心
打开 ~/.codex/config.toml，按顺序完成以下修改：
第一步：在文件顶部写入全局配置块（覆盖默认OpenAI行为）：
model = "gpt-5.5-sol"model_provider = "tokenxia"model_reasoning_effort = "high"preferred_auth_method = "apikey"
第二步：在文件末尾新增provider定义段，注意方括号名称必须与 model_provider 值完全一致：
[model_providers.tokenxia]name = "Token侠 GPT-5.5特价通道"base_url = "https://api.tokenxia.com/v1"wire_api = "responses"requires_openai_auth = false
【wire_api 必须为 "responses"，不是 "chat" —— Codex CLI 和桌面版强制使用 OpenAI Responses API 协议，填错直接报 stream disconnected】
第三步：删除文件中所有残留的 [model_providers.openai] 或 [model_providers.custom] 块，避免冲突；保留 personality、projects 等非认证字段即可。
验证连接是否生效
方法一（桌面版）：重启Codex客户端 → 新建对话 → 输入 /debug info → 查看返回中 provider 是否显示 tokenxia，model 是否为你配置的 gpt-5.5-sol。
方法二（CLI）：终端执行 codex --help 确认CLI已安装；再运行 codex ask "测试连接" --model gpt-5.5-sol，成功返回结果即表示通路建立。
若仍报错 401 Unauthorized，立即检查：auth.json 是否仅含 OPENAI_API_KEY 字段、config.toml 中 wire_api 是否拼写为 responses、base_url 末尾是否有 /v1。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
