Kimi CLI 配置经验总结|windows系统

概述

记录 Kimi CLI 的安装和 API 配置过程，包括遇到的问题和解决方案。

安装步骤

1. 安装 Kimi CLI

irm https://code.kimi.com/install.ps1 | iex

安装过程说明：

• 脚本会自动安装 uv（Python 包管理工具）
• 使用 uv 安装 kimi-cli 及其依赖
• 安装路径：~/.local/bin/

注意： 安装后需要将 ~/.local/bin 添加到 PATH 环境变量

2. 配置文件位置

~/.kimi/config.toml

配置详解

完整配置示例

default_model = "kimi-for-coding"

[models.kimi-for-coding]
provider = "kimi"
model = "kimi-for-coding"
max_context_size = 262144

[providers.kimi]
type = "kimi"
api_key = "your-api-key-here"
base_url = "https://api.kimi.com/coding/v1"

关键配置点

配置项	说明	注意事项
type	Provider 类型	必须使用 "kimi"，不是 "openai_legacy"
base_url	API 基础地址	必须包含 /v1，否则会返回 404
model	模型名称	需要通过 /v1/models 接口查询可用模型
max_context_size	最大上下文大小	与 API 返回的 context_length 保持一致

常见问题与解决方案

1. 401 Invalid Authentication

原因： API Key 无效或过期

解决：

• 检查 API Key 是否正确
• 确认账户有充足余额
• 验证 API Key 是否有权访问对应服务

2. 404 Resource Not Found

原因： base_url 缺少 /v1 路径

错误示例：

base_url = "https://api.kimi.com/coding"  # ❌ 错误

正确配置：

base_url = "https://api.kimi.com/coding/v1"  # ✅ 正确

3. 403 Access Terminated

原因： 模型访问权限限制

错误信息示例：

Kimi For Coding is currently only available for Coding Agents
such as Kimi CLI, Claude Code, Roo Code, Kilo Code, etc.

解决： 确保使用正确的 type = "kimi" 配置

4. 配置验证错误

症状： Invalid configuration file 错误

常见缺失字段：

• providers.<name>.type - Provider 类型必须指定
• models.<name>.max_context_size - 模型配置需要最大上下文大小

调试技巧

1. 查询可用模型

curl https://api.kimi.com/coding/v1/models \
  -H "Authorization: Bearer your-api-key"

返回示例：

{
  "data": [{
    "id": "kimi-for-coding",
    "context_length": 262144,
    "supports_reasoning": true,
    "supports_image_in": true,
    "supports_video_in": true
  }]
}

2. 测试 API 连通性

curl https://api.kimi.com/coding/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-for-coding",
    "messages": [{"role": "user", "content": "你好"}]
  }'

3. 查看日志

日志位置：~/.kimi/logs/kimi.log

tail -100 ~/.kimi/logs/kimi.log

使用示例

交互模式

kimi

直接执行命令

kimi --print --prompt "你的问题"

指定工作目录

kimi -w /path/to/project

使用特定模型

kimi --model kimi-for-coding --prompt "你好"

经验总结

1. base_url 必须包含版本路径 - 这是最常见的 404 错误原因
2. 使用正确的 provider type - "kimi" 和 "openai_legacy" 有不同的认证机制
3. 查询可用模型 - 不要假设模型名称，通过 API 查询确认
4. 完整配置模型参数 - max_context_size 等字段是必需的
5. 利用日志调试 - 详细的错误信息在日志文件中

参考链接

• 官方文档：https://moonshotai.github.io/kimi-cli/
• 配置文件说明：https://moonshotai.github.io/kimi-cli/zh/configuration/config-files.html

---

记录时间：2025-04-09