Skip to content

从 kimi-cli 迁移

INFO

Kimi Code CLI 已完成重大版本升级,底层从 Python/uv 迁移至 Node.js,带来更简单的安装方式、更快的启动速度和全新的终端界面。旧版将逐渐停止维护,建议尽快升级至新版。 本文档正在重建中,新版功能细节暂请移步 Kimi Code CLI 文档站

如果你正在从旧版迁移,按照以下步骤操作——一条命令就能把配置、MCP server 与会话历史一并迁移至新版。

新版优势

  • 不再依赖 Python / uv:基于 Node.js 重写,无需配置 Python 环境,安装更简单
  • 原生二进制,开箱即用:启动更快,运行更轻量
  • 终端界面全面重设计:交互体验更流畅
  • 数据可完整迁移:配置、MCP、会话历史一键带走,无缝延续

如何迁移

迁移有两种方式。

装好 kimi-code 之后第一次运行 kimi 时,它会自动检测 ~/.kimi/ 下是否存在 kimi-cli 的数据。一旦检测到,就会弹出迁移提示,你可以选择立即迁移、稍后再说,或不再提示。

你也可以随时手动运行

sh
kimi migrate

你可以选择是否同时迁移聊天会话。如果暂时不需要历史记录,选 Config only;否则选 Config + N sessions 一并迁移。结束后会显示结果摘要。

迁移会发生什么

会被迁移的内容:配置(config.toml)、MCP 服务配置、输入历史,以及你选择迁移的聊天会话。

不会被迁移的内容:OAuth 登录凭证和 MCP 服务的授权都不会被复制,迁移后需要在 kimi-code 里重新执行 /login 和重新授权 MCP 服务。kimi-cli 的插件也不在迁移范围内。

提示

迁移不会改动或删除 ~/.kimi/ 下的任何旧数据。kimi-cli 仍可照常使用,两者互不影响。迁移也可以重复运行,已经迁移过的会话不会被重复导入。

迁移完成后,从 kimi-cli 导入的会话会带上 [imported] 标记,方便你与新建的会话区分。