2026 最新 Codex 对接 GPT API 完整教程:基于 token173 配置,零基础怎么上手?
想在 2026 年用 Codex 写代码,却卡在 API 配置上?本文用最直白的步骤,带你 10 分钟内跑通 token173 的 GPT 接口,彻底告别 401、invalid_api_key 等报错。
为什么选择 token173 作为 Codex 的 API 源?
- 额度充足:支持「无限额度」设置,基本不用担心用完。
- 分组专属:只有把令牌放在「codex专属」分组,才能被 Codex 正确识别。
- 零基础友好:无需自建中转或写转发脚本,新手复制粘贴即可。
准备工作(3 分钟)
- 打开浏览器,访问 token173.com 并注册/登录。
- 确保电脑已安装 Node.js 22+ 与 npm 10+(Windows/macOS/Linux 通用)。
- 安装 Codex 全局命令:
bash
npm install -g @openai/codex - 验证安装:
bash
codex --version
若能正常输出版本号,说明安装成功。
获取并配置 API 令牌
1. 创建 token173 令牌
- 进入「控制台 → API 令牌」。
- 点击「添加令牌」。
- 令牌分组必须选「codex专属」。
- 令牌名称随意填写。
- 额度建议设为「无限额度」。
- 其余选项保持默认,点击保存。
- 复制生成的
sk-开头密钥,稍后使用。
2. 放置配置文件
Windows 用户路径:C:\Users\你的用户名\.codex
macOS/Linux 用户路径:~/.codex
如果目录不存在,手动新建即可。目录内创建两个文件:
auth.json
{
"OPENAI_API_KEY": "sk-xxx"
}
把
sk-xxx替换成你在 token173 生成的真实密钥。
config.toml
model
name = "gpt-4o"
api
base_url = "https://api.token173.com/v1"
保存后即可关闭文件。
首次启动与模式选择
在任意项目目录下执行:
codex
首次会弹出三种模式:
– Suggest:仅给出修改建议,不改文件。
– Auto Edit:自动修改文件,但不执行命令。
– Full Auto:完全自动化,适合快速原型。
按上下键选择,回车确认。之后即可在终端或 VSCode 终端里直接用自然语言写代码。
常见报错速查
| 报错信息 | 可能原因 | 解决方法 |
|---|---|---|
| 401 invalid_api_key | 密钥未替换或分组错误 | 检查 auth.json 与分组设置 |
| model not found | config.toml 模型名错误 | 改为 gpt-4o 或 gpt-4-turbo |
| ECONNREFUSED | base_url 拼写错误 | 确认 https://api.token173.com/v1 |
更新与卸载
更新到最新版
npm update -g @openai/codex
卸载
npm uninstall -g @openai/codex
结语
按照以上步骤操作,零基础用户也能在 2026 年稳定使用 Codex + token173 GPT API。配置一次,长期享受高额度、不封号的 AI 编程体验。