跳到正文
funcoding.ai
← Kimi Code CLI

Kimi Code CLI · 自定义模型

Kimi Code CLI 配置自定义模型:providers 与 models

在 ~/.kimi/config.toml 里声明模型服务和模型,同时接入 Kimi、Claude、DeepSeek、通义、Gemini 等,并用 /provider 交互式管理。

1 分钟读完

Kimi Code CLI 的全局配置文件是 ~/.kimi/config.toml(也支持 JSON 格式)。配置分两层:

  • provider:一个模型服务,对应一种接口协议和一组凭据
  • model:建立在 provider 之上的具体模型,带有名称、上下文长度等信息

最简单的方式:/provider

在会话里输入 /provider,会打开服务管理界面,可以交互式地添加、删除服务。不进入界面时,也可以在 Shell 里用 kimi provider 子命令管理。

支持的协议类型

type 协议 适用
kimi OpenAI 兼容 Moonshot 的 Kimi 服务
anthropic Anthropic Messages Claude 模型
openai OpenAI Chat Completions OpenAI、DeepSeek、通义千问等兼容服务
openai_responses OpenAI Responses API OpenAI 新接口
google-genai Google GenAI Gemini API
vertexai Vertex AI Google Cloud

配置示例

Kimi(国际站地址):

~/.kimi/config.toml
[providers.kimi]
type = "kimi"
base_url = "https://api.moonshot.ai/v1"
api_key = "sk-xxxxx"

国内开放平台的地址是 https://api.moonshot.cn/v1。

Anthropic,并声明一个模型:

[providers.anthropic]
type = "anthropic"
api_key = "sk-ant-xxxxx"
[models."claude-opus-4-7"]
provider = "anthropic"
model = "claude-opus-4-7"
max_context_size = 200000

任意 OpenAI 兼容服务(以 DeepSeek 为例):

[providers.deepseek]
type = "openai"
base_url = "https://api.deepseek.com/v1"
api_key_env = "DEEPSEEK_API_KEY"

凭据的优先级

  1. api_key 或 api_key_env(二选一,不能同时写)
  2. 前两者都没有时,读取 [providers.<名字>.env] 子表里的变量
  3. 都没有则启动报错

推荐用 api_key_env 指向环境变量,避免把 Key 明文写进配置文件。

切换模型

配置好之后,在会话里切换到已声明的模型即可(输入 /help 查看当前版本的切换命令)。