Kilo Code CLI 安装指南：npm 全局安装、旧 CPU 兼容与安装验证-开发者社区

Kilo Code CLI 安装指南：npm 全局安装、旧 CPU 兼容与安装验证

【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode

Kilo Code 提供了与 VS Code / JetBrains 插件同源能力的终端命令行工具（TUI），可以直接在终端中完成规划、调试与编码。本文基于仓库文档 install-cli.md 展开，完整讲解三种安装/兼容场景：npm 全局安装、无 AVX 指令集旧 CPU 的 baseline 变体安装，以及安装后的版本验证；并结合仓库启动脚本源码，解释 Kilo CLI 二进制分发与 AVX 检测的底层机制，帮助你一次性装好、装对。

使用场景：谁需要这份安装指南

Kilo Code CLI（npm 包名@kilocode/cli，命令kilo）是 Kilo 官方发布的开源命令行入口，源码位于仓库 packages/opencode，构建产物通过bin字段同时注册kilo与kilocode两个命令（见 packages/opencode/package.json）。以下三类用户都需要阅读本文：

习惯键盘优先、希望在终端内完成 agentic 编码任务的开发者；
CI/CD 流水线中需要以非交互方式运行 AI 编码任务的团队；
使用较老 CPU（不支持 AVX 指令集）的服务器或工作站用户——这是最容易踩坑的场景。

第一步：通过 npm 全局安装

Kilo Code CLI 已发布到 npm registry，全局安装命令非常简单：

npm install -g @kilocode/cli

安装完成后，终端中即可直接使用kilo命令。从源码看，packages/opencode/package.json 中声明了"bin": { "kilo": "./bin/kilo", "kilocode": "./bin/kilo" }，因此kilocode也可以作为别名使用。

安装背后的平台二进制选择机制

@kilocode/cli是一个分平台分发的包。入口脚本 packages/opencode/bin/kilo 会根据操作系统与 CPU 架构，在node_modules中寻找对应平台的二进制包（形如@kilocode/cli-<platform>-<arch>，例如 Linux x64 对应@kilocode/cli-linux-x64），找到后以子进程方式启动它并转发信号。这意味着：

npm 安装会按你的平台自动拉取对应二进制，无需手动指定；
如果某个平台包缺失，入口脚本会给出明确的报错提示，并列出应当手动安装的候选包名；
Windows 平台实际运行的是kilo.exe，其余平台是kilo可执行文件。

除了操作系统与架构，入口脚本还会额外探测两件事：CPU 是否支持 AVX2 指令集，以及Linux 环境是否为 musl libc（如 Alpine Linux），以此决定优先选择哪个变体包，详见下文。

第二步：旧 CPU（无 AVX 支持）如何处理

现象与原因

如果你运行在较老的 CPU 上——例如 Intel Xeon Nehalem、AMD Bulldozer 或更早的处理器——启动 CLI 时可能会崩溃并报Illegal instruction（非法指令）错误。

根因可以从启动脚本源码 packages/opencode/bin/kilo 中找到：脚本中的supportsAvx2()会检测 CPU 是否支持 AVX2 指令集（Linux 读取/proc/cpuinfo中的avx2标志，macOS 调用sysctl hw.optional.avx2_0，Windows 调用内置检测模块）。当架构为 x64 且不支持 AVX2时，会标记为baseline状态，优先寻找-baseline后缀的包；而默认（非 baseline）二进制针对现代 CPU 编译，包含 AVX 相关指令，在旧 CPU 上无法执行，从而触发Illegal instruction。

解决方案：下载 baseline 变体

遇到上述崩溃时，请从 GitHub Releases 页面下载-baseline变体（Kilo Releases 页面由 install-cli.md 文档指定，仓库不托管发行包）：

打开 Kilo Releases 发布页；
按你的平台下载对应的-baseline变体文件：
- Linux x64：kilo-linux-x64-baseline.tar.gz
- macOS x64：kilo-darwin-x64-baseline.zip
- Windows x64：kilo-windows-x64-baseline.zip
解压后直接运行其中的kilo二进制文件即可。

baseline 之外的变体细节（仓库源码依据）

对照 packages/opencode/bin/kilo 中的candidates()逻辑，还可以确认两点额外细节：

Linux musl 场景：在 Alpine 等使用 musl libc 的系统上，脚本通过检查/etc/alpine-release或ldd --version输出识别 musl，并优先查找带-musl后缀的包。baseline 与 musl 两种标记可以组合（例如@kilocode/cli-linux-x64-baseline-musl），即旧 CPU 上的 Alpine Linux 需要同时满足两个条件的变体。
自动回退策略：npm 安装时脚本会按优先级依次尝试候选包（如 baseline 系统上依次尝试-baseline、默认包、-baseline-musl、-musl），并会回退到缓存二进制。因此绝大多数情况下无需手动干预。

第三步：验证安装

安装（或手动解压）完成后，运行版本检查命令确认一切正常：

kilo --version

该命令会输出当前安装的 Kilo CLI 版本号。仓库的 Nix 打包配方 nix/kilo.nix 中也使用versionCheckProgramArg = "--version"作为安装检查的标准参数，可见kilo --version是官方认可的安装校验方式。

安装之后的快速上手

启动与首次配置

验证通过后，切换到你的工作目录并启动：

# 启动 TUI 交互界面 kilo # 查看帮助 kilo --help

首次运行建议使用/connect命令添加第一个模型提供商的 API 凭据——这是文档 Kilo Code CLI 平台页指定的新用户入口。也可以在任意工作目录中直接运行kilo启动交互式会话。

升级与卸载

升级 CLI 有两种方式：

# 方式一：CLI 内置命令 kilo upgrade # 方式二：npm 全局更新 npm update -g @kilocode/cli

如需彻底卸载，可运行kilo uninstall（命令列表见 cli-commands-table.md）。

常用命令一览

安装后可用的顶层命令包括（完整列表见 cli-commands-table.md）：

命令	说明
`kilo [project]`	启动 Kilo TUI
`kilo run [message..]`	以指定消息运行（配合`--auto`可用于 CI）
`kilo auth`	管理 AI 提供商与凭据
`kilo models [provider]`	列出所有可用模型
`kilo upgrade [target]`	升级到最新或指定版本
`kilo completion`	生成 shell 补全脚本

配置文件位置

CLI 配置通过~/.config/kilo/下的文件管理：kilo.jsonc用于提供商、模型、权限与 MCP 设置，tui.jsonc用于终端 UI（通知、主题、按键绑定）设置。项目级配置放在./kilo.json[c]或./.kilo/目录中，项目配置优先级高于全局配置。编辑配置文件后需重启 CLI 生效。