Kimi CLI 使用说明

Posted on Apr 2, 2026

这份文档基于 Moonshot AI 官方 Kimi Code CLI 文档整理。

它是什么

  • Kimi Code CLI 是运行在终端中的 AI agent。
  • 它可以读写代码、执行 shell、搜索网页、抓取 URL，并自主规划执行步骤。
  • 除了终端交互，还支持 kimi web 和 kimi acp。

官方安装与升级

官方安装脚本

curl -LsSf <https://code.kimi.com/install.sh> | bash

Windows PowerShell：

Invoke-RestMethod <https://code.kimi.com/install.ps1> | Invoke-Expression

已有 uv 时

uv tool install --python 3.13 kimi-cli

官方建议：

  • 支持 Python 3.12 到 3.14
  • 推荐 Python 3.13

升级 / 卸载

uv tool upgrade kimi-cli --no-cache
uv tool uninstall kimi-cli

启动方式

交互模式

kimi

Browser UI

kimi web

Agent integration

kimi acp

首次使用

进入项目目录后启动：

cd your-project
kimi

首次运行建议先执行：

/login

官方文档说明：

  • 选择 Kimi Code 时，会走浏览器 OAuth
  • 其他平台通常走 API key
  • 配置完成后会自动写入 ~/.kimi/config.toml

如果项目里没有 AGENTS.md，官方建议可以直接：

/init

配置与 Provider

配置文件

主要配置文件：

~/.kimi/config.toml

/login 支持的平台

官方文档当前写明：

  • Kimi Code
  • Moonshot AI Open Platform (moonshot.cn)
  • Moonshot AI Open Platform (moonshot.ai)

支持的 provider type

  • kimi
  • openai_legacy
  • openai_responses
  • anthropic
  • gemini
  • vertexai

示例

Kimi

[providers.kimi-for-coding]
type = "kimi"
base_url = "<https://api.kimi.com/coding/v1>"
api_key = "sk-xxx"

OpenAI Responses

[providers.openai-responses]
type = "openai_responses"
base_url = "<https://api.openai.com/v1>"
api_key = "sk-xxx"

Anthropic

[providers.anthropic]
type = "anthropic"
base_url = "<https://api.anthropic.com>"
api_key = "sk-ant-xxx"

Model capabilities

官方文档里，模型 capability 会影响功能是否可用：

  • thinking
  • always_thinking
  • image_in
  • video_in

例如：

[models.gemini-3-pro-preview]
provider = "gemini"
model = "gemini-3-pro-preview"
max_context_size = 262144
capabilities = ["thinking", "image_in"]

thinking mode

支持 thinking 的模型：

  • 可以在 /model 里切
  • 启动时也可以用 -thinking / -no-thinking

image / video input

  • image_in：可粘贴图片
  • video_in：可发送视频内容

Search / Fetch 服务

官方文档强调：

  • SearchWeb
  • FetchURL

依赖外部服务，目前只有 Kimi Code 平台提供完整服务。

具体行为：

  • moonshot_search 对应 SearchWeb
  • moonshot_fetch 对应 FetchURL

如果不是 Kimi Code 平台：

  • SearchWeb 可能不可用
  • FetchURL 会回退到本地抓取

常用 slash commands

帮助与信息

  • /help
  • /version
  • /changelog
  • /feedback

账号与配置

  • /login / /setup
  • /logout
  • /model
  • /editor
  • /reload
  • /debug
  • /usage / /status
  • /mcp

会话管理