📦 问题 1：如何在 Mac 上部署 Kimi Code？
环境信息：
- 设备：MacBook Pro (Apple Silicon/Intel)
- 系统：macOS
- Shell：zsh
解决方案
1. 一键安装
打开终端，运行官方安装脚本：
curl -LsSf https://code.kimi.com/install.sh | bash
或通过 uv 安装（如果已安装 uv）：
uv tool install --python 3.13 kimi-cli
2. 系统要求
- Node.js:
>= 22（安装器会自动检测） - 网络: 需连接 Kimi 官方服务
- 权限: 当前用户目录权限
🐛 问题 2：安装后提示 zsh: command not found: kimi
现象：
wsq@wsqdeMacBook-Pro ~ % kimi --version
zsh: command not found: kimi
排查过程
先确认是否安装成功：
ls -la ~/.local/bin/kimi
输出示例：
lrwxr-xr-x@ 1 wsq staff 50 3月 8 14:03 /Users/wsq/.local/bin/kimi -> /Users/wsq/.local/share/uv/tools/kimi-cli/bin/kimi
如果显示类似上述软链接，说明安装成功，只是该路径未添加到环境变量 PATH 中。
解决方案
1. 添加到环境变量（zsh）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
2. 立即生效
source ~/.zshrc
⚠️ 问题 3：source 时出现 compdef 警告
现象：
source ~/.zshrc
/dev/fd/12:3564: command not found: compdef
解决方案
这是 zsh 自动补全配置未初始化的常见问题，不影响 Kimi Code 的核心使用。如需消除警告，可运行以下命令：
autoload -Uz compinit && compinit
(或者直接忽略该警告正常使用即可)
🚀 验证与使用
版本确认
kimi --version
# 预期输出：kimi, version 1.17.0
首次使用
进入您的项目目录并启动：
cd ~/your-project
kimi
🔑 登录授权
- 输入
/login或在浏览器访问https://platform.moonshot.cn/获取 API Key。- 注意：需开通 Kimi Code 会员（约 49 元/月）。
⌨️ 常用命令字典
| 命令 | 功能描述 |
|---|---|
kimi | 启动交互式会话（Agent 模式） |
kimi --yolo | 自动批准模式（Agent 无需用户确认即可自动执行代码/命令） |
kimi web | 打开 Web 界面（支持上传图片、视频等多模态文件） |
Ctrl-X | 快捷键：在 Agent 模式与普通 Shell 模式之间切换 |
/clear | 清空当前的会话上下文 |
✅ 最终状态
最终环境配置概览：
- Kimi Code 版本：
1.17.0 - 安装路径：
~/.local/bin/kimi(软链接至 uv tools 目录) - PATH 配置：已成功注入
~/.zshrc - 当前状态：可正常使用
🔗 参考链接
- 官方文档：https://www.kimi.com/code/docs
- 安装脚本：https://code.kimi.com/install.sh
完成时间：2026-03-08