01 / 切换
需要切换时，
点一下就好。
为每个 AI 工具保存供应商配置，在不同连接之间快速切换。
了解配置切换产品能力
管理好连接，
专注手头的工作。
在同一个工作台查看不同工具的供应商配置，切换时不用反复编辑配置文件。
需要切换时，
02 / 本地
你的配置，
在你自己的电脑上。
常规连接使用工具自身的配置。本地路由可按需开启。
探索与学习
从连接工具，到拓展可能。
关注 AI 与 Agent 的新进展，也找到让工具更好用的方法。
Agent 与工具专题
使用帮助
教程与问题解答
从配置第一个工具，到解决使用中的问题。
跟着教程，完成连接
选择你使用的工具，从这里开始。
Codex API 配置与供应商切换教程
在 OneBox 中选择 Codex，添加供应商并填写 API 地址、密钥和模型，确认上游格式后启用。原生 Responses 服务可以直连；其他上游格式需要本地路由转换。切换后重启对应 Codex 进程并发起测试请求。
Gemini CLI API 配置与供应商切换教程
在 OneBox 中选择 Gemini CLI，添加与认证方式相匹配的供应商，填写 API Key、Gemini 服务地址和模型，再启用连接。使用新的 CLI 请求验证配置；官方登录与第三方 API Key 配置应分别管理。
Claude Code 配置与供应商切换教程
在 OneBox 中选择 Claude Code，添加供应商并填写 API 地址、密钥与模型，再点击启用。原生 Anthropic Messages 供应商可以直接连接；使用其他协议时，需要匹配的本地路由转换。启用后用新的请求验证连接。
遇到问题，找到答案
从具体问题进入，查看原因与排查方法。
AI 工具请求超时或返回 429，如何逐项排查？
Gemini CLI 的 API Key 与登录认证冲突如何排查？
Claude Code 配置第三方 API 后出现 404 或协议错误
Claude Code 返回 401 或 403，应该检查什么？
Codex 切换供应商后为什么仍然使用旧配置？
Codex 能直接使用 Chat Completions 接口吗？
OneBox 是 AI 聊天工具吗？
OneBox 是桌面配置与切换工具。你在这里管理供应商、API 地址和模型配置，实际对话与编码仍在 Codex、Claude Code、Gemini CLI 等工具中完成。
需要先安装 AI 工具吗？
需要。请先安装你准备使用的 AI 工具，再在 OneBox 中添加相应供应商。第三方 API 的可用模型、额度和收费由供应商提供。
切换后，需要重启客户端吗？
取决于客户端读取配置的时机。Codex、Gemini CLI 等工具建议重新启动终端或客户端；Claude Desktop 需要重启应用。完成切换后，可以用一次简单请求确认配置是否生效。
使用 OneBox 一定要开启本地路由吗？
不需要。常规使用可以让 AI 工具直接连接供应商。只有你需要协议转换等高级能力时，再按需配置本地路由。
下载 OneBox
让下一次灵感，
即刻开始。
把配置交给 OneBox，把时间留给真正重要的事。