After login / setup notes
登入之后,这样配置。
先在 codexpert 创建 API 密钥,再按客户端选择:
CC Switch 、Codex++ 、WorkBuddy 、ZCode 、DeepSeek Harness 、Qoder ,
或在 ChatGPT 客户端里接入 Grok / DeepSeek / Kimi / GLM,也可以通过 CC Switch 配置 Claude 桌面端 ,或在 Codex 中使用 Claude 模型 。
配置流程图
前三步共用。创建密钥后,按你实际使用的客户端选择路径。
01 / START
登录官网
打开 codexpert.top,进入账号。
02 / KEYS
API 密钥
左侧账户菜单进入“API 密钥”。
03 / CREATE
创建密钥
命名并选择分组后创建。
04 / FORK
选择客户端
按客户端选择后续路径。
Visual walkthrough
按截图,一步一步完成
每一步都配了对应截图和实际操作说明。点击截图可以放大查看红框位置。
01
打开官网并登录
登录入口
进入 codexpert.top 首页,在页面中间的按钮区域点击“登录”。
如果你已经在登录状态,通常会直接进入管理页面。
图 1 · 登录入口 点击图片放大
这一页要做什么
打开 codexpert.top/home 。
点击页面中间的“登录”按钮。
完成账号验证后进入后台。
打开登录页 ↗
○ 标记已完成
02
进入“API 密钥”页面
账户菜单
登录后,在左侧“我的账户”区域找到 API 密钥 。页面顶部会显示
API 端点、图片请求地址和 WorkBuddy 等常用入口。
图 2 · API 密钥管理 点击图片放大
找到创建入口
确认左侧菜单已选中 API 密钥 。
查看右上角的黑色 “创建密钥” 按钮。
如果列表没有刷新,先点击旁边的刷新按钮。
https://codexpert.top/keys
复制
○ 标记已完成
03
创建密钥并选择分组
关键配置
点击“创建密钥”后,先填写一个容易识别的名称,再打开“分组”下拉框。
选择与你要使用的模型对应的分组,截图中展示了 GPT、测试模型、gpt6 智商、探针、OpenAI raykey 等选项。
图 3 · 创建密钥 / 选择分组 点击图片放大
填写方式建议
名称可以写成 主密钥 或客户端名称,方便以后识别。
点击“选择分组”,按需要选择模型组。
“密钥有效期”如果不需要自动过期,可以保持关闭。
确认后点击右下角 “创建” 。
○ 标记已完成
04
创建完成后,选择一条路径
在这里分叉
密钥列表的操作区可以走两条路:点击 “导入到 CCS” 进入 CC Switch,
或先复制密钥,再打开对应客户端手动添加。下面九个入口可以直接跳到对应配置。
图 4 · 密钥列表操作区 点击图片放大
先看清操作区
使用密钥 :查看或复制该密钥,走 Codex++、WorkBuddy、ZCode、DeepSeek Harness、Qoder、ChatGPT 客户端或 Claude 桌面端时会用到。
导入到 CCS :把配置发送到 CC Switch。
后面的“禁用、编辑、删除”先不要操作。
○ 标记已完成
路径 A · 导入 CC Switch
从密钥行的“导入到 CCS”开始,确认供应商配置,再把状态切到“使用中”。
CC Switch
A1
在密钥列表导入到 CCS
连接客户端
在刚刚创建的那一行找到操作区,点击 “导入到 CCS” 。不要点击“禁用”或“删除”。
图 A1 · 导入到 CCS 点击图片放大
这一步点哪里
确认当前行是刚创建的密钥。
点击操作区里的 导入到 CCS 。
等待 CC Switch 弹出供应商配置窗口。
如果没有看到按钮,先确认 CC Switch 是否已安装,并刷新密钥列表。
○ 标记已完成
还没有 CC Switch?先下载安装
官方渠道:访问 ccswitch.io 了解软件,下载安装包请进入官方 GitHub Releases。
A2
确认供应商配置并切换使用
完成导入
点击导入后,CC Switch 会弹出供应商配置确认窗口。核对应用类型、供应商名称、
API 端点、模型和用量查询状态,确认无误后点击右下角蓝色 “导入” 。
图 A2 · 确认导入配置 点击图片放大
导入前检查
应用类型应为 Codex 。
供应商名称应为 codexpert 。
API 端点为 https://codexpert.top 。
确认信息后点击 导入 。
○ 标记已完成
A3
在 CC Switch 中确认“使用中”
验收状态
导入完成后,在 CC Switch 的供应商列表中找到 codexpert 。
该卡片出现“使用中”状态,并显示余额或剩余额度,说明配置已经生效。
图 A3 · 配置完成 点击图片放大
完成标准
列表中能看到 codexpert 。
卡片状态显示 使用中 。
余额查询正常,没有显示“查询失败”。
之后即可在 CC Switch 中使用对应模型。
○ 标记已完成
A4
重启 ChatGPT 客户端
最后一步
CC Switch 显示“使用中”后,完全退出当前的 ChatGPT / Codex 客户端,
再重新打开客户端,让刚导入的供应商配置加载生效。
图 A4 · 重启客户端 点击图片放大
这样操作就可以了
先完全退出 ChatGPT / Codex 客户端。
重新打开客户端,等待首页加载完成。
新配置加载后,就可以使用 codexpert 的模型了。
如果重启后仍未生效,请确认 CC Switch 中的 codexpert 仍显示“使用中”,再重新启动一次客户端。
○ 标记已完成
路径 B · 添加到 Codex++
不走“导入到 CCS”。复制密钥后,在 Codex++ 管理工具里手动添加供应商,保存后再启动。
Codex++
还没有 Codex++?先下载安装
官方渠道:访问 codexpp.cc 了解软件,下载安装包请进入官方 GitHub Releases。
B1
在 Codex++ 填写供应商配置
手动添加
打开 Codex++ 管理工具 ,左侧进入 供应商配置 。
按截图填写名称、接入模式、模型、Base URL 和 Key,确认上游协议后保存。
图 B1 · 供应商配置 点击图片放大
按红箭头填写
左侧点击 供应商配置 。
名称填写 codexpert 。
接入模式选择 纯 API 。
配置模型填写你要使用的模型名,截图示例为 gpt-5.6-sol 。
Base URL 填写 https://codexpert.top 。
Key 粘贴刚才在密钥列表复制的 API 密钥。
上游协议选择 Responses API ,然后点击 保存此模型 。
https://codexpert.top
复制
“启用目标功能”保持关闭即可。Key 只粘贴到 Codex++,不要发到聊天或截图公开。
○ 标记已完成
B2
回到概览并启动 Codex++
生效
供应商保存后,回到左侧 概览 。健康检查正常时,点击
“启动 Codex++” ,让刚保存的供应商配置加载生效。
图 B2 · 启动 Codex++ 点击图片放大
启动前看一眼
左侧回到 概览 。
确认 Codex 版本、应用和入口都显示正常。
点击蓝色按钮 启动 Codex++ 。
如果启动后没有走新配置,回到供应商配置确认已点击“保存此模型”,再重新启动一次。
○ 标记已完成
B3
重启 ChatGPT 客户端
最后一步
Codex++ 启动完成后,完全退出当前的 ChatGPT / Codex 客户端,
再重新打开客户端,让刚保存的供应商配置加载生效。
图 B3 · 重启客户端 点击图片放大
这样操作就可以了
先完全退出 ChatGPT / Codex 客户端。
重新打开客户端,等待首页加载完成。
新配置加载后,就可以使用 codexpert 的模型了。
如果重启后仍未生效,请回到 Codex++ 概览再点一次“启动 Codex++”,然后重新打开客户端。
○ 标记已完成
路径 C · 接入 WorkBuddy
复制密钥后,在 WorkBuddy 的模型设置里用自定义接口添加模型。
WorkBuddy
C1
编辑模型并填写接口
自定义 API
打开 WorkBuddy,进入 模型 设置,点击添加或编辑模型。
提供商选自定义,接口地址填 completions,再粘贴 API Key 和模型名称。
图 C1 · 编辑模型 点击图片放大
按红箭头填写
提供商选择 自定义 / Custom 。
接口地址填写 https://codexpert.top/v1/chat/completions 。
API Key 粘贴刚才复制的密钥。
模型名称填写你要使用的模型,截图示例为 gpt-5.6-sol 。
高级配置勾选 自定义协议 ,需要时再打开工具调用、图片输入、推理模式。
确认后点击右下角 保存 。
https://codexpert.top/v1/chat/completions
复制
○ 标记已完成
路径 D · 接入 ZCode
在 ZCode 的模型设置里添加自定义供应商,填写 Base URL、API 格式、Key 和模型后启用。
ZCode
D1
在模型设置里添加供应商
自定义供应商
打开 ZCode,左侧进入 模型设置 。添加自定义供应商后,
填写 Base URL、API 格式、API Key 和模型列表,确认状态为已启用。
图 D1 · 模型设置 点击图片放大
按红箭头填写
左侧点击 模型设置 ,再添加自定义供应商。
Base URL 填写 https://codexpert.top 。
API 格式选择 Responses (/responses) 。
API Key 粘贴刚才复制的密钥。
模型列表添加你要使用的模型,截图示例为 gpt-5.5 。
确认右上角状态为 已启用 。
https://codexpert.top
复制
○ 标记已完成
路径 F · 接入 DeepSeek Harness
在设置的模型页里改 DeepSeek 的 API 地址,密钥和模型确认后保存。
DeepSeek Harness
F1
在模型设置里改 API 地址
Anthropic Messages
打开 DeepSeek Harness,进入 设置 → 模型 。展开 DeepSeek 的自定义设置,
API 地址改成 codexpert,再确认模型和密钥。
图 F1 · 模型设置 点击图片放大
按红框填写
右上角打开 设置 ,左侧点 模型 。
找到 DeepSeek ,展开 自定义设置 。
API 地址填写 https://codexpert.top 。这里要兼容 Anthropic Messages 协议。
API 密钥粘贴刚才复制的密钥。显示“已配置”时,不改就继续用原来的。
模型目录里要有 deepseek-v4.1-flash ,没有就点“添加模型”。
点右下角 保存 。回到对话后,底部模型选 deepseek-v4.1-flash 。
https://codexpert.top
复制
这是 DeepSeek Harness 自己的设置,和路径 E 里在 ChatGPT 客户端接入 DeepSeek 不是同一处。
○ 标记已完成
路径 G · 接入 Qoder
先在模型里用 OpenAI Compatible 接上 codexpert。GPT 和 Grok 选 Responses API。需要更快时,再在网络里配本地代理。
Qoder
G1
添加模型:协议、地址、密钥、模型名
Responses API
打开 Qoder 的模型设置,添加或编辑模型。供应商选 OpenAI Compatible 。
用 GPT 或 Grok 时,API 类型选 Responses API ,不要选成别的协议。
图 G1 · 编辑模型 点击图片放大
按红框填写
供应商选择 OpenAI Compatible 。
用 GPT 或 Grok 时,API 类型选择 Responses API 。
接口地址(Base URL)填写 https://codexpert.top ,不要再加 /v1 或完整接口路径。
API Key 粘贴刚才复制的密钥。编辑已有模型时:地址和协议都没改,留空会沿用当前 Key;改了地址或协议后再留空,会按空 Key 去校验。
Model ID 填实际要请求的模型名。截图示例是 grok-4.7 ,GPT 就换成对应的 GPT 模型名。
确认后点右下角 下一步 ,按页面继续直到保存。
https://codexpert.top
复制
供应商、API 类型和 Model ID 添加后不能改。要换模型或换协议,重新添加一个模型,不要在原条目上硬改。
○ 标记已完成
G2
可选:配上本地网络代理
请求更快
模型能通但请求偏慢时,到 Qoder 的网络设置里走本地代理。
只影响本机应用和本地 Agent,远程 SSH 不受影响。
图 G2 · 网络代理 点击图片放大
按红箭头设置
打开 Qoder 设置,左侧滚到最下面 其他 ,点 网络 。
在 网络代理 里,代理方式选 手动配置 。
代理地址填本机梯子的 HTTP 或 HTTPS 地址,必须带端口。截图示例是 http://127.0.0.1:7897 ,端口按你自己的客户端改。
可先点 测试连接 ,通了再点 保存 。
保存后完全退出并重新打开 Qoder 。页面写的是重启后才生效,不重启还是启动时那份配置。
http://127.0.0.1:7897
复制
这一步不是必须的。没开代理也能用;开了本地代理,请求通常会快一些。端口不对就连不上,以你梯子软件里显示的端口为准。
○ 标记已完成
路径 E · ChatGPT 客户端用 Grok / DeepSeek / Kimi / GLM
以 Grok 为例。DeepSeek、Kimi、GLM 的填法完全同理,只换模型名。
ChatGPT
这几个全部同理: API 请求地址都填 https://codexpert.top ,上游格式都选 Responses(原生)。
默认模型和映射行换成对应名称即可,比如 grok-4.6 、deepseek-chat 、kimi-k2 、glm-4.6 。
E1
填写 API Key、请求地址和默认模型
以 Grok 为例
打开 ChatGPT / Codex 客户端的供应商编辑页,填好 API Key、请求地址和默认模型。
截图用的是 Grok,其他模型只改这一行名称。
图 E1 · 基础配置(Grok 示例) 点击图片放大
先填这三项
API Key 粘贴刚才复制的密钥。
API 请求地址填写 https://codexpert.top ,不要打开“完整 URL”。
默认模型填写 grok-4.6 。DeepSeek / Kimi / GLM 换成对应模型名。
上游格式保持 Responses(原生) 。
https://codexpert.top
复制
○ 标记已完成
E2
补上模型映射
菜单显示
继续往下找到 模型映射 。菜单显示名和实际请求模型填同一套名称,
这样客户端里才能选到这些第三方模型。
图 E2 · 模型映射(Grok 示例) 点击图片放大
映射这样填
Grok 示例:grok-4.5 → grok-4.5 ,grok-4.6 → grok-4.6 。
DeepSeek / Kimi / GLM 同理,左右两列都填对应模型名。
保存后重启 ChatGPT / Codex 客户端,模型列表才会刷新。
改映射后必须重启客户端,/model 命令才能看到这些第三方模型名。
○ 标记已完成
路径 H · 配置 Claude 桌面端
在 CC Switch 中配置 Claude Desktop,保存后重启 Claude 客户端即可。
Claude Desktop
H1
填写配置,保存后重启 Claude 客户端
CC Switch → Claude Desktop
打开 CC Switch,选择左侧的 Claude Desktop ,进入供应商配置页。
按截图填写 API Key 和请求地址,点击 保存 ,然后重启 Claude 客户端就可以了。
图 H1 · Claude 桌面端配置 点击图片放大
按顺序完成这几步
在 CC Switch 左侧选择 Claude Desktop ,打开供应商配置。
API Key 粘贴刚才在 codexpert 复制的密钥。
请求地址 填写 https://codexpert.top ,末尾不要加斜杠。
点击右下角 保存 。
完全退出 Claude 客户端,再重新打开 ,即可使用。
https://codexpert.top
复制
○ 标记已完成
路径 I · 在 Codex 中配置 Claude 模型
在 CC Switch 的 Codex 供应商配置中添加 Claude 模型,保存后完全退出并重启 Codex。
Codex · Claude
I1
添加 Claude 模型,配置完成后重启 Codex
CC Switch → Codex
打开 CC Switch,左侧选择 Codex ,编辑 codexpert 供应商。
在模型列表中添加 Claude,再展开高级选项设置上游格式和认证字段。下图以 claude-opus-5-5 为例。
图 I1 · Codex 配置 Claude 模型 点击图片放大
按截图填写
在 CC Switch 左侧选择 Codex ,打开 codexpert 的供应商编辑页,API Key 使用在 codexpert 复制的密钥,请求地址填写 https://codexpert.top 。
在 模型列表 中点击 手动添加 ,菜单显示名和实际请求模型都填写 claude-opus-5-5 。
按截图填写上下文窗口 1000000 ,思考等级选择 low → max 。子代理模型留空则跟随主模型。
展开 高级选项 ,上游格式选择 Anthropic Messages(需转换) 。
认证字段选择 ANTHROPIC_API_KEY(x-api-key) ;“模拟 Claude Code 客户端”按截图保持关闭。
使用此上游格式时,先切换到 路由或聚合模式 ,再点击右下角 保存 。
完全退出 Codex,再重新打开 ,让模型列表和配置生效,然后选择刚添加的 Claude 模型。
注意截图中的直连提示: Anthropic Messages 需要转换,保持直连会导致请求失败,请先切到路由或聚合模式。保存后还需要重启 Codex。
claude-opus-5-5
复制
○ 标记已完成
还是不会?上终极办法。
教程看到这里还是卡住,别跟配置死磕了。终极办法很简单:去找站长,把你卡在哪一步说一声就行。