TokenMeld Codex 配置教程
按照这个流程完成账号登录、CCSwitch 配置、API Key 导入和 Codex 验证。导入成功后不需要手动编写复杂配置，启用 TokenMeld 渠道即可开始使用。
准备账号和安装包
先登录 TokenMeld，再下载 CCSwitch 和 Codex。
本教程展开 Windows 和 macOS。Linux 用户可以沿用同一套 API 端点，但 CCSwitch 的界面和安装方式请以项目文档为准。
安装并完全退出 Codex
先启动一次 Codex，再从系统托盘完全退出，让后续配置能够重新加载。
安装并打开 Codex
完成安装后打开一次 Codex，确认程序可以正常启动。此时不需要登录或发送请求。
从托盘退出
Windows 在系统托盘右键 Codex 图标，选择“退出”或“完全退出”；macOS 使用菜单栏中的退出选项。
确认进程已关闭
确认没有 Codex 后台进程残留。不要只关闭窗口，否则 CCSwitch 写入的配置可能不会被读取。
打开 CCSwitch，只保留 Codex
减少配置目标，避免把其他客户端的设置误写到 Codex。
打开 CCSwitch 设置
启动 CCSwitch，进入设置或管理工具列表。
只点选 Codex
在客户端选择中取消其他工具，只保留 Codex。不同版本的名称可能显示为 Codex App 或 Codex。
保存设置
保存后回到主界面。此时先不要启动 Codex，下一步要从 TokenMeld 导入 API Key。
进入 TokenMeld，创建 API Key
API Key 是使用站内模型的凭证，只会在创建后完整显示一次。
打开 API Keys 页面
登录 tokenmeld.com，进入「API Keys」页面。
创建一个专用 Key
名称可以填写 codex-desktop，按管理员要求设置过期时间、分组或额度。
立即保存完整 Key
复制到密码管理器。不要把 Key 发到群里、写进截图、提交到 Git 或放进网页前端代码。
如果管理员没有额外要求，名称以外的高级选项可以保持默认。遇到分组、模型白名单或额度字段时，按管理员给你的范围选择。
导入到 CCSwitch
从 API Key 页面使用导入功能，CCSwitch 会自动写入 TokenMeld 渠道配置。
点击“导入到 CCSwitch”
创建 API Key 后，在 Key 的操作菜单中点击“导入到 CCSwitch”。如果浏览器询问是否打开 CCSwitch，请允许。
确认 CCSwitch 出现 TokenMeld
回到 CCSwitch 主界面，检查渠道列表中是否出现 TokenMeld，并确认 API 地址是 https://api.tokenmeld.com。
核对 Key 的后四位
如果 CCSwitch 显示 Key 摘要，核对后四位是否与刚创建的 Key 一致。不要在聊天或截图中展示完整 Key。
OpenAI-compatible base URL: https://api.tokenmeld.com/v1
API host for Claude/Codex integrations: https://api.tokenmeld.comOpenAI 兼容客户端通常需要 /v1；CCSwitch 自动导入时以它显示的地址为准，不要重复添加路径。
启用 TokenMeld 渠道
导入完成后开启渠道，再重新打开 Codex。
点击启用
在 CCSwitch 渠道列表中找到 TokenMeld，点击启用或设为当前渠道。
保持默认路由
初次配置不需要额外开启路由，也不需要手动填写模型映射。TokenMeld 会按管理员开放的分组和模型处理请求。
重新打开 Codex
确认 CCSwitch 保存成功后，再启动 Codex。配置未生效时，先重新退出 Codex 和 CCSwitch 后再试一次。
如果 Codex 或 CCSwitch 需要选择模型，使用 TokenMeld 站内模型列表中显示的名称；不要凭记忆填写，也不要在客户端重复计算倍率。
打开 Codex，发送 test 验证
用一条短消息检查配置、鉴权、路由和余额扣减。
没有立即提示端点或 Key 错误。
说明 TokenMeld 渠道已被调用。
回到站内用量页核对本次请求。
Codex 的操作审批建议先选择“替我审批”或等价的人工确认模式。熟悉流程后再按自己的风险偏好调整。
遇到问题，联系管理员
请提供错误类型和时间，不要直接发送密钥或完整提示词。
联系时附上
- 操作系统和 CCSwitch 版本。
- Codex 是否已经完全退出后重开。
- 错误状态码、发生时间和请求 ID（如果有）。
不要附上
- 完整 API Key、账号密码或登录令牌。
- 包含隐私的完整提示词或项目文件。
- 第三方站点的私有链接和浏览器地址栏截图。
常见问题
大多数配置问题都可以按下面顺序排查。
导入按钮没有打开 CCSwitch
确认 CCSwitch 已安装并已启动一次；浏览器弹出“打开外部应用”时选择允许。也可以复制 Key 后在 CCSwitch 中手动新建 TokenMeld 渠道。
Codex 仍然使用旧配置
完全退出 Codex 和 CCSwitch，确认后台进程结束后再启动 CCSwitch，最后重新打开 Codex。
401 或 API key invalid
检查 Key 是否完整、是否已被撤销、是否粘贴了多余空格。出现泄露风险时先撤销旧 Key，再创建新 Key。
模型不可用或没有可用渠道
进入 TokenMeld 模型页确认当前分组是否开放该模型。分组和倍率由站点统一管理，客户端不要自行修改。
请求超时或 429
降低并发和重试频率，先用短消息验证。持续出现时记录时间和状态码，联系管理员核对上游账号和额度。