使用指南
NexoX 使用指南
从安装 NexoX、添加 API 供应商到启用连接，了解配置与切换流程。阅读 Claude Code、Codex、Gemini CLI 的独立教程和常见问题。
开始之前
先确认你的系统版本与芯片架构，准备好要连接的工具和供应商信息。NexoX 管理配置，不代替 AI 工具本身。
- 在下载页选择操作系统及架构；未开放的版本会标注准备中。
- 先安装 Codex、Claude Code、Gemini CLI 等准备使用的工具。
- 准备供应商提供的 API 地址、API Key 和可用模型 ID。不要公开密钥。
添加第一个供应商
打开 NexoX，选择要配置的 AI 工具，然后添加供应商。可以选择匹配的预设，也可以创建自定义连接。
| 配置项 | 填写依据 |
|---|---|
| 名称 | 使用便于辨认的供应商名称。 |
| API 地址 | 按供应商文档填写，保留其指定路径。 |
| API Key | 使用自己的 API 密钥，并确认认证方式。 |
| 模型 | 填写供应商实际提供的模型 ID。 |
启用与切换
在供应商列表中点击启用，随后重新打开需要读取配置的终端或客户端。用一次简短请求确认模型和响应正常。
如果未生效，先检查实际启用的连接、配置目录、环境变量，以及供应商的地址、认证、模型和额度。
支持的工具
不同工具有不同配置机制。具体字段、预设与能力以当前客户端界面为准。
| 工具 | 供应商管理 | 切换后建议 |
|---|---|---|
| Codex | 切换当前连接 | 重启终端或客户端 |
| Claude Code | 切换当前连接 | 确认新会话使用新配置 |
| Gemini CLI | 切换当前连接 | 重启终端或 CLI |
| Claude Desktop | 切换当前连接 | 重启应用 |
| Grok Build | 切换当前连接 | 重启终端或 CLI |
| OpenCode / OpenClaw | 多个供应商共存 | 在对应工具中选择 |
| Hermes / Pi / MiniMax Code | 多个供应商共存 | 在对应工具中选择 |
工具配置教程
Gemini CLI API 配置与供应商切换教程在 NexoX 中选择 Gemini CLI，添加与认证方式相匹配的供应商，填写 API Key、Gemini 服务地址和模型，再启用连接。使用新的 CLI 请求验证配置；官方登录与第三方 API Key 配置应分别管理。
Codex API 配置与供应商切换教程在 NexoX 中选择 Codex，添加供应商并填写 API 地址、密钥和模型，确认上游格式后启用。原生 Responses 服务可以直连；其他上游格式需要本地路由转换。切换后重启对应 Codex 进程并发起测试请求。
Claude Code 配置与供应商切换教程在 NexoX 中选择 Claude Code，添加供应商并填写 API 地址、密钥与模型，再点击启用。原生 Anthropic Messages 供应商可以直接连接；使用其他协议时，需要匹配的本地路由转换。启用后用新的请求验证连接。
常见问题
NexoX 是 AI 聊天工具吗？
NexoX 是桌面配置与切换工具。你在这里管理供应商、API 地址和模型配置，实际对话与编码仍在 Codex、Claude Code、Gemini CLI 等工具中完成。
需要先安装 AI 工具吗？
需要。请先安装你准备使用的 AI 工具，再在 NexoX 中添加相应供应商。第三方 API 的可用模型、额度和收费由供应商提供。
切换后，需要重启客户端吗？
取决于客户端读取配置的时机。Codex、Gemini CLI 等工具建议重新启动终端或客户端；Claude Desktop 需要重启应用。完成切换后，可以用一次简单请求确认配置是否生效。
使用 NexoX 一定要开启本地路由吗？
不需要。常规使用可以让 AI 工具直接连接供应商。只有你需要协议转换等高级能力时，再按需配置本地路由。
我应该从哪里获取安装包？
请使用本网站下载页列出的 NexoX 安装包。尚未发布的架构会明确显示为“准备中”。安装前请核对系统、芯片架构和安装包来源。