OminiApi 文档

Kimi Code

配置 Moonshot Kimi Code CLI 通过 OminiApi 使用 kimi-k3 等模型

OminiApi TeamCLI 配置约 11 分钟

Kimi Code 是 Moonshot AI 推出的终端编码助手。这里只讲通过 OminiApi 使用模型的安装、配置和验证;MCP、Skills、Plugins 等扩展请看官方文档:MCP、Agent Skills、Plugins。

不要泄露 API Key

不要在截图、聊天记录、公开仓库或工单里展示真实 Key,也不要把包含 Key 的 config.toml 提交到 Git 仓库。

安装 Kimi Code

确认 Node.js 版本在 22.19.0 以上:

node --version

全局安装:

npm install -g @moonshot-ai/kimi-code@latest

检查安装结果:

kimi --version

其它安装方式见 Kimi Code 官方入门文档。

准备 Key 和模型

  • 在控制台 API 密钥 页面创建 Key,确认它的分组包含你要用的模型;
  • 在 模型广场 的模型详情页查看该模型支持哪些接口;
  • 从下面三种协议里选一种配置,不要把三个示例同时写进配置文件。
模型推荐协议
kimi-k3三种都可以,推荐 Chat Completions
deepseek-v4-pro、deepseek-v4.1-flash、deepseek-flash三种都可以
glm-5.3、glm-5.3-flash、glm-5.2、glm-5.1Chat Completions
claude-sonnet-5-5 等 Claude 系列只能用 Anthropic Messages

打开配置文件

首次运行 kimi 后会自动创建配置目录,没有的话手动新建。

按 Win + R,输入下面的路径后回车,打开或新建其中的 config.toml:

%USERPROFILE%\.kimi-code

配置 OminiApi

复制所选协议的配置后,把 你的 API Key 换成自己的 Key。max_context_size 是必填项,示例用 200000,模型广场标注了其它上下文长度的话按实际修改。

请求路径 /v1/chat/completions,兼容性最好。

~/.kimi-code/config.toml
default_model = "omini_chat"

[providers.omini_chat]
type = "openai"
base_url = "https://omini.ominiapi.top/v1"
api_key = "你的 API Key"

[models.omini_chat]
provider = "omini_chat"
model = "kimi-k3"
max_context_size = 200000

base_url 填到 /v1 即可,不要再拼 /chat/completions。

验证

运行 kimi,发一句话,能正常回复就说明配置成功。

常见问题

启动或请求失败时,优先检查:

  • default_model 和 [models.<名称>] 的名称是否完全一致;
  • [models.<名称>].provider 和 [providers.<名称>] 的名称是否完全一致;
  • 模型是否在密钥的分组里、是否支持所选协议。不支持时会返回 No eligible upstream supports the requested interface or model,换一种协议或换模型;
  • OpenAI Chat / Responses 的地址是否以 /v1 结尾;
  • Anthropic 的地址是否没有手动加 /v1。

更多错误见 错误码。

官方配置参考

Kimi Code 更新较快,完整配置和高级用法以官方文档为准:供应商与模型、配置文件、环境变量、配置覆盖。

本页目录