使用 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:
YOUR_API_KEY 提交到代码仓库。可以通过独立配置文件、环境变量管理工具或本地密钥管理器注入。
多模型切换
在同一个配置文件中为不同模型定义不同名称:kimi 后,可以用 /model 在已配置的模型之间切换。模型的真实能力以当前 API Key、Provider 协议和 AIMax 返回结果为准;capabilities 只是告诉 CLI 是否展示相应能力入口,不能替代真实验证。
最小验证
在项目目录执行:openai_legacy Provider 再验证;反过来也一样。确认纯文本后,再分别验证文件修改、Shell、MCP 和 Agent 回合。
常见问题
模型列表没有出现在 /model
检查 default_model 是否引用了 [models.<name>] 中存在的名称,以及 provider 是否与 [providers.<name>] 完全一致。
返回 404 或路径错误
OpenAI Provider 的base_url 填 https://your-domain/v1,不要再追加 /chat/completions 或 /responses;协议客户端会拼接正式路径。
Kimi 原生 Provider 与 AIMax Provider 混淆
type = "kimi" 是 Kimi API Provider;连接 AIMax 时请使用 openai_responses 或 openai_legacy,并把 AIMax 模型 ID 写在 [models.*].model。