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(国际站地址):
[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"凭据的优先级
api_key或api_key_env(二选一,不能同时写)- 前两者都没有时,读取
[providers.<名字>.env]子表里的变量 - 都没有则启动报错
推荐用 api_key_env 指向环境变量,避免把 Key 明文写进配置文件。
切换模型
配置好之后,在会话里切换到已声明的模型即可(输入 /help 查看当前版本的切换命令)。