拓冰网站定制 
kimi term子命令详解用 Toad 终端 UI 驾驭 Kimi Code CLI【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-clikimi term是 Kimi Code CLI 的图形化终端入口它以一条命令启动基于 Textual 的现代终端界面 Toad并通过 ACPAgent Client Protocol协议自动拉起后端的kimi acp服务器为你提供比默认 Shell 模式更丰富的输出渲染与界面布局。读完本文你将掌握kimi term的完整用法、参数透传规则、底层 ACP 通信原理以及 Python 3.14 的安装前提与常见故障排查方法。一、kimi term是什么kimi term命令用于启动 Toad 终端 UI——一个基于 Textual 构建的现代终端图形界面。Toad 是 Kimi Code CLI 的图形化终端前端它通过 ACP 协议与 Kimi Code CLI 后端通信相比默认的 Shell 模式提供了更丰富的交互体验包括更好的输出渲染和界面布局。kimi term [OPTIONS]从命令行注册看kimi term被定义为cli.command(context_settings{allow_extra_args: True, ignore_unknown_options: True}) def term(ctx: typer.Context) - None: Run Toad TUI backed by Kimi Code CLI ACP server. from .toad import run_term run_term(ctx)见 src/kimi_cli/cli/init.py这里有两个关键点一是allow_extra_argsTrue与ignore_unknown_optionsTrue意味着kimi term本身不声明任何专属参数所有额外参数都会被收集到ctx.args中二是实际的启动逻辑全部集中在 src/kimi_cli/cli/toad.py 的run_term函数里。二、工作原理Toad ACP 的双进程架构运行kimi term时它会自动在后台启动一个kimi acp服务器Toad 作为 ACP 客户端连接到该服务器。整个调用链可以从 src/kimi_cli/cli/toad.py 的run_term函数还原def run_term(ctx: typer.Context) - None: extra_args list(ctx.args) acp_args _default_acp_command() acp_command shlex.join(acp_args) toad_parts _default_toad_command() args [*toad_parts, acp, acp_command] project_dir _extract_project_dir(extra_args) if project_dir is not None: args.append(str(project_dir)) result subprocess.run(args) if result.returncode ! 0: raise typer.Exit(coderesult.returncode)最终实际执行的进程命令大致为python -m toad.cli acp kimi可执行文件 acp [project_dir]即先由 Kimi Code CLI 解析参数再拉起toad.cli模块把kimi acp服务器命令作为参数交给 Toad由 Toad 以 ACP 客户端身份连接后端Toad 退出时run_term会透传其退出码非 0 则抛出typer.Exit。1. ACP 服务器命令的确定_default_acp_command()src/kimi_cli/cli/toad.py负责确定后端 ACP 服务器的启动方式def _default_acp_command() - list[str]: argv0 sys.argv[0] if argv0: resolved shutil.which(argv0) resolved_path Path(resolved).expanduser() if resolved else Path(argv0).expanduser() if ( resolved_path.exists() and resolved_path.suffix ! .py and not resolved_path.name.startswith((python, pypy)) ): return [str(resolved_path), acp] return [sys.executable, -m, kimi_cli.cli, acp]从源码可以推断其选择逻辑优先复用当前进程的可执行文件路径sys.argv[0]排除.py脚本和python/pypy开头的解释器以kimi acp形式启动否则回退为python -m kimi_cli.cli acp。kimi acp命令本身启动的是一个支持多会话的 ACP 服务器详见 kimi acp 子命令。2. Toad 依赖与 Python 版本检查_default_toad_command()src/kimi_cli/cli/toad.py在启动 Toad 前做两道检查def _default_toad_command() - list[str]: if sys.version_info (3, 14): typer.echo(kimi term requires Python 3.14 because Toad requires it., errTrue) raise typer.Exit(code1) if importlib.util.find_spec(toad) is None: typer.echo( Toad dependency is missing. Install kimi-cli with Python 3.14 to use kimi term., errTrue, ) raise typer.Exit(code1) return [sys.executable, -m, toad.cli]当前解释器版本低于Python 3.14时直接报错退出退出码 1并提示原因通过importlib.util.find_spec(toad)检查 Toad 模块是否存在缺失时提示需要用 Python 3.14 重新安装。这两条检查是kimi term最常见的报错来源详见下文系统要求与常见问题。三、选项与参数透传kimi term本身不解析选项所有额外的选项会原样透传给内部的kimi acp命令。例如kimi term --work-dir /path/to/project --model kimi-k2常用选项选项说明--work-dir PATH指定工作目录--model NAME指定模型--yolo自动批准所有工具调用完整选项kimi term透传的选项与主命令kimi完全一致完整列表请参阅 kimi 命令。以下是在kimi term场景下最常用的几类工作目录与范围--work-dir, -w PATH默认当前目录、--add-dir PATH可多次指定把工作目录之外的目录纳入工作区模型与推理--model, -m NAME覆盖配置文件默认模型、--thinking / --no-thinking会话管理--continue, -C、--session, --resume, -S, -r [ID]审批控制--yolo, -y自动批准所有工具调用、--afk无人值守模式自动批准并自动忽略提问计划模式--plan以计划模式启动AI 仅使用只读工具探索并编写实现计划配置--config STRING/--config-file PATHTOML/JSON 格式Agent 定制--agent NAME内置default/okabe、--agent-file PATH循环控制--max-steps-per-turn N、--max-retries-per-step N、--max-ralph-iterations N-1表示无限0表示关闭MCP 集成--mcp-config-file PATH、--mcp-config JSON均可多次指定。注意kimi term场景下请避免使用--print、--acp、--wire等冲突的 UI 模式选项它们与 Toad 前端的设计意图相悖。工作目录的提取与传递透传参数并非简单地全部交给 ACP 服务器src/kimi_cli/cli/toad.py 中的_extract_project_dir()会专门从额外参数中解析出--work-dir支持--work-dir PATH、--work-dirPATH、-w PATH、-wPATH等多种写法将其转为绝对路径后作为独立参数追加到 Toad 命令末尾def _extract_project_dir(extra_args: list[str]) - Path | None: work_dir: str | None None idx 0 while idx len(extra_args): arg extra_args[idx] if arg in (--work-dir, -w): if idx 1 len(extra_args): work_dir extra_args[idx 1] idx 2 continue elif arg.startswith(--work-dir) or arg.startswith(-w): work_dir arg.split(, 1)[1] elif arg.startswith(-w) and len(arg) 2: work_dir arg[2:] idx 1 if not work_dir: return None return Path(work_dir).expanduser().resolve()这个参数对 Toad 而言用于确定项目的初始打开目录未指定时kimi term不会追加任何目录参数。四、系统要求Python 3.14::: warning 注意kimi term需要 Python 3.14。如果你使用较低版本的 Python 安装了 Kimi Code CLI需要重新用 Python 3.14 安装才能使用此功能uv tool install --python 3.14 kimi-cli:::这一硬性要求来自 Toad 本身的运行条件且会在运行时被强制校验见上文_default_toad_command()的版本检查。如果你当前环境是 Python 3.13 或更低直接运行kimi term会得到明确的错误提示并退出而不是崩溃或产生不可预期的行为。五、底层协议ACP 与认证流程kimi term的价值建立在 ACPAgent Client Protocol之上。kimi acp命令启动一个支持多会话的 ACP 服务器详见 kimi acp 子命令ACP 是一种标准化协议允许 IDE 和其他客户端与 AI Agent 进行交互。Toad 正是通过这一协议与 Kimi Code CLI 后端通信的客户端之一。需要特别注意的是认证流程ACP 服务器在创建或加载会话前会检查用户认证状态。如果未登录服务器会返回AUTH_REQUIRED错误错误码-32000并携带可用的认证方式信息。Toad 收到该错误后会引导你在终端中执行kimi login完成登录该命令会打开浏览器授权后自动配置可用模型登录成功后后续的 ACP 请求即可正常执行。因此首次使用kimi term前建议先确认登录状态kimi login六、使用场景kimi term适合以下典型场景更友好的日常开发交互相比默认 Shell 模式Toad 提供更好的输出渲染与布局让长输出、工具调用过程和最终结果更容易阅读项目级 AI 编码会话结合--work-dir直接以项目根目录启动配合--model指定模型、--yolo全自动执行工具调用ACP 生态体验Toad 本身就是一个独立的 ACP 客户端通过它你可以直观感受 ACP 协议带来的多会话、结构化交互能力也是后续自行开发 ACP 客户端如 IDE 插件的参考样板。# 以当前目录启动 Toad kimi term # 在指定项目目录启动并切换模型 kimi term --work-dir ~/my-project --model kimi-k2 # 自动批准所有工具调用减少确认打断 kimi term --yolo # 组合使用指定目录 模型 自动批准 kimi term -w /path/to/project -m kimi-k2 -y七、常见问题排查结合 src/kimi_cli/cli/toad.py 的检查逻辑可对以下报错快速定位现象 / 报错信息原因解决办法kimi term requires Python 3.14 because Toad requires it.当前解释器低于 Python 3.14用 Python 3.14 重新安装uv tool install --python 3.14 kimi-cliToad dependency is missing. Install kimi-cli with Python 3.14 to use kimi term.环境中缺少toad模块同上用 Python 3.14 重装以附带 Toad 依赖ACP 会话请求返回AUTH_REQUIRED-32000尚未登录 Kimi 账号在终端执行kimi login完成 OAuth 授权kimi term退出码非 0Toad 进程异常退出观察 Toad 输出定位问题必要时用--debug查看日志从源码结构还可以推断kimi term通过subprocess.run同步等待 Toad 退出因此退出码会原样透传给外层脚本化使用时可直接依赖其返回值判断成功与否。结语kimi term是 Kimi Code CLI 在终端交互体验上的延伸——它把标准化的 ACP 协议、Textual 渲染与现代终端 UI 组合在一起。理解它的双进程架构Toad 前端 kimi acp后端、参数透传机制和 Python 3.14 前提能让你在需要图形化、更易读的终端 Agent 体验时一条命令即可上手。【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 `kimi term` 子命令详解：用 Toad 终端 UI 驾驭 Kimi Code CLI
kimi term子命令详解用 Toad 终端 UI 驾驭 Kimi Code CLI【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-clikimi term是 Kimi Code CLI 的图形化终端入口它以一条命令启动基于 Textual 的现代终端界面 Toad并通过 ACPAgent Client Protocol协议自动拉起后端的kimi acp服务器为你提供比默认 Shell 模式更丰富的输出渲染与界面布局。读完本文你将掌握kimi term的完整用法、参数透传规则、底层 ACP 通信原理以及 Python 3.14 的安装前提与常见故障排查方法。一、kimi term是什么kimi term命令用于启动 Toad 终端 UI——一个基于 Textual 构建的现代终端图形界面。Toad 是 Kimi Code CLI 的图形化终端前端它通过 ACP 协议与 Kimi Code CLI 后端通信相比默认的 Shell 模式提供了更丰富的交互体验包括更好的输出渲染和界面布局。kimi term [OPTIONS]从命令行注册看kimi term被定义为cli.command(context_settings{allow_extra_args: True, ignore_unknown_options: True}) def term(ctx: typer.Context) - None: Run Toad TUI backed by Kimi Code CLI ACP server. from .toad import run_term run_term(ctx)见 src/kimi_cli/cli/init.py这里有两个关键点一是allow_extra_argsTrue与ignore_unknown_optionsTrue意味着kimi term本身不声明任何专属参数所有额外参数都会被收集到ctx.args中二是实际的启动逻辑全部集中在 src/kimi_cli/cli/toad.py 的run_term函数里。二、工作原理Toad ACP 的双进程架构运行kimi term时它会自动在后台启动一个kimi acp服务器Toad 作为 ACP 客户端连接到该服务器。整个调用链可以从 src/kimi_cli/cli/toad.py 的run_term函数还原def run_term(ctx: typer.Context) - None: extra_args list(ctx.args) acp_args _default_acp_command() acp_command shlex.join(acp_args) toad_parts _default_toad_command() args [*toad_parts, acp, acp_command] project_dir _extract_project_dir(extra_args) if project_dir is not None: args.append(str(project_dir)) result subprocess.run(args) if result.returncode ! 0: raise typer.Exit(coderesult.returncode)最终实际执行的进程命令大致为python -m toad.cli acp kimi可执行文件 acp [project_dir]即先由 Kimi Code CLI 解析参数再拉起toad.cli模块把kimi acp服务器命令作为参数交给 Toad由 Toad 以 ACP 客户端身份连接后端Toad 退出时run_term会透传其退出码非 0 则抛出typer.Exit。1. ACP 服务器命令的确定_default_acp_command()src/kimi_cli/cli/toad.py负责确定后端 ACP 服务器的启动方式def _default_acp_command() - list[str]: argv0 sys.argv[0] if argv0: resolved shutil.which(argv0) resolved_path Path(resolved).expanduser() if resolved else Path(argv0).expanduser() if ( resolved_path.exists() and resolved_path.suffix ! .py and not resolved_path.name.startswith((python, pypy)) ): return [str(resolved_path), acp] return [sys.executable, -m, kimi_cli.cli, acp]从源码可以推断其选择逻辑优先复用当前进程的可执行文件路径sys.argv[0]排除.py脚本和python/pypy开头的解释器以kimi acp形式启动否则回退为python -m kimi_cli.cli acp。kimi acp命令本身启动的是一个支持多会话的 ACP 服务器详见 kimi acp 子命令。2. Toad 依赖与 Python 版本检查_default_toad_command()src/kimi_cli/cli/toad.py在启动 Toad 前做两道检查def _default_toad_command() - list[str]: if sys.version_info (3, 14): typer.echo(kimi term requires Python 3.14 because Toad requires it., errTrue) raise typer.Exit(code1) if importlib.util.find_spec(toad) is None: typer.echo( Toad dependency is missing. Install kimi-cli with Python 3.14 to use kimi term., errTrue, ) raise typer.Exit(code1) return [sys.executable, -m, toad.cli]当前解释器版本低于Python 3.14时直接报错退出退出码 1并提示原因通过importlib.util.find_spec(toad)检查 Toad 模块是否存在缺失时提示需要用 Python 3.14 重新安装。这两条检查是kimi term最常见的报错来源详见下文系统要求与常见问题。三、选项与参数透传kimi term本身不解析选项所有额外的选项会原样透传给内部的kimi acp命令。例如kimi term --work-dir /path/to/project --model kimi-k2常用选项选项说明--work-dir PATH指定工作目录--model NAME指定模型--yolo自动批准所有工具调用完整选项kimi term透传的选项与主命令kimi完全一致完整列表请参阅 kimi 命令。以下是在kimi term场景下最常用的几类工作目录与范围--work-dir, -w PATH默认当前目录、--add-dir PATH可多次指定把工作目录之外的目录纳入工作区模型与推理--model, -m NAME覆盖配置文件默认模型、--thinking / --no-thinking会话管理--continue, -C、--session, --resume, -S, -r [ID]审批控制--yolo, -y自动批准所有工具调用、--afk无人值守模式自动批准并自动忽略提问计划模式--plan以计划模式启动AI 仅使用只读工具探索并编写实现计划配置--config STRING/--config-file PATHTOML/JSON 格式Agent 定制--agent NAME内置default/okabe、--agent-file PATH循环控制--max-steps-per-turn N、--max-retries-per-step N、--max-ralph-iterations N-1表示无限0表示关闭MCP 集成--mcp-config-file PATH、--mcp-config JSON均可多次指定。注意kimi term场景下请避免使用--print、--acp、--wire等冲突的 UI 模式选项它们与 Toad 前端的设计意图相悖。工作目录的提取与传递透传参数并非简单地全部交给 ACP 服务器src/kimi_cli/cli/toad.py 中的_extract_project_dir()会专门从额外参数中解析出--work-dir支持--work-dir PATH、--work-dirPATH、-w PATH、-wPATH等多种写法将其转为绝对路径后作为独立参数追加到 Toad 命令末尾def _extract_project_dir(extra_args: list[str]) - Path | None: work_dir: str | None None idx 0 while idx len(extra_args): arg extra_args[idx] if arg in (--work-dir, -w): if idx 1 len(extra_args): work_dir extra_args[idx 1] idx 2 continue elif arg.startswith(--work-dir) or arg.startswith(-w): work_dir arg.split(, 1)[1] elif arg.startswith(-w) and len(arg) 2: work_dir arg[2:] idx 1 if not work_dir: return None return Path(work_dir).expanduser().resolve()这个参数对 Toad 而言用于确定项目的初始打开目录未指定时kimi term不会追加任何目录参数。四、系统要求Python 3.14::: warning 注意kimi term需要 Python 3.14。如果你使用较低版本的 Python 安装了 Kimi Code CLI需要重新用 Python 3.14 安装才能使用此功能uv tool install --python 3.14 kimi-cli:::这一硬性要求来自 Toad 本身的运行条件且会在运行时被强制校验见上文_default_toad_command()的版本检查。如果你当前环境是 Python 3.13 或更低直接运行kimi term会得到明确的错误提示并退出而不是崩溃或产生不可预期的行为。五、底层协议ACP 与认证流程kimi term的价值建立在 ACPAgent Client Protocol之上。kimi acp命令启动一个支持多会话的 ACP 服务器详见 kimi acp 子命令ACP 是一种标准化协议允许 IDE 和其他客户端与 AI Agent 进行交互。Toad 正是通过这一协议与 Kimi Code CLI 后端通信的客户端之一。需要特别注意的是认证流程ACP 服务器在创建或加载会话前会检查用户认证状态。如果未登录服务器会返回AUTH_REQUIRED错误错误码-32000并携带可用的认证方式信息。Toad 收到该错误后会引导你在终端中执行kimi login完成登录该命令会打开浏览器授权后自动配置可用模型登录成功后后续的 ACP 请求即可正常执行。因此首次使用kimi term前建议先确认登录状态kimi login六、使用场景kimi term适合以下典型场景更友好的日常开发交互相比默认 Shell 模式Toad 提供更好的输出渲染与布局让长输出、工具调用过程和最终结果更容易阅读项目级 AI 编码会话结合--work-dir直接以项目根目录启动配合--model指定模型、--yolo全自动执行工具调用ACP 生态体验Toad 本身就是一个独立的 ACP 客户端通过它你可以直观感受 ACP 协议带来的多会话、结构化交互能力也是后续自行开发 ACP 客户端如 IDE 插件的参考样板。# 以当前目录启动 Toad kimi term # 在指定项目目录启动并切换模型 kimi term --work-dir ~/my-project --model kimi-k2 # 自动批准所有工具调用减少确认打断 kimi term --yolo # 组合使用指定目录 模型 自动批准 kimi term -w /path/to/project -m kimi-k2 -y七、常见问题排查结合 src/kimi_cli/cli/toad.py 的检查逻辑可对以下报错快速定位现象 / 报错信息原因解决办法kimi term requires Python 3.14 because Toad requires it.当前解释器低于 Python 3.14用 Python 3.14 重新安装uv tool install --python 3.14 kimi-cliToad dependency is missing. Install kimi-cli with Python 3.14 to use kimi term.环境中缺少toad模块同上用 Python 3.14 重装以附带 Toad 依赖ACP 会话请求返回AUTH_REQUIRED-32000尚未登录 Kimi 账号在终端执行kimi login完成 OAuth 授权kimi term退出码非 0Toad 进程异常退出观察 Toad 输出定位问题必要时用--debug查看日志从源码结构还可以推断kimi term通过subprocess.run同步等待 Toad 退出因此退出码会原样透传给外层脚本化使用时可直接依赖其返回值判断成功与否。结语kimi term是 Kimi Code CLI 在终端交互体验上的延伸——它把标准化的 ACP 协议、Textual 渲染与现代终端 UI 组合在一起。理解它的双进程架构Toad 前端 kimi acp后端、参数透传机制和 Python 3.14 前提能让你在需要图形化、更易读的终端 Agent 体验时一条命令即可上手。【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考