kha 是与控制台和 API 并列的托管智能体使用入口，具备与两者相同的资源管理和会话操作能力。安装后，你可以在 Kimi Code、Claude Code、Codex 等 AI 编程助手中用自然语言创建和配置智能体（Agent）与执行环境（Environment），创建会话（Session），提交和继续任务，查看执行状态并获取产物（Artifact）。
安装与认证
开始前，准备具有托管智能体访问权限的 API Key。安装 kha CLI
在终端运行一键安装脚本：- macOS / Linux
- Windows (PowerShell)
~/.local/bin；设置 KHA_INSTALL_DIR 可更换目录，设置 KHA_VERSION=0.X.Y 可安装指定版本（默认最新稳定版）。安装 kha 技能包
在 AI 编程助手中配合使用时，需要安装 kha 技能包，助手才能按内置的最佳实践调用 CLI。技能包随 CLI 分发、无需联网下载：--dir。安装完成后，按客户端要求刷新或新开一个会话，确认技能已加载。如需直接使用 CLI 管理资源，请查看 查询 CLI 命令用法。
升级 kha CLI
CLI 每天会自动检查一次新版本，发现落后时在 stderr 给出提示，不影响命令输出；设置KHA_NO_UPDATE_CHECK=1 可关闭检查，CI 环境中自动跳过。手动升级运行：
配置认证
在 Kimi 开放平台 创建 API Key，然后在本地终端运行：kha login --api-key-stdin，从标准输入读取。
API Key 只在本地终端中输入，不要写入命令参数，也不要粘贴到 AI 编程助手的对话中。
login 只保存凭据，whoami 才会访问 API 并验证身份：
KIMI_API_KEY，CLI 也可以直接使用。需要管理多个账号或环境时，可以用 profile 分别保存配置：
用自然语言完成第一个任务
在 AI 编程助手中发送：- 检查现有智能体和执行环境的配置，没有合适资源时再创建；
- 等待执行环境状态变为
ready； - 创建会话，发送销售数据和统计要求；
- 检查任务回答与产物，确认结果完整；
- 下载
sales-report.md，返回主要结论、会话 ID 和本地文件路径。
常见管理场景
以下示例可直接作为对 AI 编程助手的指令，资源名称、ID 和文件路径应替换为实际值。
凭据库和记忆库需要在创建会话时绑定。更新智能体后，应创建新会话验证，因为已有会话仍使用创建时绑定的智能体版本。触发器显示初始事件已被接受后，还要检查对应会话的回答和产物。
与控制台和 API 配合
通过 kha CLI 创建的智能体、会话和产物都可以在控制台和 API 中继续操作。你可以在 AI 编程助手中继续输入自然语言指令，在 控制台 中继续会话，或通过 API 继续发送消息、查看事件和取消当前轮次。 控制台适合可视化配置、OAuth 授权、运行观测和产物检查；API 适合将后续操作集成到自己的系统。首条任务消息可以直接通过 kha CLI 发送，无需打开控制台。故障排查
查询 CLI 命令用法
不使用 AI 编程助手时，也可以直接用 kha CLI 管理资源。运行以下命令查看与本机 CLI 版本一致的完整命令参考：kha docs <资源> <命令> 逐级查看。
请求体输入方式
直接用 CLI 创建或更新资源时，有两种方式传入请求参数：- 字段选项：顶层标量字段用命令选项传入，例如
kha sessions create --agent "$AGENT_ID" --environment "$ENVIRONMENT_ID" --title "周报"。 - 完整请求体：嵌套结构（如
resources、tools、mcp_servers、metadata）用--file整体传入，支持 JSON 或 YAML，--file -表示从标准输入读取。
--file 时不能再带字段选项。请求体字段与 REST API 契约一致，因此文档中 cURL 示例的 JSON body 可以直接交给 --file；同样的内容也可以写成 YAML：
--text-file、--payload-file、--content-file 等选项按字面文本读入，不做结构化解析。
下一步
管理运行中的会话
查看会话状态、待处理输入和当前轮次的取消方式。
在控制台中继续操作
在网页上配置资源、观测运行并检查产物。