Kimi 怎么安装：网页、App、桌面端与 API 对照

截至 2026 年 11 月抓取时，Kimi 官方快速开始页已切换到 Kimi K3.1 Pro，并同时提供网页、桌面端、移动端和 API 接入路线。现在值得先分清路线，是因为“安装 Kimi”可能指安装客户端，也可能只是把 Kimi 模型接入自己的程序；前者下载安装即可，后者则需要 API Key、运行环境和 SDK。

先选对安装方式

Kimi 没有一种适用于所有设备的安装办法。要直接聊天，优先使用网页版或手机 App；需要让 Kimi 操作本地文件、运行网页任务，选桌面端；要在脚本、后端或 AI 应用中调用模型，才需要 API 和 SDK。

这里最容易踩的坑，是看到“Kimi Code”或“API”后，直接寻找一个类似普通聊天软件的安装包。实际上，客户端与模型 API 是两层东西：前者提供操作界面，后者提供可由程序调用的模型接口。

网页与移动端：下载后怎么确认

只想马上使用 Kimi，直接打开 Kimi 官网 即可，无需安装软件。登录账号后如果页面出现对话框，并且能发送消息，就说明网页端已经可用；随后打开开发者工作台时调用的是 API 账户中的 Key，不能混用。

需要安装移动端时，访问官方的 Kimi 下载页，进入“移动端”区域，再按设备系统前往对应应用商店。iPhone 在 App Store 搜索 Kimi，Android 和 HarmonyOS 用户使用手机自带或系统指定的应用商店。官方说明支持 iOS、Android 和 HarmonyOS 移动端 App。

安装完成后打开应用并登录，首页应能看到输入框；发送一条简单消息后，界面出现正常回复，就表示安装和账号登录都已完成。移动端不需要额外配置模型。需要注意，通知、麦克风等权限可以按需授予；不授予麦克风权限，不影响普通文字对话，但会限制语音功能。

桌面端：先确认系统再下载

需要 Kimi 读取和处理电脑中的文件，或者让它执行网页任务，应安装桌面端 Kimi Work。官方 下载页面提供 Windows 与 macOS 下载入口。

1. 在下载页选择“桌面端”，系统会自动显示与当前设备匹配的安装包；下载后在文件管理器中双击安装程序。
2. 安装完成后启动 Kimi Work，使用 Kimi 账号登录。
3. 如果任务涉及本地文件，在桌面端授权并挂载目标文件夹；不需要本地文件时，可以先不授权。

官方列出的 Kimi Work 桌面端支持 Windows，以及搭载 Apple silicon 的 Mac；Intel Mac 的桌面应用只支持 Kimi Chat。因此，下载页没有提供与当前电脑匹配的完整 Kimi Work 安装包时，不要从网盘或第三方下载站寻找替代文件。Intel Mac 用户可改用网页版或 Kimi Chat。

成功的可观察标志是：应用正常启动并进入聊天界面，Chat 模式的历史记录能够显示，授权后的本地文件夹可以出现在工作目录设置中。官方还说明，Chat 记录可在网页端、桌面端 Kimi Work 和移动端之间同步，但 Work 模式的任务和记录会保留在创建任务的电脑上。

API 接入：按开发环境执行命令

K3.1 Pro 的访问条件（官方快速开始页原文）：它是旗舰模型，在开放平台完成充值（最低充值金额 10 元）后即可解锁调用；新用户注册认证赠送的 15 元代金券不可用于 Kimi K3.1 Pro；累计充值金额同时决定账户等级与速率限制（并发、RPM、TPM、TPD）。所以”注册完就能调旗舰”是误解——先充值 10 元，且别指望赠送券抵扣。

如果目标是在 Python 或 Node.js 项目中调用 Kimi，先登录 Kimi API 开放平台，进入控制台的 API Keys 页面创建并复制密钥。不要把密钥直接写进代码，官方快速开始建议通过环境变量 MOONSHOT_API_KEY 保存。

运行前准备以下环境：

1. 安装 Python 3.9 及以上版本，运行 python --version 确认；或者安装 Node.js 18 及以上版本，运行 node -v 确认。
2. 在项目目录安装 OpenAI SDK，Python 与 Node.js 二选一，不要重复安装两套。
3. 复制 API Key 后设置 MOONSHOT_API_KEY，再运行请求示例。

官方给出的 SDK 安装命令如下：

pip install --upgrade 'openai>=1.0'

npm install openai@latest

Python 项目可使用官方快速开始中的调用方式：客户端读取 MOONSHOT_API_KEY，base_url 设为 https://api.moonshot.cn/v1，模型使用 kimi-k3.1-pro。如果不需要 SDK，也可以直接发送 HTTP 请求：

curl https://api.moonshot.cn/v1/chat/completions 
-H "Content-Type: application/json" 
-H "Authorization: Bearer $MOONSHOT_API_KEY" 
-d '{
"model":"kimi-k3.1-pro",
"messages":[
{"role":"system","content":"你是一个乐于助人的 AI 助手。"},
{"role":"user","content":"你好"}
]
}'

这里选择 Chat Completions API，是因为它兼容 OpenAI SDK，示例最容易复现。项目使用 Anthropic SDK 或需要 Responses API 时，应改用官方文档列出的对应格式，不要只替换 model 字段就假定全部接口兼容。

常见卡点：按现象逐项排查

网页能打开，但 API 请求没有鉴权信息。重新进入开放平台的 API Keys 页面，确认 Key 已创建，并检查当前终端是否已经设置 MOONSHOT_API_KEY。在终端执行 printenv MOONSHOT_API_KEY 能输出对应值，才算环境变量对当前进程生效。

代码返回了内容，但与示例回答不同。这通常不表示安装失败。官方明确说明，大模型回复具有不确定性，因此成功标准应是收到正常的模型回复，而不是逐字得到“你好，李雷！1+1 等于 2”。

桌面端看不到 Kimi Work。先检查电脑是否为 Windows 或搭载 Apple silicon 的 Mac。Intel Mac 的桌面应用只支持 Kimi Chat；若任务必须操作当前电脑中的文件，则应在支持 Kimi Work 的系统上使用，或改用网页版。

项目能运行，但接错了接口。OpenAI SDK 项目应使用官方示例中的 base_url 和模型名称；如果项目实际按 Anthropic Messages API 编写，则改用官方的 Messages API 文档，不要混用请求体字段。

成功标志与后续入口

安装成功的判断不只看“程序启动了”，还要看可观察结果：网页版能返回回复；移动端能登录并发送消息；桌面端能挂载目标文件夹；API 示例能在终端返回模型的 content。

模型选择、计费和上下文档位以 Kimi API 快速开始为准；完整页面目录可查 Kimi API 文档索引。如果需要按接口类型继续配置，再进入 API 参考；需要了解当前模型能力，则查看 Kimi K3.1 Pro 说明。

参考来源

• Kimi AI Download for Windows, Mac, Android & iOS