首次启动
Kiki 已经装好了。这一页带你走完最初的十分钟：在项目目录里启动、连上模型、拿到第一个有用的回答。
启动 Kiki
进入你的项目目录并运行 kiki，启动交互式界面：
cd your-project
kiki如果你在源码检出里开发，请在仓库根目录运行 pnpm dev:cli。要在不进入交互界面的情况下执行单条指令，使用 -p（prompt 模式）：
kiki -p "Take a look at this project's directory structure"加上 -c（--continue 的短写）即可恢复上一次会话；它与 --session 等恢复方式的区别见工作区与会话管理：
kiki -c连接模型
Kiki 需要先连上一个模型才能开始回答。在交互界面输入 /login：
/login弹出的选择器提供四个选项：
- Kimi Code (kimi.com/code) —— 托管订阅，走设备码授权：在任意设备上打开链接、登录、输入授权码
- Kimi Code (kimi.ai/code) —— 同一套流程，对应国际站端点
- Kimi Platform (API key · platform.kimi.com) —— 填入国内平台控制台的 API 密钥
- Kimi Platform (API key · platform.kimi.ai) —— 填入国际平台控制台的 API 密钥
输入 /logout 可以清除当前凭据。
如果不用终端，桌面应用和浏览器界面首次启动时会打开一个欢迎向导，同样是三步：
- Kiki 能帮你做什么 —— 四种用途各一行，名字和后面的导览路线一致：「先做一件事」「看懂与指挥工作」「让工作持续」「按需扩展 Kiki」。语言是标题旁的一个小开关；主题、配色和背景图收在下方的 外观 一行里，展开后每选一项，弹窗后面的窗口会即时预览。
- 你希望 Kiki 怎么帮你 —— 选择默认权限模式、离开时是否接收任务完成通知，以及简短或详细的回复方式。推荐「自动」，「替我审批」收在「更多」里。说话方式修改共享
system.reply_style系统提示词段落，不写入记忆。重新进入引导会读取已保存的段落，没有选择或保存改动时保留已有自定义原文。可在这里或 设置 → 智能体 → 提示词字段 中编辑，保留${reply_style_guide}。它供后续轮次使用，单独的 Agent 或模型提示词设置可以覆盖它。任务失败、提问和审批请求仍会通知你，不受任务完成通知开关影响。 - 出发 —— 去设置连接模型，把
kiki-ops帮助 Skill 装进你已经在用的 Agent，或展开「先逛逛」选择导览。安装 Skill 会先展示目标位置和是否覆盖已有文件，再由你确认。五条导览包括完整概览和四种按兴趣选择的起点；点一条就开始侧栏「发现 Kiki」共用的导览，并关闭引导。
第 1 步只有「下一步」。配合方式这一步的「下一步」或「稍后配置」会先保存你明确选择的权限模式，再继续；通知和说话方式在选择时就保存。保存失败会显示在原处，说话方式没存成也可以继续。「关闭引导」结束这一轮，不开始导览；设置中的 重新进入引导 可以再次打开，并沿用已保存的偏好。
向导把模型配置交给设置页，不自行写入提供商凭据。没有可用模型时，新会话页也提供 使用账号登录（Kimi Code、GitHub Copilot 或 ChatGPT（Codex）账号）和 填写 API 密钥或本地服务，分别打开 设置 → 模型与提供商 对应的那一栏。模板按厂商、网关和本地服务分组；测试连接 只校验表单，不保存。在服务与账号中展开连接，在它的模型列表里给想用的模型加星标，新会话就会优先使用它。
欢迎消息发送时使用你选择的模型和思考强度。还没配置模型时，可以在输入框的模型选择器里选择模型或连接提供商，草稿会保留；选好后重发同一条欢迎请求。开始导览或关闭引导都不会发送提示词，起步建议也只是准备草稿。
向导不问你用哪个文件夹。新会话页默认使用最近的工作区，没有时在 Kiki 主目录下新建一个文件夹。之后也能用 /kiki-ops 请求设置帮助；模型选择方式见 Agent 与 subagent。
之后也可以从侧栏的 发现 Kiki 打开这些路线。每一站都能尝试真实页面中的操作，或查看明确标注的本地示例。离开后会保留位置，点 继续看 即可返回。导览本身不调用模型，也不创建示例会话；建议的提示词只是草稿，由你确认后再发送。
需要用真实任务上手时，新建会话并用 /kiki-ops 请 Kiki 带你开始。内置引导会问你最想完成什么，然后带你真做一次——配好这一步需要的能力，保留已经能用的设置。你先检查草稿，再自己按发送。
Explore（只读探索）这类 subagent 的默认模型和思考强度，只有任务需要先查清资料时才一起选择——包括项目文件和需要核对的外部来源。第一份智能体配置同样只在手上的活缺这个角色时才提出，并说明原因；科研、写作、办公就配对应的角色，不必是工程那两个。之后也能随时用 /kiki-ops 请求这些配置；模型选择方式见 Agent 与 subagent。
你的第一次对话
登录后，用自然语言描述你想要什么。先让 Kiki 熟悉一下项目是个不错的起点：
Take a look at this project's directory structure and briefly describe what each directory is for.Kiki 通过工具（Agent 可调用的内置能力，例如读文件、搜索代码、运行命令）来回答，所以它会先看你的项目再作答，而不是凭空猜测。只读调用不会中途停下来问你。
新会话默认使用 Auto 模式：普通工具调用（包括 Shell 命令）直接执行，访问 .env、私钥等敏感文件前会先请求你的审批。用 /permission 可切换到 manual、auto、review（「替我审批」，先交给你配置的审查者判断）或 yolo；各模式分别会问什么，见权限模式。
你也可以跳过这一步，直接给一个具体任务：
Add a function in src/utils that converts any string to kebab-case, and add a unit test for it.Kiki 会规划步骤、修改代码、运行测试，并在每一步告诉你它做了什么。
不知道该做什么？输入 /help
随时输入 /help 打开内置命令和快捷键面板。用 ↑/↓ 浏览，Esc 关闭。退出可以输入 /exit、空闲时连按两次 Ctrl-C，或在输入框为空时按 Ctrl-D。
现在就该记住的命令与快捷键
如果这一页你只记住一段内容，就记住下面这些：
会话命令
| 命令 | 说明 |
|---|---|
/new | 新建会话，清空当前上下文 |
/sessions | 浏览会话历史并选择恢复 |
/model | 切换当前模型 |
/compact | 手动压缩上下文以释放 token（token 是模型计量文本的基本单位，一段话由多少 token 决定能装进多少上下文） |
/fork | 将当前会话分叉为带完整历史的独立副本（你仍留在当前会话） |
最常用快捷键
| 快捷键 | 说明 |
|---|---|
Esc | 中断流式输出（内容逐段实时显示的方式）/ 关闭弹窗 |
Ctrl-C | 中断输出；空闲时按两次退出 |
Shift-Tab | 切换 Plan 模式 |
Ctrl-S | 在流式输出中途注入消息，无需等待当前响应结束 |
Ctrl-O | 折叠 / 展开工具输出与压缩摘要（上下文压缩时自动生成的历史摘要） |
完整列表输入 /help 查看，或访问斜杠命令和键盘快捷键。
数据存储在哪里
Kiki 的本地数据默认放在 ~/.kiki/：配置文件、会话记录、日志和更新缓存。设置 KIKI_HOME 环境变量即可整体换到别的位置。一个例外：未设置 KIKI_HOME 时，桌面应用会从兼容家目录 ~/.kimi-code/ 读取 OAuth 凭据。全部路径和各自存放的内容见数据路径。