国内直连的编程 Agent 实战：Kimi Code 终端、桌面与编辑器形态实操手册

2026 年 10 月，随着 Kimi K3.1 Pro 的全量上线（参数规模达 3 万亿级，支持 100 万词元上下文），AI 编程 Agent 的能力上限再次被刷新。

然而，当模型的绝对能力突破一定阈值后，国内开发者面临的真正挑战，便转向了如何让强大的模型能力在本地环境中顺畅落地。

面对层出不穷的 AI 编程工具，开发者在实际接入时，阻力往往集中在三个隐性门槛上：

• 网络与环境的适配：如何避免繁杂的海外网络配置，实现开箱即用；
• 形态与习惯的错位：终端极客、图形界面偏好者、编辑器原生党，往往找不到契合自身工作流的入口；
• 接口与协议的混淆：在将模型接入自有系统时，分不清开放平台与会员内接口的边界，导致配置频频踩坑。

本篇内容正是为了解决这种“选型与落地”的痛点。我们以国内直连的 Kimi Code 为典型样本，完整拆解一套从本地环境安装、多形态操作，再到 API 接口接入的工程链路。通过跑通这套全流程，你可以清晰地建立起评估一款编程 Agent 落地成本的判断框架。

本文尤其适合以下三类面临选型决策的读者：

• 终端开发者：看重 CLI 的自动化与长任务接管能力；
• 图形界面偏好者：关注桌面端的可视化审查与交互体验；
• 架构与集成工程师：需要理清底层接口协议与配置逻辑。

阅读过程中，你可以对照自己的实际开发环境进行操作，并以此为基准去衡量其他同类工具。

一、先理清两个概念：Kimi Code 与 Kimi API 的分工

在动手之前，先把产品边界理清楚，后面的步骤才不会混淆。

• Kimi Code：是月之暗面推出的 AI 编程 Agent，提供桌面端、CLI、VS Code 扩展插件等形态，承载日常的编码、调试、重构与长任务执行。它本身采用订阅制，具体会员权益与配额以产品官方会员页面公示的信息为准。
• Kimi API：是模型能力的接口层，按调用量计费，面向需要把模型接入自有应用、第三方工具或自动化脚本的场景。两者共享同一套账号体系，但会员权益和配额各自独立，以对应产品页面的说明为准。

此外，还有一个容易混淆的产品 Kimi Work：

• Kimi Work 主打办公场景而非编程。
• 它的 Goal 模式可自动唤醒多智能体网络，由多个 Agent 分工协作处理复杂任务。
• 据官方介绍，Kimi Work 的 Agent 集群最高可包含 300 个子 Agent 协同工作，并内置 Cron 引擎自动处理定时重复任务。
• 编程相关的工作交给 Kimi Code，文档、资料、定时办公任务交给 Kimi Work，两者通过同一账号打通。

二、多形态怎么选，先对号入座

Kimi Code 没有把所有人塞进同一个入口，而是按操作习惯提供了多种形态，选择逻辑很直接：

• CLI：面向习惯终端的开发者，适合服务器运维、脚本自动化、远程开发等场景，支持后台执行长任务。
• 桌面端：面向偏好图形界面的开发者，2026 年 9 月 21 日正式上线，支持 macOS 的 Apple Silicon 与 Intel 芯片以及 Windows 系统，内置终端、浏览器与 Git 状态查看，并提供计划模式用于在执行前审阅方案。
• VS Code 扩展：面向希望留在现有编辑器里的开发者，在扩展市场安装后即可在侧边栏使用。

各形态背后是同一套模型与账号，配置和会话可以衔接，你可以按工作场景切换，而不是被迫固定在某一种操作方式上。

三、安装与登录：两条系统路径

（一）macOS 与 Linux：一条命令完成 CLI 安装

打开终端，执行官方提供的安装脚本命令（脚本地址请前往官方文档获取）：

curl -fsSL 官方安装脚本地址 | bash

• 脚本会自动完成下载与环境配置，官方脚本安装无需预装 Node.js。
• 安装结束后，在终端执行登录命令：

kimi

首次启动会进入 /login 授权流程，按提示在浏览器中完成账号授权即可，无需手动复制和维护 API 密钥。

（二）Windows：用 PowerShell 安装

在 Windows 上打开 PowerShell，执行官方安装命令：

irm 官方PowerShell脚本地址 | iex

完成后同样在终端启动并走 /login 授权。整个过程不需要访问境外网络，也不涉及境外支付环节，账号体系在国内直连。

（三）桌面端与 VS Code 扩展

• 桌面端：从 Kimi Code 官方页面下载对应系统的安装包，macOS 区分 Apple Silicon 与 Intel 两个版本，Windows 下载对应安装包后按向导完成安装。
• VS Code 扩展：在扩展市场搜索 Kimi Code，安装后在侧边栏登录。扩展提供原生聊天面板，支持把面板放在活动栏、侧边栏或独立标签页。

（四）验证安装是否成功

在终端查看版本信息，确认命令已写入环境变量：

kimi --version

• 如果能正常返回版本号，说明安装完成。
• 若新终端提示命令找不到，建议重新打开一个新终端会话以确保环境变量正常加载。
• 除脚本外，CLI 也提供 npm 包 @moonshot-ai/kimi-code，走 npm 安装时需要 Node.js 22.19.0 或更高版本。

四、日常编码：从上下文引用到长任务

（一）用 @ 精准圈定上下文

Kimi Code 支持通过 @ 符号引用资源，让模型只读取你指定的范围，而不是猜测整个项目。引用方式包括三种粒度：

1. 引用文件夹，例如 @src/handlers/；
2. 引用单个文件，例如 @app.ts；
3. 引用特定行范围，例如 @src/app.ts:10-20。

配合斜杠命令可以完成项目扫描与上下文管理。文件修改通过 diff 视图呈现，每一处变更都可以逐行审查并回退，在改动落盘前保留人工确认的环节。

（二）模型与两档输出

• 模型配置：Kimi Code 当前搭载 Kimi K3.1 Pro，模型为 3 万亿级参数规模，支持 100 万词元上下文，以深度思考模式为核心，可通过 low、high、max 三档调节推理强度，默认 high。
• 基准表现：据官方技术报告，K3.1 Pro 在终端任务基准 Terminal-Bench 4.0，以及官方内部的长程任务基准 Kimi Code Bench 3.0 Long-horizon 上均有表现，达到或接近头部闭源模型水平。需要说明的是，基准跑分反映的是模型侧能力，会随版本更新而变化，并不直接等同于日常开发中的实际工具体验。
• 输出档位：提供标准与高速两档。高速版模型 ID 为 k3.1-pro-highspeed，在模型能力一致的前提下，输出速度约为标准版本的 2 至 3 倍。
• 使用建议：高速档适合对响应速度要求极高的场景，具体额度消耗规则以官方说明为准。日常补全用高速档，复杂架构推理切回标准档，由任务性质决定，而不是全程固定一档。

（三）目标模式与多 Agent 协同

对于跨多个文件、需要持续推进的任务，可以使用目标模式。

• 你给出要达成的目标，Kimi Code 会拆解步骤、调用工具并在执行中根据结果调整。
• 需要并行处理时，Agent Swarm 会组织多个 Agent 分工推进，每个 Agent 分配到什么任务由系统根据任务特性自动调度，使用者不需要手动指定分工。
• 权限体系方面，Kimi Code 提供始终询问（Always Ask）、必要时询问（Ask When Needed）、完全自动（Never Ask）三档模式。需要明确的是，即使在完全自动（Never Ask）模式下，计划类动作依然不被自动批准。Plan 模式只能由用户手动开启，Agent 不会自行进入；每份计划都必须人工审查，已在 Plan 模式中的会话同样无法跳过这一步。

注意区分：浏览器自动化与模型联网获取信息

• 浏览器自动化：Kimi 另有独立的 Kimi 浏览器扩展（原 Kimi WebBridge），它通过本地桥接服务配合 Agent 操作你正在使用的 Chrome 或 Edge 浏览器，可以处理打开网页、点击、填写表单、读取动态页面等操作，执行在本地完成，登录态与页面内容不外传，可配合 Kimi Work 等本地 Agent 使用。
• 模型联网：是信息检索行为。二者是相互独立的两类能力。

（四）四层扩展体系

Kimi Code 提供四层扩展，各自职责不同，不要混用概念：

1. Skills：用来封装标准化流程，把重复性操作沉淀为可复用的能力。
2. Hooks：在关键节点自动触发脚本，例如提交前的格式检查。
3. MCP：用于接入外部工具链，对接数据库、内部系统等。
4. Plugins：把完整工作环境打包，便于在团队内分发统一配置。

即使不安装任何插件和技能，Kimi Code 的基础能力依然可用，扩展体系是在基础能力之上做加法，而不是弥补功能缺失。需要说明的是，插件是插件，技能是技能，二者是分开的两类对象。

（五）多模态与测试驱动修复

• K3.1 Pro 支持图片与视频等多模态输入，日志截图、设计稿、架构图、流程图都可以直接作为上下文。
• 处理陌生代码库时，可以先让它梳理模块结构；修复问题时采用测试驱动的方式，先明确预期行为与测试用例，再让改动围绕通过测试展开，降低回归风险。

五、接入其他编辑器：ACP 协议

除了 VS Code 扩展，Kimi Code CLI 还提供 kimi acp 子命令，基于 Agent Client Protocol 与编辑器通信。

• Zed：原生支持该协议，在编辑器内添加对应 Agent 即可调用。
• JetBrains 系列 IDE：也可以通过 ACP 接入。
• VS Code 联动：在命令面板执行 Kimi Code: Run CLI 可以直接在集成终端启动 CLI，让图形化插件与终端 Agent 在同一窗口联动，不必在多个应用之间来回切换。

六、Kimi API：需要接口接入时的用法

（一）先区分两套接口，再选兼容协议

需要把模型接入自有应用或第三方工具时，要先分清两套接口，它们的计费方式、基础地址和模型 ID 都不同，不要混用。

1. 第一套：Kimi API 开放平台

• 计费方式：按量计费（即用即付），与 Kimi Code 订阅相互独立。
• 基础地址：使用官方提供的国内 OpenAI 兼容标准端点。
• 模型 ID：带 kimi- 前缀，例如 kimi-k3.1-pro。海外站点与 Anthropic 兼容地址以开放平台官方文档为准。

1. 第二套：Kimi Code 会员内接口（coding plan）

• 计费方式：走会员订阅额度。
• 使用场景：主要用于在 Claude Code、Codex 等第三方工具中调用 Kimi Code。
• 模型 ID：为 k3.1-pro。
• 兼容协议：同时兼容 OpenAI 与 Anthropic 协议，官方分别提供对应的接入端点地址。

两套接口都兼容 OpenAI 与 Anthropic 的调用格式，沿用现有 SDK 通常只需修改基础地址与密钥，把改动控制在配置层，不必重写请求逻辑。

（二）接口计价的几个数字

以下价格针对的是 Kimi API 开放平台的按量计费，与 Kimi Code 会员内 coding plan 走订阅额度是两套体系，具体以开放平台公示为准。

• 未命中缓存的输入：13 元每百万 Token
• 输出：68 元每百万 Token
• 缓存命中后的输入：降至 1.3 元每百万 Token
• 美元口径：输入 2 美元、输出 10 美元每百万 Token。
• 高速版（K3.1 Pro Highspeed）：输入、输出单价约为标准版的两倍。
• 缓存计费：写入还区分 5 分钟与 1 小时两档 TTL，计费规则以定价页说明为准。

在事实准确性方面，官方称 K3.1 Pro 经过专项优化，单项事实陈述错误率相比 K3 明显下降，包含至少一处事实错误的回答比例也有较大幅度降低。需要说明的是，该测试侧重特定的压力场景，实际日常体验中的准确性已有显著优化。

（三）一个调用示例

下面以开放平台按量计费、OpenAI 兼容方式发起一次请求，配置层面大致如下（请自行填入官方提供的基础端点）：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="开放平台基础端点地址",
)

response = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "解释这段代码的执行流程"}],
)

• 开放平台的模型名填写 kimi-k3.1-pro，需要高速版本时改为 kimi-k3.1-pro-highspeed。
• 如果你是在第三方工具里使用 Kimi Code 订阅额度，则应改用 coding plan 的基础地址与 k3.1-pro 系列模型 ID。
• 密钥在 Kimi 开放平台创建并妥善保存，不要写进会被提交到代码仓库的文件里。

七、常见问题

问：Kimi Code 和 Kimi API 的费用是一回事吗？

• 不是。Kimi Code 是订阅制产品，权益与配额见会员页面；Kimi API 开放平台按 Token 调用量计费，两套账单各自独立，账号体系打通但不能互相抵扣。

问：只用 Kimi Code，还需要单独申请 API Key 吗？

• 日常使用 Kimi Code 的桌面端、CLI 或 VS Code 扩展，走 /login 授权即可，不需要手动管理密钥。只有在接入自有程序或第三方工具时，才需要到开放平台申请 API Key，或在第三方工具中配置 Kimi Code 会员接口。

问：Kimi Work 能不能用来写代码？

• Kimi Work 的主场是办公场景，Goal 模式与定时任务引擎面向文档处理、资料整理和自动化办公，免费版用户可设置 2 个定时任务，随套餐升级可设置更多。编码工作建议放在 Kimi Code 中完成。

问：模型权重可以本地部署吗？

• K3.1 Pro 采用开放权重策略，官方称完整模型权重于 2026 年 11 月 4 日前发布，具体许可与使用条款以官方仓库说明为准，本地部署与二次开发需遵守对应协议。

八、收尾：记住这条主线

如果只保留一条主线，那就是按场景选形态、按用途选计费方式：

• 日常编码在 Kimi Code 的桌面端、CLI、VS Code 扩展之间选择；
• 系统集成与第三方工具接入走 Kimi API，先分清开放平台按量计费与 Kimi Code 订阅接口再填地址；
• 办公自动化交给 Kimi Work。
• 安装从一条官方命令开始，登录走浏览器授权，上下文用 @ 圈定，长任务交给目标模式，需要分发的工作流沉淀为 Skills 或 Plugins。

整个链路国内直连，不依赖境外网络与境外支付。