Skip to content

快速开始

Kimi Code 桌面端是 Kimi Code 的桌面客户端。你可以在图形界面中打开本地项目,通过对话让 Agent 阅读和修改代码,并使用改动、文件预览和终端检查结果。

本页介绍从安装、连接模型到完成第一个任务的最短路径。

Kimi Code 桌面端首页
Kimi Code 桌面端首页:输入消息即可开始对话。

安装与启动

首次启动时选择界面语言和主题,之后可以在设置中调整。

登录

首次启动时可以按页面提示完成 Kimi OAuth 授权,也可以先跳过。之后需要登录时,再从应用中的登录入口完成授权;授权失败时按页面提示重试。

登录 Kimi Code 授权弹窗
登录 Kimi Code:选择账号类型后按提示完成 OAuth 授权。

连接模型

使用 Kimi 官方模型

登录 Kimi 账号后,桌面端会使用账号可用的官方模型。你可以在输入框内的模型选择区域确认当前模型,也可以在设置中的模型模块查看可用模型和模型权限。

未订阅 Kimi 会员的用户系统无法直接读取并使用官方模型,不同会员可使用的模型权益也不同,可以从账号区域找到会员入口,查看并选择适合的会员方案。会员权益和模型权限说明见会员权益模型配置

接入第三方模型供应商

如果你需要使用其他模型供应商:

  1. 打开设置,进入模型供应商区域。
  2. 选择添加供应商,填写 API Key、Base URL 和模型信息。
  3. 保存后回到会话,在输入框附近切换到该模型。
  4. 发送一个只读任务,确认模型可用。
在设置中手动添加模型供应商的表单
手动添加供应商需要填写名称、API 协议、API Key、Base URL 和模型信息。

完整的模型和供应商说明见模型配置平台与模型

新建会话并选择工作区

桌面端会按工作区整理会话。新建会话后,可以在输入框下方选择要使用的本地项目文件夹:

  1. 点击左侧的“新建会话”。
  2. 点击输入框下方的文件夹名称,打开工作区选择器。
  3. 从最近使用的文件夹中选择项目,或点击“选择文件夹…”添加新的本地文件夹。
  4. 确认输入框下方显示了目标工作区后,再输入任务并发送消息。

新选择的文件夹会成为桌面端的工作区,并加入最近使用的文件夹列表。添加时若选择“直接输入绝对路径”,路径会以本地绝对路径解析;空会话必须先选择工作区才能发送。将 Finder 或文件资源管理器中的文件夹拖到侧边栏,也可以直接添加为工作区。

会话会出现在所选工作区的会话列表中。已有工作区和会话可以直接从左侧切换。

新建会话后,在输入框下方打开工作区选择器
新建会话后,点击输入框下方的文件夹名称,从最近使用的文件夹中选择或添加新的工作区。

发起第一个任务

在输入框中输入任务,也可以用 @ 引用文件或目录。输入框左下角的 + 提供几种任务模式:

  • 目标:设定一个持续推进的目标,适合需要多轮执行和检查的长任务;开启后,目标会显示在输入框上方。
  • 计划:先让 Agent 分析并给出计划,确认后再修改文件。
  • Swarm:把可拆分的任务交给多个子代理并行处理,进度会显示在 Tasks 或 Subagent 区域。

任务执行过程中,你可以继续输入补充要求来调整方向,例如缩小修改范围、补充约束、要求先解释原因、要求停止当前操作,或让 Agent 按新的要求继续。需要回退时,可以使用 /undo 回退最近的修改。

处理审批

桌面端会把需要你决定的操作显示为审批卡片。卡片可能包含命令、文件修改或计划等内容;阅读具体范围后再选择批准或拒绝。智能体提出问题时,问题卡片可能提供单选、多选和「其他」输入。

权限模式有三种:

  • 始终询问:仅自动读取,其余操作逐一向你确认。
  • 必要时询问:自动完成常规修改和命令;高危操作、提问和计划仍会问你。
  • 完全自动:完全不打断,所有操作和判断自动完成。

首次使用或处理不熟悉的项目时,建议先使用 始终询问,确认操作范围后再调整模式。

查看改动并验证

修改完成后,在右侧查看改动,先检查文件列表或树视图,再按文件和单次修改查看具体变化。需要进一步确认时,可以在文件预览中检查 Markdown、JSON、HTML、PDF、CSV、图片以及代码或文本文件,并复制、下载、在系统中显示或在外部应用中打开。

如果任务需要运行检查,可通过会话右上角的终端按钮打开底部终端面板,确认命令、当前工作区和输出结果。验证无误后再继续下一步;如果结果不符合预期,可以回到会话中说明问题,或使用 /undo 回退最近的修改。

右侧改动面板中的文件差异
右侧改动面板按文件显示每次修改的具体差异。

下一步