认识三个工具,确认电脑版本
在 Windows 桌面操作
你会用到三个窗口。Edge 浏览器里打开 KeikoAI,负责账号、密钥和用量。CC Switch 是配置工具,告诉 Codex 把问题发到哪里。Codex CLI 是提问的地方,它运行在 Windows 的命令窗口 PowerShell 里。
- 保存设置
- CC Switch → Codex 的本机配置文件
- 发送提问
- Codex → KeikoAI → 模型。回复沿原路回到 Codex。
- 接口地址 · Base URL
- Codex 发请求的地址。在第 2 步从站点给出的配置里取。
- 密钥 · API Key
- 允许软件使用你额度的凭证。网站登录用邮箱和密码,调用模型用密钥。
- 模型名 · Model ID
- 告诉站点用哪个模型回答。填写时要保留字母、数字、大小写和连字符。
- 查看 Windows 版本。按住键盘上的 Windows 徽标键,再按 R。松开后输入
winver,按 Enter(回车)。记下窗口里的 Windows 10 或 11,点「确定」。Windows 11 是首选,Windows 10 需更新到较新的版本。 - 找到安装包类型。按 Win + I 打开设置,进入「系统 → 系统信息」(部分版本叫「关于」),找「设备规格 → 系统类型」。记下 基于 x64 的处理器或 基于 ARM 的处理器。本教程的安装包适用于 64 位 Windows。
- 认识复制键。选中文字,按 Ctrl + C 复制,在目标窗口按 Ctrl + V 粘贴。本页的命令框也可以点「复制」。每次粘贴一条,看清内容再按回车。
本步通过你能说出自己的 Windows 版本和处理器类型,也知道去 KeikoAI 取密钥、去 CC Switch 填配置、去 Codex 发消息。
找不到“系统类型”?点开始菜单,搜索「关于你的电脑」或「系统信息」,打开带有“设备规格”的设置页。显示 32 位操作系统时,请换到支持的 64 位 Windows 电脑继续。
在 KeikoAI 准备账号和密钥
在 Edge 浏览器操作 · 先确认页首的地区条件
- 打开官网。点开始菜单,输入
Edge,打开 Microsoft Edge。按 Ctrl + L 选中地址栏,输入https://keiko.lol后回车。看到 KeikoAI 后进入登录页。已有账号就用自己的邮箱和密码登录。打开登录页 - 第一次使用就注册。在登录页点「注册」,输入自己能收信的邮箱,设置密码并再输一次。当前公开设置列出
@qq.com和@gmail.com,以注册框提示为准。阅读条款后,如适用且同意,勾选协议,完成页面的人机验证,点「继续」或注册按钮。在邮箱验证页点「发送验证码」(若已发送就查收),将最新邮件的 6 位数字填回该页,点「验证并创建账户」。登录后应能打开「仪表盘」。打开注册页 - 确认有可用额度。在「仪表盘」查看余额。如果使用套餐,打开「我的订阅」,核对分组、有效期和剩余额度。两处都没有可用额度时,可在站内「余额购买」查看当前价格和权益,自行决定是否开通。已有本站余额兑换码时,进「兑换」,粘贴兑换码,点「兑换」,再回仪表盘核对新余额。第 5 步的真实调用需要可用额度。仪表盘 · 我的订阅
- 创建一个专供本教程使用的密钥。点左侧「API 密钥 → 创建密钥」。在「名称」填
codex-windows。若显示「厂商」,选 OpenAI,再从「分组」中选自己有权使用、提供 GPT / Codex 的组。其余可选项先保留默认,点「创建」。回到列表应出现同名密钥,状态为启用。已有可用的专用密钥也可沿用,后文请把示例名称换成自己的。进入 API 密钥页 - 取出完整密钥。用创建结果或该行密钥旁的复制按钮取得完整值,并妥善保存到自己的密码管理器。页面上的圆点、省略号及密钥名称都不能当作密钥填写。保留这个网页标签,第 4 步再复制一次,直接粘进 CC Switch 的「API Key」。
- 找到这个分组的接口和模型。在同一行点「使用密钥」,选普通的 Codex CLI 标签,操作系统选 Windows。找到
config.toml的预览,从base_url和model两行分别取出英文双引号之间的值。再核对wire_api是responses。这几行供你对照,不需要编辑文件。
base_url = "https://keiko.lol/v1"
model = "gpt-5.5"
wire_api = "responses"
例如,上面的接口框应填 https://keiko.lol/v1。模型框只有在你的分组实际列出 gpt-5.5 时才填这个名字。模型和额度随账号而变。依次复制每一项,剪贴板通常只会粘贴最近一次复制的内容。
本步通过能重新找到启用的密钥、所属分组、Codex 基础地址和模型 ID。密钥的完整值留在自己的设备上。
卡在这里?收不到验证码 · 没有可选分组或 Codex 标签
在 PowerShell 安装 Codex CLI
在 Windows 命令窗口操作 · 使用 OpenAI 独立安装程序
- 打开普通 PowerShell。点开始菜单,输入
Windows PowerShell,点「打开」。看到类似 PS C:\Users\你的用户名> 的一行,就可以输入命令了。电脑上已经安装过 Codex 的读者可以先做下面的版本检查。 - 运行官方 Windows 安装命令。复制下面整行,在刚打开的窗口粘贴并回车。它从 OpenAI 的地址下载安装脚本,在单独的 PowerShell 进程内运行。安装阶段需要联网,此处无需填写 KeikoAI 密钥。核对官方命令(选 Windows)
PowerShell · 安装 Codex CLI powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"等待下载完成。看到 installed successfully 表示安装程序已完成。若它问 Start Codex now?,输入
n再回车,等配好 CC Switch 后启动。 - 重新打开窗口并查版本。关掉刚才的 PowerShell 窗口(如果只有这一项,关闭整个终端窗口即可)。从开始菜单重新打开 Windows PowerShell,执行下面一行,让新窗口读取更新后的命令路径。
PowerShell · 检查安装 codex --version正常会显示 codex-cli 和一串版本号,例如 codex-cli 0.170.0。数字随安装版本变化。看见版本号就可以进行下一步。
本步通过新开的 PowerShell 能显示 Codex 版本号。这个测试只检查本机安装,不消耗 KeikoAI 额度。
看到红字?下载失败或找不到 codex 命令。旧版 PowerShell 若无法用 Ctrl + V,可在输入光标处单击鼠标右键粘贴。
安装 CC Switch,填好连接配置
先在 Edge 下载安装包,再打开 CC Switch · 界面按 4.0.35 说明
- 按处理器类型下载。打开官方发布页,找到 Assets(发布文件,折叠时点开)。普通 Intel / AMD 的 x64 电脑选文件名以
-Windows.msi结尾的包,ARM64 电脑选-Windows-arm64.msi。文件名前面还有CC-Switch-v和版本号。官方发布页 · 官方下载页 - 打开安装程序。在 Edge 按 Ctrl + J 查看下载,打开刚下好的
.msi文件。按向导点「Next / 下一步 → Install / 安装 → Finish / 完成」。从开始菜单搜索并打开 CC Switch。看到应用侧栏,就完成了软件安装。 - 新建 Codex 的直连配置。在 CC Switch 左侧点「Codex」,进入「直连」页,点右上角「+ 添加供应商 → 全部 → 自定义配置」。要是以前配过,先记下哪张卡片显示「使用中」,以后可以切回。若侧栏没有 Codex,点侧栏下方「应用」,打开 Codex 的侧栏显示,再回来。
| CC Switch 字段 | 该填什么,以及怎样核对 |
|---|---|
| 名称 | 填 KeikoAI。这是稍后用来识别供应商卡片的名字。 |
| 网站链接 | 可填 https://keiko.lol。它用于打开网站。下方的请求地址还要单独填写。 |
| 请求地址 / Base URL | 取第 2 步 base_url 的值。普通 OpenAI 分组示例为 https://keiko.lol/v1。照抄站点提供的路径,保留一个 /v1(若有),去掉引号。“完整 URL”开关保持关闭,让 Codex 自己拼上 /responses。 |
| API Key | 回到「API 密钥」列表,复制 codex-windows 的完整密钥,立即切回 CC Switch 粘贴。只粘贴值本身。填完后,输入框通常以圆点显示。 |
| 默认模型 / 模型列表 | 看到「默认模型」框时,直接填第 2 步 model 的值。若界面显示模型列表,可点「手动添加」,在「实际请求模型」填该 ID,「菜单显示名」也可填同一 ID。已有多行时,按住行首拖动手柄,把要用的模型拖到第一行。 |
| 上游格式 | 展开「高级选项」后,如显示此项,选 Responses(原生),对应站点的 wire_api = "responses"。其余参数保留默认。 |
- 保存并切换。填好后点页脚「添加」。回到列表后,在 KeikoAI 卡片点「切换」。若原先处于路由或聚合模式,改点这张卡上的「回到直连并使用」。检查直连标签的「生效中」和卡片的「使用中」。查看官方切换说明
- 让新配置生效。如果 Codex 已经打开,在空闲的 Codex 输入框键入
/quit并回车,或关闭该终端窗口。第 5 步会重新启动 Codex,让它读取刚保存的连接信息。
本步通过你在「Codex → 直连」中看到 KeikoAI 卡片显示「使用中」。打开铅笔形的编辑按钮还能核对接口地址和模型,核对后返回列表即可。
结果不同?找不到供应商或切换不生效 · 获取模型列表失败
发一条消息,再去 KeikoAI 对记录
文件资源管理器 → PowerShell → Codex → KeikoAI 浏览器标签页
这一次会真实使用模型,可能消耗额度。准备一个空文件夹和一句很短的提问,就能把本次测试与其他使用记录区分开。
- 新建练习文件夹。按 Win + E 打开文件资源管理器。按 Alt + D 定位到顶部地址栏,输入
%USERPROFILE%后回车,进入自己的用户文件夹。按 Ctrl + Shift + N 新建文件夹,命名为codex-practice,回车后双击进入。若已有同名的空练习文件夹,可直接打开。 - 在这个文件夹里打开 PowerShell。再按 Alt + D,在地址栏输入
powershell并回车。在弹出的窗口执行下面一行,输出末尾应为 \codex-practice。若不是,回到练习文件夹重做本小步。PowerShell · 查看当前文件夹 Get-Location - 启动 Codex。在同一个 PowerShell 窗口运行下面这行。若出现“是否信任此文件夹”,核对是刚建的练习目录,再选信任。用方向键移动、回车确认。如果出现 Windows 沙盒设置,按界面推荐项完成本机设置。进入 Codex 后,能看到用于提问的输入区。
PowerShell · 进入 Codex codex在 Codex 输入区输入
/status并回车,核对本次会话显示的模型名和练习目录。若状态信息盖住输入框,按 Esc 返回。若停在 ChatGPT 登录页,先查登录界面排查。 - 记下时间,发一条消息。看一眼 Windows 任务栏右下角的时间,记到分钟。在 Codex 的输入区粘贴下句并按回车。等它回答,再去看后台。
Codex 对话框 · 第一次提问 请只回复:连接成功预期看到助手发出一条独立回复,例如「连接成功」。输入框上方显示的提问本身是你发出的文字。回复即使多了标点,也可以继续核对记录。
- 在站点查这次请求。切回已登录的 KeikoAI,在左侧点「使用记录」。时间范围选覆盖刚才的时间,API 密钥筛选选
codex-windows或你的实际名称。按 F5 刷新后复核筛选条件,查看靠近发送时间的新行。核对该行的密钥、请求模型和时间,记下显示的 Token 用量或费用。Token 是模型处理文字的计量单位。打开使用记录
- ① Codex 窗口
- 在提问之后出现助手的回复,会话没有以报错结束。
- ② KeikoAI 使用记录
- 同一密钥下有时间吻合的新记录,「请求」模型与本次设置一致。
本步通过以上两项同时满足,就验证了这台电脑上的 Codex 确实通过你的 KeikoAI 密钥完成了调用。
只看见其中一项?有回复却查不到对应记录。如 Codex 返回错误码,按错误码定位原因。
下次继续使用,或更换密钥
日常使用从练习文件夹开始 · 改配置时打开 CC Switch
- 结束今天的会话。等回复完成,在 Codex 输入区输入
/quit,按回车。看见 PS …> 说明已回到 PowerShell,可以关窗口。 - 下次重新开始。按 Win + E,在地址栏输入
%USERPROFILE%\codex-practice,回车。再在地址栏输入powershell并回车。在新窗口输入codex并回车即可继续使用已保存的配置。要复测时发一句“请只回复:第二次连接成功”,再按第 5 步核对新时间。 - 正常换密钥。在 KeikoAI 的「API 密钥」里创建一个同分组的新密钥,名称可填
codex-windows-2。在 CC Switch 打开「Codex → 直连 → KeikoAI → 编辑(铅笔)」,把「API Key」替换成新值,点「保存」,核对卡片仍为「使用中」。退出并重新运行 Codex。用第 5 步测试,在后台按新密钥筛选到记录后,再在网站旧密钥那一行点「禁用」。 - 如果误把密钥发给别人。立即登录 KeikoAI,进入「API 密钥」,在泄露的密钥那一行点「禁用」并确认,检查状态已停用。查看「使用记录」中有无陌生调用。然后按上一小步创建并换用新密钥,按新名称核对记录。
- 切回先前的供应商(曾配置过时)。在 CC Switch 的「Codex → 直连」找到原来的卡片,点「切换」。确认原卡片标记为「使用中」后,重新启动 Codex,在
/status核对原模型。若原先使用官方账号,按该账号自己的登录提示操作。
本步通过重开后的 Codex 仍能回答,后台有新时间的记录。以后改过密钥或模型,都能用同样的方法复查。
仍在用旧密钥?在 CC Switch 核对当前卡片,结束旧的 Codex 进程再运行 codex,按新密钥名称筛选记录。核对记录的方法
按你看到的现象排查
展开与屏幕最接近的一项。每次只改一个地方,再做该项的复测。
注册不接受邮箱,或一直收不到验证码
回到注册页检查允许的邮箱后缀和拼写,确认人机验证通过。去收件箱和垃圾邮件文件夹找 KeikoAI 的邮件。倒计时结束后可重新发送一次,用最新邮件的 6 位码。
复测 点「验证并创建账户」,再打开「仪表盘」。若页面说明当前禁止注册或地区不适用,以该提示为准。
创建密钥时没有可选分组,或“使用密钥”里没有 Codex CLI
在密钥列表确认「分组」已分配。若为空,点该行分组列选择你可用的 OpenAI 分组。若可选项为空,查看「我的订阅」的分组、有效期和额度,或向站点确认账号支持的分组。遇到只列 Claude Code 的组时,改用本站为你账号提供的 Codex 兼容组。
复测 重新打开该行「使用密钥 → Codex CLI」,应能找到 base_url、model 和 Responses 配置。
安装下载失败,或 PowerShell 提示“无法将 codex 识别为命令”
安装阶段若出现下载错误,先在 Edge 打开第 3 步的官方文档,确认网络能访问官方源,再重试一次。若安装器显示成功,请关闭整个终端,再从开始菜单打开全新的 PowerShell。运行 codex --version。
仍找不到命令时,用下面这行检查官方独立安装程序的默认位置。返回 False 表示该位置没有可执行文件,回第 3 步核对安装结果。返回 True 时,保存其他工作、注销并重新登录 Windows,让新进程重新读取用户的 PATH(系统查找命令的位置列表)。
Test-Path "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin\codex.exe"复测 重新打开 PowerShell,直到 codex --version 显示版本。受管理电脑若提示安装策略拦截,请把报错文字交给设备管理员。
CC Switch 安装包打不开,或找不到刚添加的供应商
提示“处理器类型不支持”时,在「设置 → 系统 → 关于 / 系统信息」重查 x64 或 ARM64,按第 4 步重新选包。装好后若找不到卡片,检查当前应用是不是 Codex,以及是否打开了「直连」页。点 KeikoAI 卡上的「切换」或「回到直连并使用」。
复测 卡片显示「使用中」,退出旧 Codex 再启动,新会话里的 /status 应显示预期模型。
Codex 要求登录 ChatGPT,或打开后仍显示以前的模型
退出当前 Codex。在同一个 Windows 用户账户下打开 CC Switch,检查「Codex → 直连 → KeikoAI」是否使用中,核对密钥、端点和默认模型后保存。用 Windows 原生 PowerShell 新开普通的 codex 会话。WSL 的 Linux 终端、编辑器插件或其他 Windows 账户可能读取另一份配置。
复测 从第 5 步的练习目录重新运行 Codex。仍只有登录入口时,核对是否误选了「OpenAI Official」,并从第 4 步重新选用自定义供应商。
401 Unauthorized / Invalid API Key,或 403 Forbidden
401 常见于密钥错误、停用或过期。回到正确的 KeikoAI 账号,检查密钥状态,重新用复制按钮取得完整值,替换 CC Switch 中的「API Key」。403 时,还要核对分组是否授权该模型、密钥的 IP 限制和站点的地区条件。状态码须结合站点返回的具体文字判断。
复测 保存配置、重启 Codex,发送第 5 步的短句,再按该密钥核对使用记录。
404 / 405,或出现 /v1/v1、/responses/responses
回到「使用密钥 → Codex CLI」读取 base_url,把双引号内的值原样放回 CC Switch 的请求地址框。检查是否多粘贴了 /responses、/chat/completions,或者误用了登录页 URL。确认「上游格式」选择 Responses,完整 URL 开关关闭。
复测 重启 Codex 后再发短句。若报错明确写的是 model_not_found,按下一项查模型和分组。
提示 model_not_found、不支持该模型,或“获取模型列表”失败
回到同一把密钥的「使用密钥」窗口,核对 Codex 标签和 model 值。把该组允许的模型 ID 填进 CC Switch 默认模型或模型列表第一行。「获取模型列表」会访问模型清单接口。如果只有此按钮报 404 / 405,可手动填站点配置中的 ID 后继续。若获取清单报 401 / 403,先查密钥和分组。
复测 保存并重启 Codex,核对 /status 中的模型,再真实提问。站点若只提供 Chat Completions,需要另选支持 Codex 原生 Responses 的组才能沿用本教程。
余额不足、订阅已过期,或 429 Too Many Requests
若错误文字提到余额、额度或套餐,先看仪表盘和订阅,再检查该密钥自己的额度上限和分组。若提示速率或并发限制,结束多余会话,按提示的重试时间等待。连续点击发送可能会触发更多限制。
复测 确认额度有效或等待窗口结束后,只发一次短句,在「使用记录」查对应条目。
连接超时、中途断开,或站点返回 502 / 503
在 Edge 打开 KeikoAI 首页,确认网络可用,再核对 CC Switch 的请求地址拼写。查看站点公告,如果上游服务暂时不可用,等服务恢复。需要向站点求助时,可提供时间、请求模型、错误码和请求 ID(若有),把密钥和配置中的鉴权信息遮住。
复测 先刷新站点,检查上次请求是否已有记录,再新开 Codex 发一次短句。
Codex 已经回复,但 KeikoAI 查不到对应记录
在「使用记录」确认登录邮箱正确,先放宽时间范围、选「全部密钥」,刷新后再找。核对页面显示的时区和本机时间,优先看「请求」模型。日志可能稍后才出现,一次提问也可能产生多条请求。
仍无记录时,检查 KeikoAI 卡片和直连模式都已生效,退出旧 Codex。用新会话记下新时间,发一次短句,并按专用密钥筛选。当回复和后台记录能对应上时,验收才完成。
官方入口与版本
公开资料核对日期 · 2026 年 11 月 19 日
- KeikoAI官网服务条款API 密钥与接入说明(需登录)使用记录(需登录)
- OpenAICodex CLI 安装Windows 使用说明
- CC Switch稳定版安装包4.0.35 添加供应商手册4.0.35 切换供应商手册
本手册依据 KeikoAI 对外发布的界面文字、配置示例,以及两款工具的官方文档编写。步骤中的模型名和画面用于演示。账号可用分组、余额和真实调用结果,请在自己的控制台核对。
收到 HTML 后,先保存到电脑,再双击离线阅读。打开官网、下载软件和调用模型需要联网。若双击后显示源码,右键文件,选「打开方式 → Microsoft Edge」。按 Ctrl + P 可打印,在目标打印机中选「另存为 PDF」可保存电子版。