文章目录
这篇文章是写给拿到爱居山 Codex 账号的朋友：你已经有了一组邮箱和密码，接下来只要按下面步骤操作，就能在 Codex App 或 Codex CLI 里用上 GPT。
整个流程分三步：① 登录网站 → ② 创建 API Key → ③ 配置 Codex。每一步都有截图说明，跟着走就行。
一、登录爱居山 Codex 中转站
- 打开浏览器，访问
https://codex.ijushan.com - 在登录页面输入你的邮箱和密码（密码由爱居山统一发放，如果没有请找管理员索取）
- 点击「登录」按钮
- 登录成功后，你会看到 Dashboard（仪表板） 页面
⚡ 提示：如果登录后看到的是英文界面，可以在页面右上角点击语言切换（🌐 图标），选择「简体中文」。
二、创建 API Key（最重要的一步）
登录后，你需要创建一个 API Key。这个 Key 就是 Codex 连接中转站的"通行证"。
- 在左侧菜单栏点击 「Keys」（钥匙图标）或 「API Keys」
- 进入 Keys 页面后，点击右上角的 「创建 Key」 按钮（蓝色按钮，带 + 号）
- 在弹出的对话框中：
- 名称：随便填，比如「我的Windows电脑」或「Codex App」
- 分组：选择默认分组即可（通常已自动选中）
- 过期时间：可以留空（永不过期），也可以设一个日期
- 点击 「创建」
- ✏️ 立即复制：创建成功后会显示完整的 Key 字符串（以
sk-开头）。这是你唯一能看到完整 Key 的机会，请立刻复制并保存到安全的地方。
这个 Key 稍后就会填到 Codex 的配置里。如果不小心关掉了对话框，可以在 Keys 页面找到刚才创建的 Key，点击旁边的复制按钮重新复制。
Base URL：Codex 中转站的地址是 https://codex.ijushan.com，后面配置时会用到。
三、先判断你属于哪种使用方式
爱居山 Codex 中转可以按两种方式使用。你拿到账号后，先看自己属于哪一种：
| 方式 | 适合谁 | 要做什么 |
|---|---|---|
| 方式 A：登录网站创建自己的 API Key | 拿到个人邮箱和密码的普通用户 | 先登录 https://codex.ijushan.com，到 Keys 页面创建 Key，再配置 Codex |
| 方式 B：管理员已给你 Key / CC Proxy 已统一管理 | 已有 sk-... Key，或团队统一用 CC Proxy / 中转服务 | 不用再创建 Key，直接把 Key 和 base_url 写进 Codex 配置 |
如果你不确定，按方式 A 做。个人账号页上已经写了你的登录邮箱、username、初始密码和本教程链接。
四、配置 Codex（二选一）
拿到 API Key 之后，你可以选择配置 Codex CLI（命令行方式）或 Codex App（桌面图形界面）。两者的配置逻辑一样：告诉 Codex 用你的中转站地址和 Key。
方式一：Codex CLI（命令行，推荐给开发者）
3.1 安装 Codex CLI
如果你还没有安装 Codex CLI，先安装：
# Windows (PowerShell 管理员) irm https://codex.openai.com/install.ps1 | iex # macOS / Linux curl -fsSL https://codex.openai.com/install.sh | sh
安装完成后，打开一个新的终端窗口，输入 codex 确认可以运行。
3.2 配置 API Key 和 Base URL
最小配置：只需要设置两个东西——API Key 和 Base URL。
第一步：设置环境变量
# Windows PowerShell $env:OPENAI_API_KEY = "sk-你的Key（在第2步创建的）" # macOS / Linux (bash/zsh) export OPENAI_API_KEY="sk-你的Key（在第2步创建的）"
建议把这一行加到你的 shell 配置文件中（Windows 用户环境变量，或 ~/.bashrc / ~/.zshrc），这样每次打开终端都自动生效。
第二步：编辑 config.toml
找到 Codex 配置文件 ~/.codex/config.toml（Windows 在 C:Users你的用户名.codexconfig.toml）。如果文件不存在，可以新建一个。
最简配置——只写这几行就够了：
model_provider = "OpenAI" model = "gpt-5.5" review_model = "gpt-5.5" model_reasoning_effort = "medium" disable_response_storage = true network_access = "enabled" windows_wsl_setup_acknowledged = true [model_providers.OpenAI] name = "OpenAI" base_url = "https://codex.ijushan.com" wire_api = "responses" requires_openai_auth = true
保存后，重新打开终端，运行 codex 就能使用了。
方式二：Codex App（桌面版，Windows 图形界面）
3.3 安装 Codex App
从 OpenAI 官网下载 Codex App 并安装（Windows 版）。安装完成后启动 App。
3.4 配置 API Key 和 Base URL（桌面版）
Codex App 启动后，有两种配置方式：
方法 A：通过环境变量（推荐）
- 打开 Windows「系统属性」→「环境变量」
- 在用户变量中，新建变量
OPENAI_API_KEY，值为sk-你的Key - 确认并关闭
方法 B：通过 auth.json 文件
在 C:Users你的用户名.codex 目录下新建 auth.json 文件，内容为：
{
"OPENAI_API_KEY": "sk-你的Key"
}
两种方法任选一个就行。然后编辑 config.toml，写入和 CLI 版相同的最简配置（见 3.2 节）。
配置完成后，完全退出 Codex App（右键任务栏图标退出，不要只关窗口），再重新启动。启动后 App 会自动读取配置。
⚡ 注意：Codex App 首次启动时可能提示选择认证方式，选择「API Key」方式即可。如果已经登录了 OpenAI 官方账号，需要先注销或用 preferred_auth_method = "apikey" 强制走 API Key。
方式三：直接使用 Keys 页面的「使用此 Key」功能（最简单）
在 codex.ijushan.com 的 Keys 页面，每个 Key 旁边有一个「使用」按钮。点击后可以选择平台（OpenAI → Codex），网站会自动生成 config.toml 和 auth.json 内容。直接把生成的文本复制到对应文件即可，省去手写配置。
四、验证是否配置成功
配置完成后，在 Codex CLI 终端或 Codex App 中输入：
你好，请用一句话介绍你自己
如果 GPT 正常回复了，说明配置成功 ✅。
如果出现报错（如 401、连接超时、Reconnecting 等），检查：
- Key 是否以
sk-开头，没有多余空格 base_url是否写的是https://codex.ijushan.com（注意是https）- Key 是否在网站上处于「Active」状态（在 Keys 页面确认）
- 是否完全退出了 Codex App 再重新启动
五、换 Key 或更新配置
如果你以后需要换一个新的 Key：
- 到
codex.ijushan.com→ Keys 页面，创建一个新 Key - 复制新 Key
- 更新你电脑上的
OPENAI_API_KEY环境变量或auth.json文件 - 重启 Codex CLI 终端 或 退出 Codex App 再打开
六、常用模型
你的 API Key 默认可以访问以下模型：
| 模型名 | 说明 | 推荐场景 |
|---|---|---|
gpt-5.5 | GPT-5.5，最新旗舰模型 | 复杂编程、深度分析 |
gpt-5.4 | GPT-5.4 | 日常编程、一般任务 |
gpt-5.4-mini | GPT-5.4 Mini | 快速任务、轻量编程 |
gpt-5.3-codex | Codex 专用模型 | 大规模工程、项目管理 |
gpt-5.3-codex-spark | Codex Spark | 快速代码生成 |
gpt-image-2 | GPT Image 2 | 图片生成 |
在 config.toml 中修改 model = "gpt-5.5" 即可切换。
七、CC Proxy / 中转登录与 Key 使用方式
原来的 CC Proxy 配置文章已经合并到这里。简单说，Codex 本机只需要两样东西：base_url 和 API Key。区别在于这个 Key 是用户自己登录网站创建，还是管理员在中转后台统一生成。
7.1 普通用户：先登录网站，再创建自己的 Key
- 适合：张萍、史亚男、苏明明、黄望全、蒋斌这类已经分配个人账号的用户。
- 操作：打开
https://codex.ijushan.com，用个人邮箱和密码登录。 - 登录后进入 Keys / API Keys 页面，点击「创建 Key」，复制生成的
sk-...。 - 再按本文前面的 Codex CLI / Codex App 配置方法，把 Key 写入环境变量或
auth.json。
7.2 管理员/团队：直接分发 Key 或统一 CC Proxy
- 适合：管理员已经帮你创建好
sk-...Key，或者团队统一通过 CC Proxy / Sub2API / New API / LiteLLM 管理上游账号。 - 操作：用户不一定需要登录后台，只要拿到 Key 和
https://codex.ijushan.com这个 Base URL，就可以直接配置 Codex。 - 建议：仍然每个人单独一个 Key，方便查看用量、限制额度、泄露后单独删除。
7.3 不要混用官方 OpenAI 登录态
如果你的目标是走爱居山中转，就不要依赖 Codex App 里原来的官方 OpenAI 登录状态。配置里建议明确写：
preferred_auth_method = "apikey"
这样 Codex 会使用你提供的 API Key 和 Base URL，而不是继续请求 api.openai.com。
八、如果需要更完整的 Codex App 配置（含 CC Proxy、MCP 等）
上面的最简配置已经可以正常使用了。如果你还需要配置 CC Proxy、MCP、插件、marketplace 等高级功能，参考下面完整模板。用户名、项目路径、Codex 内部版本目录需要按自己电脑替换。
model = "gpt-5.5" model_provider = "ijushan" model_reasoning_effort = "medium" preferred_auth_method = "apikey" approval_policy = "never" sandbox_mode = "danger-full-access" disable_response_storage = true windows_wsl_setup_acknowledged = true personality = "pragmatic" web_search = "live" [sandbox_danger_full_access] network_access = true [features] exec_policy = true unified_exec = true powershell_utf8 = true steer = true multi_agent = true js_repl = false [notice] hide_full_access_warning = true hide_rate_limit_model_nudge = true [notice.model_migrations] "gpt-5.2-codex" = "gpt-5.3-codex" [chat] default_system_prompt = "请始终使用简体中文回答，并保留技术术语" [windows] sandbox = "elevated" [model_providers.ijushan] name = "ijushan" base_url = "https://codex.ijushan.com" wire_api = "responses" env_key = "OPENAI_API_KEY" requires_openai_auth = true
文件位置：
- Windows：
C:Users你的用户名.codexconfig.toml - macOS / Linux：
~/.codex/config.toml
如果你不想手写环境变量，也可以把 API Key 放在 C:Users你的用户名.codexauth.json：
{
"OPENAI_API_KEY": "sk-你的Key"
}
九、如果遇到问题
- 401 错误：API Key 不正确或已过期。到 Keys 页面检查 Key 状态。
- 连接超时 / Reconnecting：检查
base_url是https://codex.ijushan.com，不是http。 - 模型不可用：检查
model字段写的模型名是否正确（见第六节的模型列表）。 - 仍然请求 api.openai.com：检查
config.toml里的base_url是否正确写入，并且是在[model_providers.xxxx]段里，不是在顶层。 - 忘记密码：联系管理员重置。
- Key 泄露：立即到 Keys 页面删除泄露的 Key，然后创建新 Key。
如有其他问题，请联系爱居山管理员。
