CodexFree · 独立配置站

Codex 配置手册

记录客户端 + CLI 的配置方法:从接入自己的 API,到项目规则、MCP 和常见报错。示例、步骤和出处都放在文章里。

全部文章与分类检索

接入助手

选择操作系统,安装 CC Switch,再按步骤写入配置。

Codex 免登录接入在你的电脑上配置

有 API Key,但不知道填在哪里?

CC Switch 是一个有界面的开源工具。它会替你写好 Codex 配置,你只需要准备 Base URL、API Key 和模型名称。

你的电脑是什么系统?

安装 CC Switch
$ brew install --cask cc-switch

下载安装包
CC Switch / Codex不需要 ChatGPT 账号
  1. 01

    打开 CC Switch,顶部点击 Codex

    Claude、Codex、Gemini 的配置分开保存,别选错标签。

  2. 02

    点击右上角「+」,添加你的 API

    填写供应商给你的 Base URL、API Key 和模型名称;只有 Chat 接口时开启本地路由。

  3. 03

    点击「启用」,再重新打开 Codex

    看到“使用中”才算写入成功。已经打开的 Codex 不会自动读取新配置,必须完整退出。

看到“使用中”后,重新打开 Codex

不再走 ChatGPT 登录 · 模型请求由你的 API 提供

常见问题

一定要登录 ChatGPT 才能用吗?

使用兼容的第三方 API 时,可以不登录 ChatGPT/OpenAI 账号,但仍需要供应商提供的 API Key。云端任务和账号同步等功能可能仍依赖官方账号。

免费 API 现在可以领取吗?

还在筹备中,目前仅开放邮箱预约。具体模型、免费额度、限速和开放时间会在发放时说明,现在登记不会立即获得 Key。

客户端和 CLI 都能按这里配置吗?

本站提供客户端 + CLI 的接入步骤。两者通常共用 ~/.codex 配置,但需要确认 CODEX_HOME 与凭据来源一致,并在修改后重启相应进程。

任何兼容 OpenAI 的 API 都能直接用吗?

不一定。Codex 需要 Responses API;只有 Chat Completions 的供应商还需要适配。接入指南与工具箱会说明应该检查的协议、地址和模型名。

我需要把 API Key 填到这个网站吗?

不需要。API Key 在你自己的电脑上通过 CC Switch 或 Codex 配置。本站配置生成器只需要变量名,不收集真实密钥;免费 API 预约只需要邮箱。

免费 API 开放通知

目前尚未开放。留下邮箱,开放后会收到 Key、Base URL、模型、额度说明和接入步骤。

仅用于 API 发放相关通知。详见隐私政策。