~/.kimi/config.toml 中定义多个 Provider 和模型,因此可以把 AIMax 的 OpenAI Chat Completions 或 Responses 入口配置成一个独立 Provider。
支持状态:基础配置可用,尚未完成 AIMax 端到端 Agent 验证。本文使用配置文件中的 Provider/Model 抽象,不把某个版本作为唯一支持范围。
安装
按 Kimi Code CLI 官方文档 安装:uv 时安装:
准备工作
- 在 AIMax 平台 创建文本 API Key。
- 在平台记录该 Key 当前可见的完整模型名称。
- 根据目标模型选择 Responses 或 Chat Completions Provider。
配置文件
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://api.aimaxa.cn/v1,不要再追加 /chat/completions 或 /responses;协议客户端会拼接正式路径。
Kimi 原生 Provider 与 AIMax Provider 混淆
type = "kimi" 是 Kimi API Provider;连接 AIMax 时请使用 openai_responses 或 openai_legacy,并把 AIMax 模型 ID 写在 [models.*].model。