---
url: /kimi-cli/zh/guides/getting-started.md
---
# 开始使用

::: danger 警告
**本项目已归档**。Kimi CLI 已停止维护，不再提供任何更新和安全修复，旧版将无法继续使用。请改为安装 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)，详见 [迁移指南](https://moonshotai.github.io/kimi-code/zh/guides/migration)。
:::

## Kimi Code CLI 是什么

Kimi Code CLI 是一个运行在终端中的 AI Agent，帮助你完成软件开发任务和终端操作。它可以阅读和编辑代码、执行 Shell 命令、搜索和抓取网页，并在执行过程中自主规划和调整行动。

Kimi Code CLI 适合以下场景：

* **编写和修改代码**：实现新功能、修复 bug、重构代码
* **理解项目**：探索陌生的代码库，解答架构和实现问题
* **自动化任务**：批量处理文件、执行构建和测试、运行脚本

Kimi Code CLI 支持以下几种使用方式：

* **[交互式命令行（`kimi`）](../reference/kimi-command.md)**：在终端中以 Shell 方式与 AI 对话，支持自然语言描述任务或直接执行 Shell 命令
* **[浏览器界面（`kimi web`）](../reference/kimi-web.md)**：在本地浏览器中打开图形界面，支持会话管理、文件引用、代码高亮等
* **[Agent 集成（`kimi acp`）](../reference/kimi-acp.md)**：以服务方式运行，通过 [Agent Client Protocol] 集成到 [IDE](./ides.md) 和其他本地 Agent 客户端中

::: info 提示
如果你遇到问题或有建议，欢迎在 [GitHub Issues](https://github.com/MoonshotAI/kimi-cli/issues) 反馈。
:::

[Agent Client Protocol]: https://agentclientprotocol.com/

## 安装

Kimi CLI 已归档，不应再安装。请改为安装 [Kimi Code CLI](https://github.com/MoonshotAI/kimi-code)：

```sh
# Linux / macOS
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```

```powershell
# Windows (PowerShell)
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```

如果你之前使用过 Kimi CLI，Kimi Code CLI 首次启动时会提示迁移配置、MCP 服务与会话，你也可以随时运行 `kimi migrate`。详见 [迁移指南](https://moonshotai.github.io/kimi-code/zh/guides/migration)。

## 卸载

迁移到 Kimi Code CLI 后，卸载 Kimi CLI：

```sh
uv tool uninstall kimi-cli
```

## 第一次运行

在你想要工作的项目目录中运行 `kimi` 命令启动 Kimi Code CLI：

```sh
cd your-project
kimi
```

首次启动时，你需要配置 API 来源。输入 `/login` 命令开始配置：

```
/login
```

执行后首先选择平台。推荐选择 **Kimi Code**，会自动打开浏览器进行 OAuth 授权；选择其他平台则需要输入 API 密钥。配置完成后 Kimi Code CLI 会自动保存设置并重新加载。详见 [平台与模型](../configuration/providers.md)。

现在你可以直接用自然语言和 Kimi Code CLI 对话了。试着描述你想完成的任务，比如：

```
帮我看一下这个项目的目录结构
```

::: tip 提示
如果项目中没有 `AGENTS.md` 文件，可以运行 `/init` 命令让 Kimi Code CLI 分析项目并生成该文件，帮助 AI 更好地理解项目结构和规范。
:::

输入 `/help` 可以查看所有可用的 [斜杠命令](../reference/slash-commands.md) 和使用提示。