Kimi Code 常见问题
本页适用于 Kimi Code CLI。
找不到 kimi 命令
关闭并重新打开终端，再执行：
kimi --version
如果仍然找不到命令，请重新执行官方安装命令，并检查安装脚本最后输出的安装目录和 PATH 提示。
Windows 提示找不到 Git Bash
请先阅读 CLI 环境配置教程 中的 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
请按下面步骤检查：
- 在模型广场确认模型名称，注意大小写、连字符和版本号必须完全一致。
- 确认模型支持
KIMI-自部署分组，并使用该分组创建的令牌。 - 检查
config.toml中的default_model、[models.*]区块名称和model是否指向同一个模型。
返回 403：令牌限制了可用模型
如果返回 403 Forbidden，通常是创建令牌时填写的 模型可用列表 不包含 Kimi Code 当前请求的模型。
建议在令牌管理中将 模型可用列表 留空；如果需要限制模型，请填写与模型广场显示完全一致的模型名称，然后重新使用该令牌。
返回 503：服务暂时不可用
如果返回 503 或 get_channel_failed，表示当前模型暂时没有可用通道，请稍后重试。
其他接口错误
保留完整报错，并在 APINebula 调用日志中核对模型名称、令牌分组和额度。
能正常对话但不能修改文件
检查客户端是否显示了工具调用确认，以及当前目录是否允许写入。如果中转站日志中的流式响应缺少完整的 tool_calls，请保留对应请求记录并联系客服。
