🤖 AI 跟我学 新手入门

Kimi Code CLI 怎么用？5 分钟跑通第一行命令

Kimi Code CLI 怎么用？月之暗面的国产 AI 编程命令行，国内直连不用代理。本文按安装、登录、首个项目、3 种使用模式、常见错的顺序保姆级走一遍

发布 2026/04/21 📎 参考官方文档

30 秒了解：Kimi Code CLI 是什么、为什么国内开发者该试

Kimi Code CLI 是月之暗面（Moonshot）官方出的命令行 AI 编程工具，对标 Claude Code，但跑在国内服务器、用 Kimi K2 模型、不需要任何代理。 装好登一下账号，在终端里用中文说话就能让它读代码、改文件、跑命令、提 PR——你能想到的一切「让 AI 干工程师的活」都在终端里完成。

对国内开发者来说它是少数能直连、有月之暗面会员或 API key 就能用、长上下文表现不错的国产 AI 编程 CLI。这篇按官方 getting-started 文档把安装、登录、第一次使用、3 种模式、最常见错全部走一遍。

如果你还想多了解 Kimi Code 这个产品本身，先看 Kimi Code 是什么 再回来。

准备工作：3 件事

1. 账号：你有月之暗面账号或 API key 吗

Kimi Code CLI 跑起来要授权。两种方式：

  • Kimi 会员：在 kimi.com 注册一个账号、买会员（按月或按用量），CLI 直接用账号登
  • Kimi 开放平台 API key：去 platform.moonshot.cn 申请 key，sk-... 开头

完全没用过 Kimi 先看 Kimi 注册教程。

2. Python：必须 3.12-3.14

Kimi Code CLI 是 Python 包，跑前先确认你机器上的 Python 版本：

python3 --version

输出 3.12.x、3.13.x、3.14.x 都行。3.13 是官方推荐（兼容性最好）。低于 3.12 或没装 Python 先去 python.org 装。

3. 系统：macOS、Linux、Windows 都支持

  • Mac：Terminal、iTerm2、Ghostty 任意
  • Linux：bash / zsh / fish 任意
  • Windows：用 PowerShell（不要用旧版 cmd）

第 1 步：装 uv（Python 包管理器）

Kimi Code CLI 推荐用 uv 安装。uv 是 Python 生态新出的极快包管理器，比 pip 快 10-100 倍。

Mac / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

irm https://astral.sh/uv/install.ps1 | iex

装完关掉当前终端、开个新窗口，跑：

uv --version

看到版本号就 OK。

第 2 步：用 uv 装 Kimi Code CLI

uv tool install kimi-code

uv 会自动建一个独立 Python 环境装 kimi-code，跟你系统 Python 互不干扰。装完跑：

kimi --help

看到命令帮助就装好了。

macOS 启动慢怎么办

第一次跑 kimi 可能要等 5-10 秒——Mac 的 Gatekeeper 在做安全检查。给终端 App 加权限能改善：

打开 系统设置 → 隐私与安全性 → 开发者工具，把你的 Terminal / iTerm2 / Ghostty 拖进去打勾，下次启动就秒开。

第 3 步：进项目目录启动

cd ~/projects/你的项目
kimi

第一次启动会进入交互式界面，让你登录。

第 4 步：登录 /login

在 CLI 里输入：

/login

会让你选登录平台：

选项适合
Kimi 主站（kimi.com）个人用户、有月之暗面会员
Kimi 开放平台（platform.moonshot.cn）开发者、按 token 计费

选完会弹出浏览器走 OAuth 授权。登完回到 CLI，看到 Logged in as ... 就 OK。

远程服务器登录（没图形界面）

SSH 上去的远程机器，浏览器开不起来。/login 会自动切到手动流程：终端打印一段 URL，你复制到本地浏览器打开、登录、把回调里的 token 粘回终端就行。

直接配 API key

如果你想跳过 OAuth、用 API key 走：

# Mac / Linux 加进 ~/.zshrc 或 ~/.bashrc
export KIMI_API_KEY=sk-...
export KIMI_BASE_URL=https://api.moonshot.cn/v1   # 或者 api.kimi.com/coding/v1

# Windows PowerShell
$env:KIMI_API_KEY = "sk-..."

注意：API Key 和 Base URL 必须同一个平台——Kimi Code 用 api.kimi.com/coding/v1，Kimi 开放平台用 api.moonshot.cn/v1，两个交叉会认证失败。

第 5 步：跑 /init 生成 AGENTS.md

登录完做的第一件事：

/init

它会扫描你的项目，生成一份 AGENTS.md——相当于 Claude Code 的 CLAUDE.md，作为「项目持久记忆」。每次启动 Kimi Code CLI 会自动读。

你要做的：

  1. 通读它写的草稿
  2. 删它猜错的、加它不知道的（项目约定、不要碰的目录、commit message 格式）
  3. 保存、commit 到 git

写法跟 CLAUDE.md 怎么写 那篇基本通用——AGENTS.md 思路是一样的：短、信号密度高、200 行以内。

3 种使用模式

Kimi Code 不只是终端 CLI，还有 2 个模式：

模式启动命令用途
终端 CLIkimi日常开发对话，最常用
浏览器界面kimi web想要 GUI 体验时
IDE 集成（ACP）kimi acp集成进 VS Code 等 IDE

ACP 是 Anysphere 推的协议（Agent Communication Protocol），支持的 IDE 装上后能在编辑器里直接调 Kimi Code 干活。

第一次对话：3 步示范

进到 kimi 后，直接用中文说话。第一次试这 3 步：

第 1 步：让它认识项目

📋 Prompt 模板 
你好。这是这个项目的第一次 Kimi Code 会话。
在动手改文件之前，请先：
    

  1. 列出项目根目录的结构（前两层就行）
    2. 

  2. 找 README.md / package.json / pyproject.toml，告诉我这是个什么项目、用什么语言和框架
    3. 

  3. 找 AGENTS.md 读一遍，用一句话总结你接收到的约定
    4. 

  4. 如果你能找到 build 或者 test 命令，跑一下告诉我当前是不是绿的
    5. 

做完这 4 件事就停，等我下一步指令。

它会按这 4 步走，输出项目摘要。

第 2 步：让它改一个小东西

挑一个你能验证的小任务试手。比如：

📋 Prompt 模板 
帮我看 README.md 里的安装步骤那段，把所有 npm 改成 pnpm。
要求：
    

  1. 改之前先把改动 diff 给我看
    2. 

  2. 我说 OK 你再保存文件
    3. 

  3. 改完用 git diff 验证一下，确认改对了
    4.

Kimi Code 会显示 diff、等你批准、再写文件。养成「先看 diff 再批」的习惯，跟 Claude Code 一样。

第 3 步：让它跑命令

跑 ls -la，告诉我有多少个隐藏文件

它会执行 shell 命令、看输出、给你结论。Kimi Code 默认会问你批准，跟它说 yes 就跑。

必备命令速查

命令作用
/login配置或切换 API source
/usage查看剩余配额
/help显示所有命令和快捷键
/init生成 AGENTS.md
Ctrl-J换行不提交（多行 prompt 用）
Ctrl-C 一次打断当前回答
Ctrl-C 两次 / Ctrl-D退出 CLI

任何时候忘了命令，输入 /help 一目了然。

升级和卸载

升级到最新版：

uv tool upgrade kimi-code

不想用了：

uv tool uninstall kimi-code

uv 卸载会清得很干净，不留垃圾。

5 个最常见的错怎么修

错误 1：装完 kimi: command not found

原因：uv 装完二进制的目录没加进 PATH。

解决：

# Mac / Linux
source ~/.zshrc   # 或 ~/.bashrc

# 还不行，新开终端窗口

uv 装的工具默认在 ~/.local/bin/，确认这个目录在你的 PATH 里。

错误 2：Python 3.12-3.14 required

uv 检测到当前 Python 版本不在支持范围。

解决：

# 用 uv 装一个对的版本
uv python install 3.13

# 然后重新装 kimi-code
uv tool install kimi-code --python 3.13

错误 3：/login 浏览器不弹

如果在远程服务器、容器里、或者 GUI 出问题，/login 会切手动流程。看终端输出的 URL，复制到本地能开浏览器的机器打开，登完把 token 粘回终端。

错误 4：认证失败 Authentication failed

最容易踩的坑：API Key 和 Base URL 不匹配。

# 看当前配置
echo $KIMI_API_KEY
echo $KIMI_BASE_URL

确认是不是同一个平台的：

API Key 来源配套 Base URL
Kimi 主站会员api.kimi.com/coding/v1
Kimi 开放平台api.moonshot.cn/v1

把不匹配的那个换掉、重启终端、再跑。

错误 5：/usage 显示 0 配额

两种可能：

  1. 个人会员到期了 → 去 kimi.com 续费
  2. 开放平台账户余额 0 → 去 platform.moonshot.cn 充值

Kimi Code CLI vs Claude Code 快速对比

维度Kimi Code CLIClaude Code
模型Kimi K2Claude Opus/Sonnet
国内可用直连，不需代理需要稳定海外网络
收费月之暗面会员或 API tokenClaude 订阅或 API token
持久记忆文件AGENTS.mdCLAUDE.md
MCP 支持部分支持完整支持
子 agent暂无有
长上下文长上下文是 Kimi 强项200K（部分 1M）

详细对比看 AI 写代码完全指南。

一个实战：让 Kimi Code 帮你写个发布脚本

假设你想给项目写一个 release.sh 自动化发布脚本：

📋 Prompt 模板 
任务：给当前项目写一个 release.sh 自动化发布脚本
需求：
    

  1. 先 git status 检查工作区是不是干净（有未 commit 改动就退出）
    2. 

  2. 跑测试 npm test（如果绿才继续，红就退出）
    3. 

  3. 跑构建 npm run build
    4. 

  4. 从 package.json 读当前版本号，自动 bump patch 版本（1.2.3 → 1.2.4）
    5. 

  5. 生成 git tag v1.2.4
    6. 

  6. 推送到 origin（包括 tag）
    7. 

  7. 输出「发布完成」和新版本号
    8. 

要求：
    

  • bash 写，加 set -euo pipefail
    • 

  • 每步开头 echo 当前在干啥
    • 

  • 任何步骤失败立刻退出并 echo 错误原因
    • 

  • 不要直接写文件，先把脚本贴给我审，我说 OK 再写
    • 

我说 OK 后保存为 scripts/release.sh，加可执行权限。

跑通这个能让你感受到 Kimi Code 完整工作流：理解需求、写代码、给你审、写文件、加权限。

下一步

常见问题

Q：Kimi Code CLI 在国内真的不用代理吗？ A：是。月之暗面的 API 部署在国内服务器，普通家庭宽带或办公网络都能直连。这是它对国内开发者最大的优势——比 Claude Code / Codex / Cursor 都省心。

Q：跟 Kimi 网页版的对话能共享吗？ A：不能。Kimi Code CLI 是独立产品，对话历史和上下文不跟网页版共通。但你可以把 AGENTS.md 内容同时贴到 Kimi 网页版的对话当 system context 用。

Q：免费可以试吗？ A：新账号一般有少量免费额度让你试。要长期用建议要么买月之暗面会员（个人开发者推荐），要么直接走开放平台 API 按 token 付费。

Q：能不能离线用？ A：不能。每次操作都要请求 Kimi API，没网络做不了任何事。

Q：会不会改坏我代码？ A：会，但 Kimi Code 默认每个改动都问你 y/n。养成 3 个习惯：1) 干活前先 git commit 当前状态，2) 看 diff 再批，3) 干完跑测试验证。改坏 git reset --hard HEAD 就回来了。