传统的代码补全工具会在你输入时提供代码片段建议，但它们对整个项目缺乏深入理解。在重构多个文件、调试复杂问题或自动化重复性任务时，开发者常常需要在 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 的上下文窗口
Kimi K3 提供高达 100 万 token 的上下文窗口，这意味着 Kimi Code 能够理解你整个项目的结构、依赖关系和模式。它看到的不只是你正在编辑的文件——而是所有内容之间的关联。这使得多文件重构、架构调整和大规模调试成为可能。Kimi K3 还具备原生的视觉理解能力，能够在编程任务中对截图、图示和视频进行推理。
计划模式与 shell 模式
计划模式：按下
Shift-Tab（或输入/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 分析——适用于重现 UI 问题或讲解设计方案（视频输入需要支持视频的模型）审批机制：在修改文件或运行命令之前，Kimi Code 会先请求确认。需要时可启用两种自动化级别：YOLO 模式（
kimi --yolo或/yolo）会自动批准工具操作，但仍可能提出问题；Auto 模式（kimi --auto或/auto）则完全自主运行、从不询问——适合无人值守的场景
标准版与高速版
Kimi Code 提供两种基于同一模型、编程能力完全相同的速度档位：
标准版：日常工作的默认档位
高速版：输出速度约为标准版的 5–6 倍，最高可达每秒 100 个 token，且高度稳定。在 CLI 中通过
/model即可立即切换，或在第三方工具中使用模型 IDkimi-for-coding-highspeed。高速版需要 Allegretto 及以上套餐
在配额方面，滚动 5 小时窗口内支持大约 300–1200 次请求，最多允许 30 个并发请求，此外还有每 7 天自动刷新的周配额。
无缝 IDE 集成
Kimi Code CLI 通过 kimi acp 子命令原生支持 Agent Client Protocol（ACP），可与以下工具集成：
VS Code：提供完整的 Kimi Code 扩展
Zed：原生支持 ACP
JetBrains IDE：通过 AI 聊天插件实现 ACP 兼容
MCP（Model Context Protocol）支持
Kimi Code 支持 Model Context Protocol（MCP），这是一种开放协议，允许 AI 模型安全地与外部工具和数据源交互。这将 Kimi Code 的能力扩展到代码编辑之外：
外部工具集成：连接数据库、API、文档源和开发工具
自定义工作流：为安全扫描、性能分析或文档生成等特定任务构建专用智能体
生态兼容：使用社区现有的 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可将长时间运行的命令和子智能体移到后台，并在/tasks面板中追踪它们
这使得 Kimi Code 非常适合跨越多个文件、需要长时间维持上下文的长期开发任务。
自主目标、集群与插件
对于运行时间超过单次提示词的任务，Kimi Code 提供了更高层次的自动化：
目标模式：使用
/goal <目标>启动一个自主目标，Kimi Code 会在多轮交互中持续朝该目标推进，直到完成或遇到需要决策的节点。可用/goal next排队追加后续任务集群模式：
/swarm <任务>会让多个智能体并行处理同一目标，提供实时进度展示，并具备速率限制感知的重试机制插件与 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 Console 中创建和管理 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 key。
点击面板中的齿轮图标可访问设置及更多选项。
打开命令面板并输入“Kimi Code”即可访问更多命令。
Zed：
Kimi Code CLI 通过 kimi acp 子命令原生支持 ACP。在 Zed 的设置中将 Kimi Code 添加为外部智能体：
{ "agent_servers": { "kimi": { "command": "kimi", "args": ["acp"] } } }JetBrains IDE： 启用 AI 聊天插件，并在“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 步：其他界面
浏览器界面：
启动基于网页的界面，获得图形化体验。它在前台运行，并会自动打开浏览器——按 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 将 Kimi K3——全球首个开放的 3T 级模型——与真正基于智能体的工作流相结合，代表了新一代 AI 编码助手。与只能被动响应输入的传统代码补全工具不同，Kimi Code 会主动规划、执行并迭代——这使它非常适合多文件重构、调试和自动化等复杂任务。
凭借高达 1M 的上下文窗口、Standard 和 HighSpeed 两档速度模式，以及无缝的 IDE 集成，Kimi Code 改变了开发者的编码方式。无论是迁移遗留代码、调试生产问题，还是搭建新项目，Kimi Code 都能提供你所需的智能协助，帮助你更快、更高效地工作。
常见问题
kimi acp 子命令支持 Zed、JetBrains 等兼容 ACP 的 IDE。kimi-for-coding）。Moderato 及以上等级会员可选择 Kimi K3（k3 或 256K 变体 k3-256k），Allegretto 及以上等级会员还可解锁完整的 1M token 上下文窗口及高速版层级（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 用量、上下文消耗和配额。凭借高达 1M 的上下文窗口和智能压缩，Kimi Code 能有效处理长时间运行的开发任务。kimi web 即可启动基于网页的界面——它在前台运行并自动打开浏览器。在 TUI 中，/web 可将当前会话继续到浏览器中，kimi vis 则会打开会话可视化工具。当你更喜欢可视化界面，或需要在协同编程时共享屏幕时，这会很有用。/help 查看帮助，/login 进行身份验证，/model 切换模型，/sessions（别名 /resume）用于会话管理，/new（别名 /clear）开始新会话，/compact 压缩对话，/usage 查看配额，/plan 进入计划模式，/yolo 和 /auto 用于自动化模式，/tasks 查看后台任务，/goal 和 /swarm 用于自主执行任务，/web 在浏览器中打开会话，/export-md 导出内容，/mcp 查看 MCP 状态，/exit 退出。在 CLI 中输入 / 即可查看完整列表。