使用 AIMax 配置 Kimi Code CLI

Kimi Code CLI 是 MoonshotAI 的终端开发工具。它支持在 ~/.kimi/config.toml 中定义多个 Provider 和模型,因此可以把 AIMax 的 OpenAI Chat Completions 或 Responses 入口配置成一个独立 Provider。
Kimi CLI 项目正在演进为 Kimi Code CLI。本文使用配置文件中的 Provider/Model 抽象,不把某个安装版本或某个模型版本作为唯一支持范围。

安装

Kimi Code CLI 官方文档 安装:
也可以在已有 uv 时安装:
确认安装:

先发现模型

data[].id 中选取一个模型,下面以环境变量表示:

配置文件

Kimi Code CLI 默认读取 ~/.kimi/config.toml。下面配置 AIMax 的 Responses Provider:
如果目标模型只提供 Chat Completions,则改用:
不要把 YOUR_API_KEY 提交到代码仓库。可以通过独立配置文件、环境变量管理工具或本地密钥管理器注入。

多模型切换

在同一个配置文件中为不同模型定义不同名称:
运行 kimi 后,可以用 /model 在已配置的模型之间切换。模型的真实能力以当前 API Key、Provider 协议和 AIMax 返回结果为准;capabilities 只是告诉 CLI 是否展示相应能力入口,不能替代真实验证。

最小验证

在项目目录执行:
先输入一个不需要工具的任务:
如果 Responses 入口返回协议错误,换成 openai_legacy Provider 再验证;反过来也一样。确认纯文本后,再分别验证文件修改、Shell、MCP 和 Agent 回合。

常见问题

模型列表没有出现在 /model

检查 default_model 是否引用了 [models.<name>] 中存在的名称,以及 provider 是否与 [providers.<name>] 完全一致。

返回 404 或路径错误

OpenAI Provider 的 base_urlhttps://your-domain/v1,不要再追加 /chat/completions/responses;协议客户端会拼接正式路径。

Kimi 原生 Provider 与 AIMax Provider 混淆

type = "kimi" 是 Kimi API Provider;连接 AIMax 时请使用 openai_responsesopenai_legacy,并把 AIMax 模型 ID 写在 [models.*].model

协议参考