# Kimi 3 完全使用指南，这次真憋了个大的
**作者**: Ando
**日期**: 2026-07-17T10:15:31.000Z
**来源**: [https://x.com/AndoRAG/status/2078061024746586311](https://x.com/AndoRAG/status/2078061024746586311)
---
事情是这样的。
前两天，我刷到一个关于 Kimi K3 的视频。
标题非常猛，开源模型，代码能力直逼顶级闭源模型，首发实测，还能免费领会员。
我看到的第一反应居然不是兴奋。
而是，Kimi？？？
不是哥们，真的已经很久没听到它的消息了。这个曾经靠 20 万字上下文一战成名的产品，过去很长一段时间，存在感低得像是被整个 AI 圈按了静音键。
结果它不吭不响，一回来就是一个 2.8 万亿参数的 K3。
有点意思。
所以我鬼使神差地，把 K3 的官方发布说明、网页 Agent、Kimi Work、Kimi Code 和 API 文档，全都翻了一遍。
翻完以后，我脑子里一直有一个很强烈的感觉。
K3 最值得看的，可能根本不是 2.8 万亿，也不是 1M 上下文。
而是 Kimi 终于不满足于回答问题了。
它开始想替你，把一件事做完。
先把边界说清楚，下面这篇不是四个入口的完整亲测。我没有把没有做过的事，硬写成「我跑了一遍，太震撼了」。
我做的事很简单，读完截至 2026 年 7 月 17 日能看到的官方资料，再把视频里的演示逻辑拆开，设计成一套你今天就能跟着做的测试。
能确认的，我会直接告诉你。
不能确认的，也不装。
说真的，这反而是我看完这一轮 K3 信息以后，觉得最需要先讲的东西。
因为现在网上关于 K3 最容易让人误会的，刚好就三个词。
开源，1M，免费。
先说开源。
官方把 K3 称为全球首个开源的 3 万亿级模型，这个定位没问题。它的总参数是 2.8 万亿，原生支持视觉理解，模型最高上下文窗口是 100 万 token。
但截至 7 月 17 日，完整权重还没有全部放出来。
官方给的时间是，最迟 7 月 27 日。
所以更准确的说法，是 K3 已经宣布开源，并给出了完整权重的发布时间。不是完整权重已经安安静静躺在仓库里，等所有人随便下载。
而且参考视频里说的是 2.5T，官方发布说明写的是 2.8T。
差了 3000 亿参数。。。
你看，这就是为什么我一直觉得，视频可以看情绪和案例，数字还是得回到原文。
再说 1M。
这个误会可能更大。
K3 的模型上限确实是 1M，但这不代表你随便打开一个 Kimi 页面，就能得到 1M。
网页 Agent 现在还是 128K。Kimi Code 的 Moderato 档是 256K。Allegretto 及以上，才解锁最高 1M。你要把它接进第三方 Coding Agent，通常还得手动把最大上下文设成 1048576。
模型上限有点像一台车在实验室里跑出来的最高时速。
你最后开多快，还得看你拿到的是哪台车，走的是什么路。
所以屏幕前的你，别看到海报上写了 1M，就默认自己账号里也有。最笨但最靠谱的办法，就是打开产品页，看你当前入口和会员档位到底写了多少。
最后是免费。
参考视频的标题里有「免费领会员」，但视频正文没有把适用用户、会员档位、活动期限、领取入口和后续是否续费讲清楚。
那我就没法负责任地告诉你，K3 免费了。
免费权益这种东西，变得比北京的天气还快。真正领取以前，只认自己账号页当天显示的规则。免费的是哪一档，能用多久，要不要新用户，后面会不会续费，有一项没写清，就别脑补成永久免费。
开源是真的，1M 也是真的，免费活动可能也是真的。
但它们都带条件。
把这三个坑绕过去，我们再聊 K3 到底该怎么用。
我很喜欢参考视频里的一个演示。
它让 K3 用一句提示词，生成一个可以直接打开的 HTML 文件，里面是一架黑鹰直升机。从启动发动机，到起飞、悬停、切换视角，再到落回停机坪，整个过程都在网页里运行。
真正有意思的，不只是画面。
视频作者没有生成完就开始喊牛逼，而是一个动作一个动作地验。
能不能起飞。
视角能不能切。
最后能不能降落。
中间有没有报错。
这几下，把「代码能力很强」变成了能当场判断的东西。
我突然觉得，测试 Agent 就该这么测。
不要跟它聊半小时，看它说话像不像人。给它一件真实的事，写清交付物，然后盯着结果验。
于是我给这篇指南设计了一项跟做任务。
用 8 个官方链接和 3 份本地 PDF，完成一份「新能源汽车价格战」专题。最后要交一张事实表、一篇微信公众号长文，再做一个能在浏览器打开的数据可视化网页。
我自己没有替你跑完这项任务，所以也不会在这里放一个假的结果截图。
但这项任务很适合把 K3 的四个入口，完整走一遍。
01
网页 Agent，普通人的第一站。
入口是 Kimi 网页 Agent。手机和平板，也可以在 Kimi App 的工具栏里切到 Agent 模式。
第一轮不要急着写文章，只给它 8 个官方链接，然后发这段。
> 调研 2025 年至今国内新能源汽车价格战。只使用我提供的 8 个官方链接，优先采用车企公告、财报和监管数据。先交付一张事实表，字段包含日期、主体、动作、价格变化、来源链接和可信度，再给出公众号文章大纲。材料冲突时单独放进「待核验」，这一轮不要写正文。
发完以后，不要光看它最后那段中文顺不顺。
看它到底访问了什么网站。
看事实表里的数字，能不能点回原始链接。
看两份材料打架的时候，它是老老实实写「待核验」，还是偷偷给你编了一个特别丝滑的结论。
这才是 Agent 的考试。
网页 Agent 单次任务一般需要 5 到 20 分钟，Agent 集群会更久。页面停一会儿很正常，先别手欠点「停止输出」，它可能还在后台干活。
这块还有两个限制。
一个就是刚才说的 128K。网页正文、工具返回和中间文件，都会吃上下文。材料一多，最好拆成事实整理、分析、成稿三轮，别一股脑全塞进去。
另一个是，它通常一次输出一个文件。你要同时交 Word、PPT 和 Excel，或者要做大规模并行搜索，再去看 Agent Swarm。开放没开放、还有多少额度，以你账号里当天显示的为准。
我的判断很简单。
你第一次用 K3，就从网页 Agent 开始。
但别把它当成 1M。
02
Kimi Work，把任务从云端拖回自己的电脑。
如果那 3 份 PDF 在本地，还要读文件、整理目录、保存结果，网页 Agent 就开始有点别扭了。
这时候用 Kimi Work。
它支持 Windows 和 Apple 芯片的 Mac。按照 K3 发布时的说明，要用 Kimi Work 3.1.0 或更高版本。
它可以挂载你授权的文件夹，读取和整理文件，运行 Python 或 Shell，还能配合 Kimi WebBridge 操作 Chrome 和 Edge。
听起来很爽对吧。
也正因为这样，第一次用的时候，我建议你千万别把整个硬盘直接交出去。
新建一个测试目录，只放那 3 份 PDF，然后发这段。
> 只读取我授权的「新能源汽车专题」目录。不要移动、改名、删除或覆盖原文件。提取 3 份 PDF 里的公司、报告期、车型、价格、销量和管理层表述，生成 local-facts.md。每条数据附文件名和页码，无法确认的内容标成「待核验」。完成后列出读取过的文件，不执行其他操作。
完成以后，随手抽 3 条数据，回到原 PDF 看文件名、页码和数字。
别嫌麻烦。
AI 最可怕的错误，不是它告诉你「我不会」，而是它很自信地把一个错误数字，写得像真的一样。
说到 WebBridge，这块也得多说一句。
官方说明里写的是，浏览器桥接和操作在本机完成，登录态不会离开设备。这很好。
但登录凭证留在本机，不等于任务读到的所有内容都不会进入模型上下文。
财务、客户、内部系统，这些东西还是按敏感数据来处理。发帖、下单、提交表单、删内容、发消息，最后一下点击，留给自己。
Kimi Work 还能做定时任务。真要用，记得把运行时间、输入来源、保存位置和失败以后怎么办写清楚。夜里跑的话，还要在设置里打开「保持电脑唤醒」。
所以 Kimi Work 最重要的，不是比网页多了几个按钮。
而是它开始碰你的真实文件和真实登录态了。
到了这里，权限边界，比模型参数重要。
03
Kimi Code，真正看它能不能把工程任务收尾。
视频里那架直升机确实很抓眼球。
但如果你真准备把 K3 用在工作里，我觉得最值得测的，不是它能不能一口气喷出几千行代码。
而是它能不能读懂现有项目，做对修改，自己跑测试，发现问题，再把坑填上。
Kimi Code 是终端里的 Coding Agent。
官方安装命令放在这里。
macOS 和 Linux
```
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```
Windows PowerShell
```
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```
远程脚本会直接执行，介意的话，先打开脚本链接看一眼。Windows 还需要 Git for Windows。走 npm 安装的话，Node.js 要 22.19.0 或更高。
装完运行 kimi --version，再进项目目录执行 kimi。第一次启动输入 /login，然后用 /model 切到 K3。
最好开一段新会话再切。
官方专门提醒过，中途从其他模型切到 K3，或者客户端没有完整回传历史思考内容，输出可能会很不稳定。
回到刚才那个任务。
把前两步核验过的事实表导成 verified-facts.csv，放进一个空项目。不要让它直接开写，先用 /plan。
> 只读检查当前目录和 verified-facts.csv，给出一个单页数据可视化网站的实现方案，不修改文件。页面要有时间线、品牌筛选、价格变化图和来源抽屉，必须适配手机。列出文件结构、验证方式和需要我确认的设计选择。
方案确认以后，再用 /goal。
```
/goal 根据已确认方案完成网页。所有图表只能使用 verified-facts.csv。实现品牌筛选、来源查看和移动端布局。运行测试和构建，修复发现的问题。完成标准是构建通过、控制台无报错、关键交互可用，并列出改动文件和验证结果。
```
然后，像检查那架直升机一样检查它。
品牌筛选，数据变不变。
图表数字，能不能回到 CSV。
来源抽屉，能不能打开。
手机宽度，文字会不会挤成一团。
测试和构建，到底是真跑了，还是只留下一句「理论上可以」。
这里就会看出一个 Coding Agent 到底是会写代码，还是会做工程。
Kimi Code 默认会在写文件和执行命令前弹审批。/yolo 能跳过很多确认，但第一次用，真别开着它碰业务项目。
不是说 /yolo 不好。
是一个刚认识 10 分钟的同事，突然跟你说「哥，管理员权限给我，我保证不乱动」，你敢给吗。。。
档位也别忘了看。Andante 暂不支持 K3，Moderato 可以用，但上下文是 256K。Allegretto 及以上，才是最高 1M。
我的判断也很直接。
Kimi Code 真正要看的，不是第一屏代码有多长。
是它能不能把最后一个测试跑绿。
04
API，留给真的要把 K3 接进流程的人。
如果前面三个入口已经能解决你的问题，这一段可以直接跳过。
开放平台的模型 ID 是 kimi-k3，地址是 https://api.moonshot.cn/v1，兼容 OpenAI SDK。
先去 API Key 页面创建 Key，再装 SDK。
```
python3 -m pip install --upgrade 'openai>=1.0'
```
把 Key 放进环境变量，不要塞进代码，更别顺手推到公开仓库。
Windows PowerShell
```
$env:MOONSHOT_API_KEY = '你的 API Key'
```
macOS 和 Linux
```
export MOONSHOT_API_KEY='你的 API Key'
```
最小请求长这样。
```
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ['MOONSHOT_API_KEY'],
base_url='https://api.moonshot.cn/v1',
)
response = client.chat.completions.create(
model='kimi-k3',
messages=[
{'role': 'user', 'content': '用一句话介绍 Kimi K3。'},
],
)
print(response.choices[0].message.content)
```
终端能打出回答，才算 Key、地址、模型名和账户余额都接通了。
截至 7 月 17 日，官方定价是，缓存命中输入 2 元每百万 token，缓存未命中输入 20 元，输出 100 元。价格会变，真进生产以前，再去看一眼官方定价页。
这块最容易混的是名字。
开放平台用 kimi-k3。Kimi Code 会员接口用 k3。第三方 Coding Agent 要开 1M，有些配置里要写 k3[1m]。
不是同一个名字。
另外，视觉输入不能直接扔普通公网图片 URL，要用 Base64 data URL 或 ms://<file-id>。多轮对话和工具调用，也得把完整的 assistant message 原样传回，不能只留下最后那段答案。
K3 始终开启思考模式，思考力度只支持 max。max_completion_tokens 默认 131072，最高可以设到 1048576。几个采样参数是固定值，官方建议不要自己乱传。联网搜索工具还在更新，我不会建议你现在就塞进生产流程。
API 这东西，说到底就是水电煤。
普通人不需要先研究管道怎么铺，打开水龙头能用就行。只有准备盖一整栋楼的人，才真的需要往后看。
四个入口走完，你会发现，它们并不是四个重复的 Kimi。
网页 Agent 处理云端资料。
Kimi Work 接触本地文件和浏览器。
Kimi Code 进入代码仓库。
API 把能力接进你的系统。
同一个 K3，真正变化的，是它能碰到什么，又能替你做到哪一步。
但不管用哪个入口，有一件事都一样。
你得把任务写清楚。
上下文再长，也不能替你猜。
如果现在让我给 Agent 写任务，我会用下面这套六段式。没什么玄学，就是尽量把人脑子里的默认信息掏出来。
```
【目标】
最终要解决什么问题，给谁使用。
【背景】
已有情况、读者、业务场景和限制。
【输入】
必须读取哪些文件、目录、链接或数据，谁的优先级更高。
【过程】
先做什么，后做什么。材料冲突怎么处理。哪些动作必须先确认。
【交付】
文件格式、结构、长度、保存位置，要不要可编辑版本。
【验收】
哪些测试必须通过，哪些来源必须引用，不能出现什么，完成后怎么自检。
```
你可以嫌它麻烦。
我完全理解。
第一次写这种任务，可能比自己动手还慢。你得想清楚材料、权限、交付物，还得给它设计验收标准。
但这件事跟带一个新同事其实很像。
你第一次把工作交出去的时候，沟通成本一定很高。等规则、模板和验收方式都沉淀下来，后面每一次才会越来越快。
我们以前用 AI，习惯问的是「你知道吗」。
后来开始问「你会做吗」。
到了 K3 这一代，更重要的问题变成了「你做完了吗」。
这三个问题看起来只差几个字，背后其实是责任一点点从人移到机器上的过程。
想想还挺奇妙的。
一年前，大家还在围着聊天框，看哪个模型说话更像人。
现在，我们已经开始给它文件夹、浏览器、终端、API Key，再让它对一个交付物负责。
当然，我不觉得 K3 已经完美。
网页 Agent 不是 1M，完整权重当时还没全部放出，免费权益也得看活动页。Agent 会慢，会犯错，会一本正经地给你塞一个假数字。权限一旦给大了，风险也跟着变大。
但是我还是觉得，K3 这次确实憋了个大的。
不是因为 2.8 万亿这个数字大。
而是它把 Kimi 从一个长文本聊天产品，推向了一套完整的 Agent 工作入口。
最后，再回到那架黑鹰直升机。
它能不能飞起来，当然很酷。
但真正决定 K3 有没有用的，是它能不能按你的要求起飞，途中不乱飞，最后稳稳落回停机坪。
任务也是一样。
能开始，只是 Demo。
能收尾，才是工作。
以上，既然看到这里了，如果觉得这篇有用，随手点个赞、评论、引用三连吧。也可以把文章留着，等你打开 K3 的时候，照着里面那套任务自己跑一遍。
7 月 27 日以后再读到这篇，记得去官方仓库看一眼，完整权重到底有没有按计划放出。
我们，下次再见。
本文资料依据 2026 年 7 月 17 日可见的官方页面与手册。主要参考 [Kimi K3 发布说明](https://www.kimi.com/blog/kimi-k3)、[网页 Agent 功能与限制](https://www.kimi.com/zh-cn/help/agent/agent-features-and-limits)、[Kimi Work 产品页](https://www.kimi.com/products/kimi-work)、[Kimi WebBridge 介绍](https://www.kimi.com/zh-cn/help/kimi-webbridge/kimi-webbridge-introduction)、[Kimi Code 使用手册](https://www.kimi.com/code/docs/)、[Kimi K3 API 指南](https://platform.kimi.com/docs/guide/kimi-k3-quickstart)与[官方定价页](https://platform.kimi.com/docs/pricing/chat-k3)。
## 相关链接
- [Ando](https://x.com/AndoRAG)
- [@AndoRAG](https://x.com/AndoRAG)
- [20K](https://x.com/AndoRAG/status/2078061024746586311/analytics)
- [Kimi 网页 Agent](https://www.kimi.com/agent)
- [Kimi Work](https://www.kimi.com/products/kimi-work)
- [https://api.moonshot.cn/v1](https://api.moonshot.cn/v1)
- [API Key 页面](https://platform.kimi.com/console/api-keys)
- [官方定价页](https://platform.kimi.com/docs/pricing/chat-k3)
- [https://www.kimi.com/blog/kimi-k3](https://www.kimi.com/blog/kimi-k3)
- [https://www.kimi.com/zh-cn/help/agent/agent-features-and-limits](https://www.kimi.com/zh-cn/help/agent/agent-features-and-limits)
- [https://www.kimi.com/products/kimi-work](https://www.kimi.com/products/kimi-work)
- [https://www.kimi.com/zh-cn/help/kimi-webbridge/kimi-webbridge-introduction](https://www.kimi.com/zh-cn/help/kimi-webbridge/kimi-webbridge-introduction)
- [https://www.kimi.com/code/docs/](https://www.kimi.com/code/docs/)
- [https://platform.kimi.com/docs/guide/kimi-k3-quickstart](https://platform.kimi.com/docs/guide/kimi-k3-quickstart)
- [https://platform.kimi.com/docs/pricing/chat-k3](https://platform.kimi.com/docs/pricing/chat-k3)
- [Upgrade to Premium](https://x.com/i/premium_sign_up)
- [6:15 PM · Jul 17, 2026](https://x.com/AndoRAG/status/2078061024746586311)
- [20.7K Views](https://x.com/AndoRAG/status/2078061024746586311/analytics)
- [View quotes](https://x.com/AndoRAG/status/2078061024746586311/quotes)
---
*导出时间: 2026/7/18 15:17:38*