传统的代码补全工具会在你输入时提供代码片段建议,但它们缺乏对整个项目的深入理解。在重构多个文件、调试复杂问题或自动化重复性任务时,开发者往往要在 IDE、终端和文档之间反复切换,并手动协调每一步。
AI 编程 agent 远不止于简单的建议。它能分析整个仓库、规划多步骤改动、执行命令并自主迭代。它不是逐行辅助,而更像一位能胜任复杂工作流程的工程伙伴。
Kimi Code 正是围绕这种基于 agent 的思路打造的。它运行于终端,并与 VS Code 等主流 IDE 集成,将长上下文推理与高速执行相结合,支持大规模的多文件重构、调试与自动化。
Kimi Code 核心功能
Kimi Code 将 Kimi K3 的强大能力与终端优先的设计及深度 IDE 集成相结合。这种以 agent 为主导的思路由几项超越简单代码补全的核心功能驱动:
基于 agent 的工作流程
与仅提供代码建议的工具不同,Kimi Code 是一个真正的 agent。它能分析你的代码库、制定计划、执行命令,并根据结果不断迭代。只要告诉它“将所有 API 调用重构为 async/await”,它就会找出所有相关文件、完成改动、运行测试并修复任何问题——全程自动完成。
最高 1M token 上下文窗口
Kimi K3 提供最高 1M token 的上下文窗口,这意味着 Kimi Code 能理解你整个项目的结构、依赖和模式。它不只看到你正在编辑的文件,还能看到一切如何相互关联。这让多文件重构、架构变更和大规模调试成为可能。Kimi K3 还具备原生视觉理解能力,可以在编程任务中直接分析截图、示意图和视频。
Plan 模式与 shell 模式
Plan 模式:按
Shift-Tab(或输入/plan)进入 Plan 模式。Kimi Code 会先研究你的代码库并提出分步计划,经你批准后才改动任何文件——这是启动大型改动最稳妥的方式。Shell 模式:在输入框中输入
!,无需离开对话即可运行终端命令。命令输出会写入上下文,供 AI 在后续对话中使用。按Ctrl+B可把长时间运行的命令转入后台,稍后在/tasks面板中查看。
这种灵活性让你能在谨慎规划、AI 驱动执行与直接执行命令之间无缝切换。
思考强度档位
Kimi K3 支持 low / high / max 三档思考强度,你可以为每个任务选择合适的推理投入——简单提问用轻量档位,复杂的架构决策、棘手 bug 或大型重构用最高档位。随时可以输入 /model 切换模型。
提示:切换模型会使已有的提示词缓存失效,因此在让 Kimi K3 开始工作前,建议先用 /new 开启新会话——效果更好,token 消耗也更低。
高级交互功能
多行输入:粘贴代码或错误日志时,按
Shift-Enter或Ctrl-J插入换行路径自动补全:输入
@可从当前工作目录自动补全文件和目录路径图片与视频粘贴:按
Ctrl-V(Windows 上为Alt-V)粘贴图片或视频片段供 AI 分析,适合复现界面 bug 或讲解设计方案(视频输入需模型支持视频)批准机制:在修改文件或运行命令前,Kimi Code 会请求确认。需要自动化时有两档可选:YOLO 模式(
kimi --yolo或/yolo)会自动批准工具操作,但仍可能向你提问;Auto 模式(kimi --auto或/auto)完全自主、从不提问,适合无人值守的任务
Standard 与 HighSpeed 双档
Kimi Code 提供基于同一模型的两档速度,编程能力完全相同:
Standard:日常工作的默认档位
HighSpeed:输出速度约为 Standard 的 5–6 倍,最高可达 100 Tokens/s,且稳定性出色。在 CLI 中输入
/model即可随时切换,或在第三方工具中使用kimi-for-coding-highspeed模型 ID。HighSpeed 需要 Allegretto 及以上套餐
配额方面,在每 7 天自动刷新的每周配额之上,还有一个滚动 5 小时窗口,约支持 300–1,200 次请求,最多 30 个并发请求。
无缝 IDE 集成
Kimi Code CLI 通过 kimi acp 子命令原生支持 Agent Client Protocol(ACP),可与以下环境集成:
VS Code:提供专用的 Kimi Code 扩展
Zed:原生支持 ACP
JetBrains IDE:通过 AI chat 插件兼容 ACP
MCP(Model Context Protocol)支持
Kimi Code 支持 Model Context Protocol(MCP)——一个让 AI 模型能安全地与外部工具和数据源交互的开放协议。这让 Kimi Code 的能力不再局限于代码编辑:
外部工具集成:连接数据库、API、文档源和开发工具
自定义工作流程:为安全扫描、性能分析、文档生成等特定任务构建专用 agent
生态兼容:使用社区现有的 MCP 服务器,或创建你自己的
MCP 服务器在 mcp.json 中配置——用户级为 ~/.kimi-code/mcp.json,项目级为 .kimi-code/mcp.json——也可以用 /mcp-config 命令交互式配置;/mcp 可查看所有已配置服务器的连接状态。stdio、HTTP、SSE 三种传输方式均受支持。为保障安全,MCP 工具与 Kimi Code 的其他操作遵循相同的批准机制。
会话与上下文管理
Kimi Code 为复杂的多步骤工作流程提供强大的会话管理和长上下文处理能力:
会话持久化:对话会自动保存。使用
--continue恢复任意会话,或用--session <id>在多个项目间切换上下文压缩:接近上下文上限时,使用
/compact让 AI 在保留关键信息的同时总结对话历史——还可以附加指令提示它保留哪些内容用量监控:随时输入
/usage查看 token 用量、上下文消耗和配额信息重新开始:使用
/new(别名/clear)重置当前会话上下文分叉与导出:
/fork可从当前会话分叉出一个保留完整历史的新会话,/export-md可把任意会话导出为 Markdown 文件后台任务:按
Ctrl+B可把长时间运行的命令和子 agent 转入后台,并在/tasks面板中跟踪状态
这使 Kimi Code 非常适合跨多个文件、需要长期维护上下文的长期运行开发任务。
自主目标、集群与插件
对于单个提示词装不下的工作,Kimi Code 提供更高层级的自动化能力:
目标模式:用
/goal <objective>启动一个自主目标,Kimi Code 会跨多轮持续推进,直到完成或遇到需要你决策的分歧点。可以用/goal next排队后续任务集群模式:
/swarm <task>可让多个 agent 并行处理同一目标,实时显示进度,并在触发速率限制时自动重试插件与 agent 技能:通过
/plugins从官方市场安装打包了技能和 MCP 服务器的插件包,也可以把你自己可复用的工作流程写成基于 Markdown 的技能教给 Kimi Code定时任务:用自然语言设置定时或一次性提醒,Kimi Code 会在指定时间自动执行
设备安全与兼容性
Kimi Code 内置了诸多安全与兼容性功能,适合专业开发场景:
设备 30 天解绑:出于安全考虑,连续 30 天未活跃的设备会被自动解绑,避免闲置设备长期保留授权——重新运行
/login即可恢复与你常用的 agent 工具兼容:除官方 CLI 和 VS Code 扩展外,Kimi Code API 同时兼容 OpenAI API 和 Anthropic 协议,并提供 Claude Code、OpenCode、Codex 等工具的官方配置指南
跨平台一致体验:无论你使用 macOS、Linux 还是 Windows(通过内置 Git Bash),Kimi Code 都提供相同的命令和功能,体验始终如一
如何使用 Kimi Code?
第 1 步:安装 Kimi Code CLI
Kimi Code CLI 使用 TypeScript 编写,运行于 Node.js——无需 Python 环境。
Linux/macOS(推荐):
Windows(PowerShell):
在 Windows 上,首次启动前请先安装 Git for Windows——CLI 会使用其内置的 Git Bash。
通过 npm 安装(备选)(需要 Node.js 22.19.0 或更高版本):
还在使用旧版基于 Python 的 kimi-cli?安装后运行 kimi migrate,即可一步导入现有配置、会话和 MCP 声明。
第 2 步:认证与配置
启动 Kimi CLI:
然后使用以下任一方式进行认证:
方式 A:OAuth 登录(推荐)
运行 /login 命令并选择“Kimi Code (OAuth)”。Kimi Code 使用 OAuth 设备码流程:打开终端中显示的链接,用你的 Kimi 账号登录,输入用户码完成授权——无需手动管理 API 密钥。
方式 B:API 密钥
在 /login 中改选“Kimi Platform API key”(或用 /provider 配置提供商)。集成第三方开发工具时,请在 Kimi Code 控制台 创建和管理 API Key——最多 5 个,每个仅在创建时显示一次。
第 3 步:开始与 AI 一起编程
认证完成后,你就可以立即开始使用 Kimi Code。
以下是一些示例命令:
基础代码生成:
多文件重构:
调试:
第 4 步:使用高级功能
为最难的任务切换到 Kimi K3:
运行 /model 并选择 Kimi K3,然后根据任务选择思考强度档位(low / high / max)。为获得更好效果并降低 token 消耗,切换模型前先用 /new 开启新会话。
内联运行 shell 命令:
输入 ! 后接命令,即可在对话输入框中直接执行。
进入 Plan 模式稳妥改动:
按 Shift-Tab,让 Kimi Code 先调研再给出计划,确认后才编辑文件。
粘贴代码、图片或视频:
按 Ctrl-V(Windows 上为 Alt-V)从剪贴板粘贴,再用 Shift-Enter 或 Ctrl-J 输入多行。
引用项目文件:
输入 @ 后跟文件/目录名即可自动补全。
第 5 步:与你的 IDE 集成
VS Code:
从 VS Code 应用市场安装“Kimi Code”扩展,然后用你的 Kimi 账号登录——或跳过登录,使用你已有的 API 密钥配置。
点击面板中的齿轮图标可访问设置和更多选项。
打开命令面板并输入“Kimi Code”即可访问更多命令。
Zed:
Kimi Code CLI 通过 kimi acp 子命令原生支持 ACP。在 Zed 的设置中将 Kimi Code 添加为外部 agent:
{ "agent_servers": { "kimi": { "command": "kimi", "args": ["acp"] } } }JetBrains IDE: 启用 AI chat 插件,并从“Configure ACP agents”中添加 Kimi Code,即可在 IDE 中直接驱动 Kimi 会话。
第 6 步:管理会话与上下文
Kimi Code 的会话管理能帮你在长时间的开发会话中保持上下文连贯:
查看并切换会话:
恢复之前的会话:
切换到指定会话:
开始全新会话:
接近上限时压缩上下文:
随时输入 /usage 监控 token 用量、上下文消耗和配额。为获得最佳的长上下文任务体验,请定期使用 /compact 总结对话历史,同时保留关键信息。
第 7 步:配置 MCP(Model Context Protocol)
通过 MCP 服务器集成外部工具,扩展 Kimi Code 的能力。服务器在 mcp.json 中声明——用户级为 ~/.kimi-code/mcp.json,项目级为 .kimi-code/mcp.json(同名条目以项目级为准):
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": { "CONTEXT7_API_KEY": "your-key" }
}
}
}带 command 字段的条目是 stdio 服务器;带 url 字段的条目是 HTTP 服务器(仅旧版 SSE 服务需要设置 "transport": "sse")。更喜欢点选操作?在 TUI 中运行 /mcp-config 即可交互式添加、编辑或删除服务器,运行 /mcp 可查看连接状态。需要 OAuth 授权的服务器,运行 /mcp-config login <server-name>。
在工作流程中使用 MCP 工具: 配置完成后,Kimi Code 可自动调用 MCP 工具。例如,搭配一个数据库 MCP 服务器:
MCP 工具与 Kimi Code 的其他操作遵循相同的批准机制。在 YOLO 模式下,MCP 操作会被自动批准,让工作流程更高效。
第 8 步:其他使用方式与维护
浏览器 UI:
启动网页版界面,获得图形化体验。它在前台运行并自动打开浏览器——按 Ctrl+C 停止:
在 TUI 中输入 /web,可把当前会话转到浏览器中继续。也可以用 kimi vis 打开会话可视化视图,一览整个会话的进展。
升级或卸载:
如果你通过 npm 安装,则使用 npm install -g @moonshot-ai/kimi-code@latest 升级。卸载时,删除 kimi 可执行文件(脚本安装)或运行 npm uninstall -g @moonshot-ai/kimi-code(npm 安装)。
实际应用场景
Kimi Code 擅长处理超越简单自动补全的复杂编程任务。以下是五个实用场景:
1. 大规模代码重构
场景:你需要将一个遗留代码库从一个框架迁移到另一个,或者跨数百个文件更新编码范式。
示例提示词:
2. 复杂调试
场景:你遇到一个涉及多个服务、数据库查询和 API 调用的生产 bug,传统调试工具无法让你看清全貌。
示例提示词:
3. 自动生成测试
场景:你有一个测试覆盖率偏低的大型代码库,需要全面的测试,但不想手动编写。
示例提示词:
4. 项目初始化与配置
场景:你正要启动一个新项目,需要搭建整个开发环境,包括依赖、配置文件、CI/CD 和文档。
示例提示词:
5. 通过 MCP 集成外部工具
场景:你需要集成数据库、API 或专业服务等代码库之外的外部工具。借助 MCP(Model Context Protocol),Kimi Code 可以安全地与这些外部资源交互。
示例提示词:
结语
Kimi Code 将全球首个开源 3T 级模型 Kimi K3 与真正基于 agent 的工作流程相结合,代表了新一代 AI 编程助手。与只能被动响应你输入的传统代码补全工具不同,Kimi Code 会主动规划、执行并迭代——这让它非常适合多文件重构、调试和自动化等复杂任务。
凭借最高 100 万 token 的上下文窗口、Standard 与 HighSpeed 双档速度以及无缝的 IDE 集成,Kimi Code 正在重塑开发者的编程方式。无论是迁移遗留代码、调试生产问题还是搭建新项目,Kimi Code 都能提供你所需的智能辅助,让你工作得更快、更高效。
常见问题
kimi acp 子命令支持 Zed、JetBrains 等兼容 ACP 的 IDE。kimi-for-coding)。Moderato 及以上会员可选择 Kimi K3(k3 或 256K 版本 k3-256k);Allegretto 及以上会员还可解锁完整的 100 万 token 上下文窗口和 HighSpeed 档(kimi-for-coding-highspeed)。在 CLI 中输入 /model 即可切换模型。low / high / max 三档思考强度,你可以为每个任务选择合适的推理投入——更高档位会在回应前投入更多时间推理,适合复杂的架构决策或棘手的 bug。思考强度是按模型设置的,用 /model 切换模型时选择合适的模型和档位即可。建议切换后用 /new 开启新会话,因为切换模型会使提示词缓存失效。kimi --yolo 或 /yolo)会自动批准工具操作,但仍可能向你提问;Auto 模式(kimi --auto 或 /auto)完全自主、从不提问。请仅在安全环境中使用这些模式,提交前务必检查改动。! 即可进入 shell 模式,无需离开对话就能运行终端命令——命令输出会写入上下文,供 AI 在后续对话中使用。对于长时间运行的命令,按 Ctrl+B 可将其转入后台,并随时在 /tasks 面板中查看状态。mcp.json(用户级 ~/.kimi-code/mcp.json 或项目级 .kimi-code/mcp.json)中配置 MCP 服务器,也可以用 /mcp-config 交互式配置,/mcp 可查看连接状态。支持 stdio、HTTP、SSE 三种传输方式。为保障安全,MCP 工具与 Kimi Code 的其他操作遵循相同的批准机制。/sessions 查看并切换会话,--continue 恢复之前的工作,/compact 让 AI 在保留关键信息的同时总结对话历史。随时输入 /usage 查看 token 用量、上下文消耗和配额。凭借最高 100 万 token 的上下文窗口和智能压缩,Kimi Code 能高效应对长时间运行的开发任务。kimi web 即可启动网页版界面——它在前台运行并自动打开浏览器。在 TUI 中输入 /web 可把当前会话转到浏览器中继续,kimi vis 则可打开会话可视化视图。当你偏爱可视化界面,或需要在结对编程时共享屏幕时,这些方式非常实用。/help 查看帮助、/login 进行认证、/model 切换模型、/sessions(别名 /resume)用于会话管理、/new(别名 /clear)重新开始、/compact 压缩对话、/usage 查看配额、/plan 进入 Plan 模式、/yolo 和 /auto 两档自动化模式、/tasks 管理后台任务、/goal 和 /swarm 处理自主任务、/web 在浏览器中打开会话、/export-md 导出会话、/mcp 查看 MCP 状态、/exit 退出。在 CLI 中输入 / 即可查看完整列表。