跳到主要内容

Kimi Code 常见问题

本页适用于 Kimi Code CLI。

先按报错判断​

报错优先处理
model_not_found / 当前服务暂不支持该模型检查模型名称和分组
403 Forbidden检查令牌的「模型可用列表」
找不到 kimi 命令重开终端 / 重装
配置文件报错kimi doctor config

找不到 kimi 命令​

关闭并重新打开终端，再执行：

kimi --version

仍然找不到命令，就重新执行官方安装命令，并检查安装脚本最后输出的安装目录和 PATH 提示。

Windows 提示找不到 Git Bash​

先看 Node.js 环境准备 里的 Git Bash 安装步骤，然后重新打开终端。

如果 Git 安装在自定义目录，把环境变量 KIMI_SHELL_PATH 设为实际 bash.exe 的完整路径。

配置文件报错​

kimi doctor config

按输出中的字段或行号修改 config.toml，并确认：

  • default_model 对应的模型区块存在
  • provider 与供应商区块名称一致

返回 400：max_completion_tokens 超过上限​

如果报错提示 max_completion_tokens 必须小于或等于 131072，确认模型配置用：

max_context_size = 1048576
max_output_size = 131072
危险

不要把 max_output_size 设成 1048576。

返回模型不存在或不支持​

当前服务暂不支持该模型
model_not_found
  1. 在 模型广场 确认模型名称 —— 大小写、连字符、版本号必须完全一致
  2. 确认模型支持的分组，用该分组创建的令牌
  3. 检查 config.toml 中 default_model、[models.*] 区块名称、model 三者是否指向同一个模型

返回 403：令牌限制了可用模型​

在 令牌管理 把「模型可用列表」留空；需要限制时，填写与模型广场显示完全一致的模型名，然后重新使用该令牌。

返回 503：服务暂时不可用​

503 或 get_channel_failed 表示当前模型暂时没有可用通道，稍后重试。

其他接口错误​

保留完整报错，并在控制台调用日志中核对模型名称、令牌分组和额度。

能正常对话但不能修改文件​

检查客户端是否显示了工具调用确认，以及当前目录是否允许写入。

如果中转站日志中的流式响应缺少完整的 tool_calls，请保留对应请求记录并联系客服。

相关：Kimi Code 配置 · 常见问题总览