ZCode 配置

ZCode 是一款 AI 编程工具，可以通过兼容的 API 协议连接第三方模型服务。本文以 Flatrouter 为例，介绍如何在 ZCode 中完成供应商和模型配置。界面名称可能随版本调整，如遇差异，可参考 ZCode 中文官方配置文档。

前提条件

• 已注册 Flatrouter 账号并获取 API Key
• 已准备好需要使用的模型，并能在 Flatrouter 模型广场 查看其完整模型 ID
• 已打开 ZCode 并进入可以管理供应商的设置页面

配置步骤

第 1 步：打开 ZCode 设置

有两种常见入口：

• 在模型选择器底部点击 管理模型，进入供应商管理页面。
• 如果是首次使用，在欢迎页点击 使用 API Key，进入 API 配置页面。

如果当前页面没有这些入口，可先打开模型选择器，再查找底部的模型管理入口；也可以参考 ZCode 中文官方配置文档 确认当前版本的入口位置。

第 2 步：添加 Flatrouter 供应商

在供应商列表底部点击 添加供应商，将供应商名称填写为 flatrouter，再按你要使用的协议填写端点和 API Key。

如果 ZCode 要求选择供应商协议，请让协议类型与 Base URL 对应：使用 OpenAI 兼容协议时选择 OpenAI 兼容端点，使用 Anthropic 协议时选择 Anthropic 端点，不要交叉填写。

第 3 步：添加并启用模型

1. 打开 Flatrouter 模型广场，找到要使用的模型。
2. 复制模型的完整模型 ID，如 gpt-5.6-sol、gpt-5.6-terra。不要手动缩写、改写或补充前缀。
3. 返回 ZCode 的 flatrouter 供应商设置，点击添加模型。
4. 将复制的完整模型 ID 粘贴到模型 ID 字段，并保存。
5. 确认 flatrouter 供应商已启用；如果 ZCode 支持单独启用模型，也要打开该模型的启用开关。

第 4 步：验证配置

返回模型选择器，选择已添加并启用的模型，发送一段简单文本，例如「你好，请回复已连接」。如果能收到正常回复，说明供应商、API Key、端点和模型 ID 基本配置正确。

推荐模型

推荐模型请参考 Flatrouter 模型广场。选择时可结合任务类型、上下文需求、工具调用能力、响应速度、价格和当前可用性进行比较；不要仅根据模型显示名称做判断，以模型广场展示的完整模型 ID 和实时可用状态为准。

常见问题

Q: 找不到设置入口

先打开模型选择器，查看底部的 管理模型；首次使用则从欢迎页的 使用 API Key 进入。如果界面名称不同，参考 ZCode 中文官方配置文档 查找对应入口。

Q: 已添加供应商，但模型选择器中不显示

确认供应商名称是 flatrouter，并检查供应商或模型是否处于启用状态。保存后重新打开模型选择器，确认当前筛选范围没有隐藏该供应商。

Q: 模型显示出来，但无法选择或发送

检查模型是否单独启用，并确认粘贴的是从 Flatrouter 模型广场 复制的完整模型 ID。不要使用手动缩写、别名或自行拼接的 ID。

Q: 提示 API Key 无效或认证失败

重新复制并填写你的 Flatrouter API Key，检查是否包含多余空格或换行。确认使用的是当前有效的 Flatrouter API Key，并避免把其他服务的 Key 填入 ZCode。

Q: 请求端点错误或协议不匹配

OpenAI 兼容协议使用 https://api.flatrouter.com/v1，Anthropic 协议使用 https://api.flatrouter.com/anthropic。检查协议选择、Base URL 和 API Key 是否属于同一配置，不要混用两种端点。

Q: 模型 ID 正确，但请求仍失败

回到 Flatrouter 模型广场，确认该模型当前对账号可用，并检查模型是否暂时不可用或受到额度、权限等限制。必要时换用模型广场中当前可用的其他模型重新验证。

Q: 一直没有响应或连接超时

检查网络连接、防火墙、代理和 DNS 设置，确认当前网络可以访问 Flatrouter API。若网络正常仍无法连接，稍后重试，并留意服务状态或当前网络环境是否限制了相关请求。