常见问题
安装与鉴权
/login 时模型列表为空
如果在运行 /login 命令时看到 "No models available for the selected platform" 错误，可能是以下原因：
- API 密钥无效或过期：检查你输入的 API 密钥是否正确，以及是否仍有效。
- 网络连接问题：确认能正常访问 API 服务地址（如
api.kimi.com或api.moonshot.cn）。
注意区分平台
Kimi Code 会员权益与 Kimi 开放平台 有不同的 Base URL，配置时请注意 Base URL 与 API Key 的匹配是否正确。
| 平台 | Base URL | 计费方式 | Key 创建入口 |
|---|---|---|---|
| Kimi Code | Anthropic 兼容：https://api.kimi.com/coding/ | Kimi 会员订阅（含额度） | Kimi Code 控制台 |
| Kimi 开放平台 | https://api.moonshot.cn/v1 | 按量付费 | Kimi 开放平台官网 |
API 密钥无效
API 密钥无效可能的原因：
- 密钥输入错误：检查是否有多余的空格或遗漏的字符。
- 密钥已过期或被撤销：在平台控制台确认密钥状态。
会员过期或配额用尽
如果你使用 Kimi Code 平台，可以通过 /usage 命令查看当前的配额和会员状态。如果配额用尽或会员过期，需要在 Kimi Code 续费或升级。
订阅相关
如何开发票或升级会员
请前往 Kimi 会员权益页面，根据页面指引完成开票申请或会员升级操作。
交互问题
粘贴图片失败
使用 Ctrl-V 粘贴图片时，如果提示 "Current model does not support image input"，说明当前模型不支持图片输入。
解决方法：
- 切换到支持图片的模型：使用支持
image_in能力的模型。 - 检查剪贴板内容：确保剪贴板中确实有图片数据，而非图片文件的路径。
更新与升级
macOS 首次运行缓慢
macOS 的 Gatekeeper 安全机制会在首次运行新程序时进行检查，导致启动变慢。解决方法：
- 等待检查完成：首次运行时耐心等待，后续启动会恢复正常。
- 添加到开发者工具：在「系统设置 → 隐私与安全性 → 开发者工具」中添加你的终端应用。
如何升级 Kimi Code CLI
在 CLI 内运行 kimi upgrade，会自动检查最新版本并引导升级。也可以直接用包管理器：
npm install -g @moonshot-ai/kimi-code@latestVS Code 扩展常见问题
以下是 Kimi Code VS Code 扩展（VS Code Extension）的常见问题。
VS Code 提示未打开工作区
请在 VS Code 中打开文件夹，Kimi Code VS Code 扩展需要工作区才能正常工作。
VS Code 提示找不到 CLI
请手动安装 Kimi Code CLI 并在 VS Code 设置中配置 kimi.executablePath，或确保内置 CLI 存在。
VS Code 登录失败
请尝试跳过登录使用 API 密钥模式，检查网络连接，或稍后通过 VS Code 扩展的操作菜单重试。
VS Code 发送消息无响应
请确认 Kimi Code CLI 可用、模型已配置且 VS Code 中已打开工作区文件夹。通过 "Kimi Code: Show Logs" 查看错误日志。
VS Code 连接超时
若 30 秒内无响应将超时。请检查网络后重试。
VS Code 发消息前报错
某些错误会阻止在 VS Code 中发送消息，如 Kimi Code CLI 未找到、版本过低、未登录或会话忙碌。错误将以 toast 提示，您的输入将被保留以便重试。
反馈与联系
文档未能解决问题
如果以上内容未能解决您的问题，欢迎通过邮件联系我们：[email protected]。请在邮件中描述您遇到的问题、操作步骤及相关日志信息，我们会尽快回复。