一个为所有人的API使用指南
返回官网 ↗
使用指南工具接入教程

Kimi Code

Kimi Code 是工具名称;接入第三方 API 后,用哪个模型由你的配置决定,不是只能用 Kimi 模型。下面以当前 Kimi Code CLI 为准。

开始前,把三样信息放在手边

已经装好工具即可继续。打开官网「自助服务」,登录后创建或查看自己的 API 密钥,并复制页面提供的 API 地址;从「模型与价格」复制完整模型 ID。别把官网首页、登录密码或模型的宣传名称填进去。确认账户和密钥都有可用额度。

下面的 API_HOST、YOUR_API_KEY、YOUR_MODEL_ID 都是占位文字,使用前逐个换成你的实际信息。地址里 /v1 是否保留,要看本篇要求;不要追加 /chat/completions 或 /responses。示例不会自动连接,也不会自动带入你的密钥。

1. 确认版本与配置位置

在终端运行 kimi --version 查看版本。当前官方配置在 ~/.kimi-code/config.toml;Windows 为 %USERPROFILE%\.kimi-code\config.toml。较早版本可能使用 ~/.kimi,路径不一致时先查看你安装版本的官方说明,不要同时修改两份文件。

2. 添加提供方和模型

把示例合并进配置。provider = "my_api" 必须对应 [providers.my_api];my-model 是本机别名,model 才是平台的真实模型 ID。max_context_size 示例为 32768,不代表模型实际上限,需按所选模型的已确认能力调整。

字段示意 · 非软件截图
type
openai / openai_responses
base_url
https://API_HOST/v1
model
YOUR_MODEL_ID
api_key_env
MY_API_KEY
配置示例

修改配置前先保留原文件。已有同名项目时修改对应值,不要再重复添加一份;保留其他设置。配置中若有真实密钥,不要分享文件或截图。

default_model = "my-model"

[providers.my_api]
type = "openai"
base_url = "https://API_HOST/v1"
api_key_env = "MY_API_KEY"

[models.my-model]
provider = "my_api"
model = "YOUR_MODEL_ID"
max_context_size = 32768

3. 设置密钥并选中模型

api_key_env = "MY_API_KEY" 表示从指定环境变量取密钥;它不会凭名字自动找到你的平台账户。按下方写法设置后运行 kimi,再输入 /model 选择 my-model。/login 是官方账户登录流程,不会自动配置本平台密钥。

如果配置使用 MY_API_KEY,需要在启动工具的同一个终端中设置它。下面先展示写法,密钥要在你自己的电脑上填写;之后从该终端启动工具。关闭终端后需要重新设置。

macOS / Linux 终端
export MY_API_KEY="YOUR_API_KEY"
kimi
Windows PowerShell
$env:MY_API_KEY = "YOUR_API_KEY"
kimi

4. 选对接口格式

本例 type = "openai" 对应 Chat Completions;若要用 Responses,只有确认该模型的对应路由可用后,才改成 "openai_responses"。两者 Base URL 都按平台提供的信息保留 /v1。

5. 开启并调整思考档位

能识别的模型通常自动匹配能力;自定义别名未识别时,在 [models.my-model] 中按真实能力添加 capabilities = ["tool_use", "thinking"],以及 support_efforts 和 default_effort。先确认支持哪些值再填;例如仅在支持 low/high 时填 support_efforts = ["low", "high"]、default_effort = "low"。这只是声明能力,不会让不支持的模型获得思考功能。

若已确认当前模型支持 low,可在同一配置文件中加入下面独立的 [thinking] 段来选择该档位;以后把 effort 改为已声明的其他值。已有全局 effort 会覆盖模型的 default_effort。保存后在空闲会话输入 /reload,再发送测试消息。

[thinking]
enabled = true
effort = "low"

验证一:收到第一条回复

新建一个空的测试文件夹,在工具中选择它作为工作区,再新开一个会话。确认当前选中的是刚添加的提供方和模型,发送下面这句话。收到正常回复且没有错误,才说明基本连接成功;它不能证明所有工具都已接通。测试会产生正常的 API 用量。

请只回复:连接成功。

预期:工具显示模型回复「连接成功」。若是登录页、报错或一直转圈,先查看下方排查表,不要反复发送。

验证二:让它实际读取一个文件

在刚才的测试文件夹里,用文本编辑器新建 hello.txt,内容写「API connection test 27」。保存后发送下面的要求;出现读取权限提示时,只允许访问这个测试文件夹。

请使用文件读取工具打开当前工作区的 hello.txt,告诉我文件内容,不要修改任何文件。

预期:能看到读取 hello.txt 的工具执行记录,回答包含 API connection test 27。只有一段口头回复、没有读取记录,不算工具调用验证成功。确认结束后,可以自行删除这个测试文件夹。

遇到问题,先按现象检查

401 / Invalid API key

确认地址和密钥来自同一个平台,密钥完整、未过期或被禁用。不要把完整密钥发给客服。

404 / model not found

先核对地址是否多写或少写 /v1,再核对模型 ID 和协议;模型列表可见也不代表所有协议都能使用。

429 / quota / balance

查看账户余额、密钥额度和请求频率,按错误提示处理;提高思考强度不能解决额度问题。

能聊天,不能读文件

确认模型支持工具调用、软件给了工作区读取权限,且工具执行过程没有报错。

没有思考强度选项

先检查模型能力声明,再检查当前模型与客户端版本是否支持可调档位。模型支持思考,不一定支持多个强度。

官方说明与适用范围

配置说明核对于 2026-11-08。工具更新后菜单可能变化,以下官方资料可用于核对;教程中的 API 信息始终以本平台当前提供的内容为准。