Kimi Code CLI 自定义模型：新版配置、协议与托管登录

Kimi 名称下的产品不能混用

这里的客户端指 Kimi Code CLI，不是 Kimi 网页聊天应用，也不是把 Moonshot 模型名称当成客户端。官方新版 CLI 文档提供多服务商连接；迁移说明指出旧 kimi-cli 与新版的数据、安装体系已有变化。 本文核验官方配置主来源，未运行 CLI 或调用本站接口。

新版先找对 TOML 文件

当前官方配置路径是 ~/.kimi-code/config.toml，而旧 kimi-cli 使用 ~/.kimi/。新版可通过 KIMI_CODE_HOME 改变数据目录，文件名仍是 config.toml。 先检查所用版本与文档代际，不把两份路径同时改成不同配置。

以下仅是新版提供商表的纯占位片段，不是真实 API，也不是可直接完成联调的整份配置；本站未以这些值提供账户、Key 或充值服务。

[providers.tutorial]
type = "openai"
base_url = "https://80321.cn/v1"
api_key = "YOUR_API_KEY"

另需在 models 表登记别名，令 provider 指向 tutorial，model 填 YOUR_MODEL_ID，并按服务方确认的规格填写必需的 max_context_size。default_model 必须引用已登记别名，不能把显示名、别名和上游 ID 当作同一字段。

Chat Completions 与 Responses 明确选择

新版官方列出 openai 对应 OpenAI Chat Completions，openai_responses 对应 Responses；Anthropic、Google 等也有独立类型。 示例仅针对前者；换协议时要同时匹配服务实现，不是只改模型名。

托管 Kimi Code 服务通过 /login 管理 OAuth，登录工具负责注入和刷新凭据；它与手填第三方 Key 是两条路径。 旧配置迁移不会复制 OAuth 登录与 MCP 服务授权，需要重新完成官方认证。

先核对模型与权限，再发短任务

修改前保留不含凭据的回退信息，启动新版 CLI 后确认目标模型别名。只使用空项目和短文本任务，不先加载插件或自动执行命令。完成普通回复后，再单独验证工具调用、思考和多模态；自动识别的能力标签不是上游支持保证。

上下文大小必须来自目标模型和当前服务渠道的正式规格。把数值填大不会扩展模型能力，反而可能让长历史请求失败；不要借用托管模型的窗口给自定义模型使用。

密钥来源与配置错误分开查

新版允许 api_key 或 api_key_env，两者不能同时设置；仅在 shell 中导出一个变量而没有声明绑定，不会自动给任意提供商注入凭据。 若改用 api_key_env，明确绑定变量名并确认进程能读取它，不在命令行参数里暴露真实 Key。

启动报错先检查 TOML 表名、模型别名引用和上下文必填项，再看认证与地址。配置里的 api_key 是明文，应限制文件权限且不提交版本库。无法认证时走官方登录或服务方的合法 Key 流程，不修改托管令牌、冒用模型权限或绕过订阅限制。