Kimi 是月之暗面（Moonshot AI）推出的 AI 助手产品线：网页与 App 以长上下文对话、读文档与创作为核心；面向开发者的 Kimi Code 提供终端 CLI、编辑器扩展能力，以及可接入 Claude Code 等工具的 Coding API；另外还有按量计费的开放平台，适合把模型嵌进自有产品。本文按「产品分工 → 安装开通 → 登录配置 → 日常对话 → 代码编辑 → 跨场景辅助 → 学习路径 → 官方入口」展开，尽量写细，方便对照上手。
一、Kimi 是什么：先分清三条线
| 产品线 | 入口 | 计费直觉 | 最适合 |
| --- | --- | --- | --- |
| Kimi 助手 | kimi.com 网页 / 手机 App | 免费额度 + 会员 | 长文、资料、写作、问答 |
| Kimi Code | CLI / IDE / Coding API | 会员权益 + 频控 | 读仓、改文件、跑命令的 Agent 编程 |
| Kimi 开放平台 | api.moonshot.cn 等 | 按量付费 | 业务系统集成、多模态应用 |
务必记住：Kimi Code 的 Key / Base URL 与 开放平台 Key 不是同一套账号体系，互相不能混用。
1. 它擅长什么
- 超长材料阅读、归纳、多文档对照
- 中文写作、翻译、方案与纪要草稿
- Kimi Code：多文件工程修改、终端操作、网页检索辅助开发
- 同一模型可在普通版与高速版之间切换（以会员档位为准），按任务节奏选速度
2. 它不替代什么
- 不替代代码合并前的人工审查与业务拍板
- 不保证网页引用与事实永远正确——关键数字、法务结论必须核对
- Coding 会员有频控，不适合无节制刷自动化请求
二、安装与开通
1. 网页 / App（聊天）
- 打开 https://www.kimi.com 完成注册登录
- 应用商店下载官方 Kimi App，核对开发者后再安装
- 按需开通会员，以解锁更长上下文、更高额度等权益（以官网当前说明为准）
2. 安装 Kimi Code CLI（推荐官方脚本）
macOS / Linux：
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bashWindows PowerShell：
irm https://code.kimi.com/kimi-code/install.ps1 | iexWindows 还需安装 Git for Windows（CLI 使用其中的 Git Bash）。若 Git Bash 不在默认路径，把环境变量 KIMI_SHELL_PATH 指到 bash.exe。
也可使用 npm（需 Node.js 22.19+）：
npm install -g @moonshot-ai/kimi-code安装后执行 kimi 启动；首次在交互界面输入 /login 完成接入。升级可用 kimi upgrade。
说明：CLI 已从旧版 Python 实现迁移到 Node.js 新版，旧版不再维护，请按官网升级说明迁移。
3. VS Code 扩展
在扩展市场搜索「Kimi Code」。文档提示：新版 TS CLI 与旧版 Python 插件的适配可能不一致，以官网当前说明为准。若安装后侧栏不出现，执行 Developer: Reload Window。
4. API Key 与地址
- 编程会员：在 Kimi Code 控制台创建 Key（创建时通常只显示一次，请立即保存）
- 开放平台：在 Moonshot / Kimi 开放平台创建按量 Key
Coding API 常见地址：
| 协议 | Base URL |
| --- | --- |
| OpenAI 兼容 | https://api.kimi.com/coding/v1 |
| Anthropic 兼容 | https://api.kimi.com/coding/ |
常见模型 ID（以文档为准）：k3、kimi-for-coding、kimi-for-coding-highspeed。
开放平台聊天示例 base：https://api.moonshot.cn/v1。
接入第三方 Agent 时保持真实客户端标识；篡改 User-Agent 可能被视为违规。
三、日常对话：长文、研究与写作
1. 好提示的四要素
目标 + 材料 + 输出格式 + 禁止编造。
上传 PDF / 粘贴长文后，先要求「目录级摘要 + 关键结论」，再指定某一章深挖。
2. 典型场景
- 论文、财报、制度文件精读（涉及法律效力的结论必须人工确认）
- 竞品页对比表（你提供链接或正文，要求标注出处）
- 会议录音转写后再提炼行动项表格
3. 会员与频控
Kimi Code 文档提到较高输出速度、周期性请求上限与并发上限等——具体数字随套餐变化，以控制台为准。做脚本或 CI 时请加退避、缓存与失败重试上限，避免打满额度。
四、代码编辑：从 CLI 到第三方 Agent
1. CLI 工作流
cd your-project
kimi示例任务：
阅读本仓库测试配置，为 auth 模块补单测并跑到通过；
不要改 CI 密钥与无关目录；最后给出中文变更说明。能力包括：读改代码、执行 Shell、搜文件、抓网页，并根据报错调整下一步。
2. 接到 Claude Code 等工具
将 Coding 的 Base URL 与 API Key 写入对应工具环境变量即可。主路径可用 coding 专用模型，简单子任务可用高速版以省时间。
3. 任务分层与审查
| 层级 | 例子 | 建议 |
| --- | --- | --- |
| 小 | 单函数、补日志 | 直接交互 |
| 中 | 跨 3–5 文件功能 | 先计划后执行 |
| 大 | 模块迁移 | 拆里程碑，每步可回滚 |
每次检查：是否改到范围外？是否编造 API？测试是否真跑过？是否把密钥写进仓库？
4. 开放平台做「半自动」工具
适合：diff 审查机器人、日志归类、文档生成服务。深度改仓仍建议 Kimi Code 或同类 Agent，而不是只在聊天框复制粘贴。
五、跨场景辅助
- 学习：错题讲解、知识卡片；要求分「结论 / 推导 / 待查」
- 写作：公众号、方案、邮件；提供术语表保持译名统一
- 数据：SQL / pandas 草稿；禁止假装已跑你未提供的数据
- 办公：纪要 → 行动项表（负责人 / 截止日期 / 风险）
六、推荐两周学习路径
第 1–2 天： 网页长文吃透风格，试会员能力边界
第 3–5 天： 安装 CLI，每天完成一个可提交的小改动并审 diff
第 6–10 天： 把 Coding API 接到一个第三方 Agent
第 11–14 天： 整理团队提示词模板与频控策略
七、常见问题
Q：Code Key 和开放平台 Key 能共用吗？
A：不能。Base URL、计费与账号体系都不同。
Q：为什么登录失败或模型列表为空？
A：检查 Key 是否来自与所选平台一致的站点；Code 与开放平台选错会校验失败。
Q：旧版 Python CLI 还能用吗？
A：官方已迁移 Node 新版，旧版不再维护，请升级。
八、官方入口
- 助手：https://www.kimi.com
- Kimi Code 文档：https://www.kimi.com/code/docs/
- CLI 安装：
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash - 开放平台：以你账号实际控制台入口为准（platform.kimi.com / Moonshot 开放平台等）
九、小结
- 聊天走 kimi.com；改仓库优先 Kimi Code CLI。
- 两套 API 与 Key 勿混用。
- 写代码：明确验收 → 执行 → 每次看 diff。
- 长文先大纲后深挖，关键事实人工核对。
- 自动化必须尊重会员频控。