从 Kimi Code 换到 ZCode：AIGoCode 模型列表、启用状态和工作区逐项迁移

原工具能回复，换工具后为什么还得重新核对

你已经在 Kimi Code 中用 AIGoCode 完成了一次对话，准备换到 ZCode 继续项目。此时最容易漏掉的，不是供应商名称，而是两款客户端建立模型列表和启用模型的步骤不同。把地址和 Key 填进新窗口，还不足以完成迁移。

本文对照 AIGoCode 的 Kimi Code 文档与 ZCode 文档，整理从旧工具核对信息、在新工具重建配置到工作区验证的清单。操作依据是官方教程，截图以 Windows 为例；这里不声称已经在每个系统实测，也不涉及迁移旧会话记录或项目权限。

先把旧工具里的四项信息记清

在 Kimi Code 的模型供应商设置里，先核对当前可用配置：API 协议、Base URL、API Key 对应分组，以及实际选择的模型 ID。官方教程使用 Anthropic 协议，Base URL 填 https://api.aigocode.dev，Key 来自支持第三方调用的 Claude Code（可外接）分组，模型示例为 claude-opus-5-5。

模型名要记实际 ID，不能只记界面上自己起的供应商名称。教程中的示例也不代表你当前分组一定可用这个模型；先在账户内确认分组包含目标模型。Key 只在客户端配置中填写，迁移记录、截图和聊天中不要写真实值。

建议准备一张不含密钥的对照表：

两页给出了相同的地址和分组要求，但这只支持本文这组配置对照，不能推导成所有客户端、所有协议或所有 Key 都能互换。地址含不含路径的通用疑问，可参看协议地址与工具根地址的区别。

到 ZCode 重建供应商，不把“获取列表”当成必要入口

打开 ZCode 设置，依次进入“模型设置 → 添加供应商 → 创建自定义供应商”。填写文档要求的 Base URL、API 格式及对应分组的 Key，并保持供应商启用。

接下来应查看“模型列表”右侧的“添加模型”。Kimi Code 教程中的流程是点击“获取模型列表”，而 ZCode 教程明确让用户填写模型 ID。迁移时若一直寻找相同的“获取列表”按钮，就容易把客户端入口差异误当成 AIGoCode 模型不可用。

填写已核对的模型 ID 后保存，确认它出现在列表中。此处有两个分别需要确认的状态：供应商已启用，模型本身也已启用。只检查其中一个，仍没有完成官方教程中的使用前核对。

智能配置里的数字要另行确认

ZCode 教程截图开启了“智能配置”，上下文窗口和最大输出 Token 由客户端填入。文档同时要求，如需调整，应以所选模型和分组实际支持范围为准。

因此，从 Kimi Code 迁移时不要把某个界面里的数字直接当作服务端承诺，也不要仅因 ZCode 自动出现了数值就认定配置已经验证。本文不提供统一的上下文或输出上限；如果你需要调整这些选项，应先核对当前模型与分组说明。

返回工作区，把“能保存”与“能使用”分开确认

供应商和模型保存后，点击“返回工作区”，新建任务并选择项目目录，再在输入框右下角选择刚添加的模型。不要停在设置页就结束检查：模型存在于配置列表，与当前任务确实选择了它，是两个需要分别完成的动作。

为了减少变量，首次验证可以沿用文档中的简单消息，例如“你好”，暂时不附带整份项目代码。收到正常回复后，到 AIGoCode 控制台核对对应的用量记录。这里描述的是迁移后的验证方法，不是本文替你执行了一次真实调用，也不保证某次回复一定成功。

如果没有出现目标模型，先回到配置检查模型 ID、供应商与模型的启用状态；如果能选择但请求失败，再核对 Key 分组、Base URL 和 API 格式。遇到 401、403、429 时，按官方错误码说明继续排查，不通过反复改模型名称猜原因。

一份可以交给同事的迁移验收单

交接时记录工具名称、实际模型 ID、协议选择、地址，以及供应商和模型启用状态即可，真实 Key 不进入交接文本。再补上工作区选中的项目目录、简单消息是否正常回复、是否核对过对应的用量记录。

这份清单要回答的是“旧工具的有效配置，在新工具中是否逐层重新建立并验证”。它不承诺自动导入历史、不判断两个客户端的全部能力相同，也不把智能配置或保存成功替代实际使用核验。先把这些层次逐一对上，再继续原来的开发任务，遇到问题时也更容易指出卡在配置、模型选择还是调用验证这一步。