Kimi Code CLI 是 MoonshotAI 的终端开发工具。它支持在 ~/.kimi/config.toml 中定义多个 Provider 和模型,因此可以把 AIMax 的 OpenAI Chat Completions 或 Responses 入口配置成一个独立 Provider。
支持状态:基础配置可用,尚未完成 AIMax 端到端 Agent 验证。本文使用配置文件中的 Provider/Model 抽象,不把某个版本作为唯一支持范围。

安装

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

准备工作

  1. AIMax 平台 创建文本 API Key。
  2. 在平台记录该 Key 当前可见的完整模型名称。
  3. 根据目标模型选择 Responses 或 Chat Completions Provider。

配置文件

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://api.aimaxa.cn/v1,不要再追加 /chat/completions/responses;协议客户端会拼接正式路径。

Kimi 原生 Provider 与 AIMax Provider 混淆

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

协议参考