跳到主要内容

Kimi Code 命令行

Kimi Code CLI 是面向开发者的命令行 AI 编程工具。接入鼎惠API 后，可以通过 OpenAI 兼容协议调用平台中可用的 Kimi 或其它兼容模型。

准备工作​

  • 已注册并登录 鼎惠API 控制台
  • 已创建 API Key
  • 已确认要使用的模型 ID，推荐先在 模型广场 查看当前可用模型
  • Windows 用户建议提前安装 Git for Windows，避免首次运行时缺少 Git 命令

安装 Kimi Code CLI​

如果官方安装脚本可用，可以使用官方脚本安装。执行前请确认脚本来源可信，并避免在不了解内容的情况下运行远程脚本。

macOS / Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows PowerShell:

irm https://code.kimi.com/kimi-code/install.ps1 | iex

如果你更习惯使用 npm，需要先安装 Node.js。建议使用 Node.js 22 或更新版本。

node --version
npm install -g @moonshot-ai/kimi-code

也可以使用 pnpm：

pnpm add -g @moonshot-ai/kimi-code

配置鼎惠API​

Kimi Code 的自定义模型配置通常通过环境变量完成。下面示例使用 OpenAI 兼容协议。

macOS / Linux:

export KIMI_MODEL_NAME="kimi-k3"
export KIMI_MODEL_PROVIDER_TYPE="openai"
export KIMI_MODEL_API_KEY="sk-your-dinghui-key"
export KIMI_MODEL_BASE_URL="https://www.tophdd.cn/v1"
export KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"

如果希望长期生效，可以写入 ~/.zshrc 或 ~/.bashrc：

cat >> ~/.zshrc <<'EOF'
export KIMI_MODEL_NAME="kimi-k3"
export KIMI_MODEL_PROVIDER_TYPE="openai"
export KIMI_MODEL_API_KEY="sk-your-dinghui-key"
export KIMI_MODEL_BASE_URL="https://www.tophdd.cn/v1"
export KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"
EOF
source ~/.zshrc

Windows PowerShell:

$env:KIMI_MODEL_NAME = "kimi-k3"
$env:KIMI_MODEL_PROVIDER_TYPE = "openai"
$env:KIMI_MODEL_API_KEY = "sk-your-dinghui-key"
$env:KIMI_MODEL_BASE_URL = "https://www.tophdd.cn/v1"
$env:KIMI_MODEL_MAX_CONTEXT_SIZE = "1048576"

如需长期保存到当前 Windows 用户环境变量：

[Environment]::SetEnvironmentVariable("KIMI_MODEL_NAME", "kimi-k3", "User")
[Environment]::SetEnvironmentVariable("KIMI_MODEL_PROVIDER_TYPE", "openai", "User")
[Environment]::SetEnvironmentVariable("KIMI_MODEL_API_KEY", "sk-your-dinghui-key", "User")
[Environment]::SetEnvironmentVariable("KIMI_MODEL_BASE_URL", "https://www.tophdd.cn/v1", "User")
[Environment]::SetEnvironmentVariable("KIMI_MODEL_MAX_CONTEXT_SIZE", "1048576", "User")

启动​

kimi

启动后先发起一个简单问题，确认控制台请求日志中能看到调用记录。

常见问题​

提示鉴权失败​

检查 KIMI_MODEL_API_KEY 是否完整复制，确认没有多余空格、换行或中文引号。

没有请求日志​

通常是环境变量没有被当前终端读取。重新打开终端，或在当前终端重新执行环境变量配置。

模型不存在​

检查 KIMI_MODEL_NAME 是否填写了鼎惠API 当前可用的模型 ID。模型 ID 以模型广场显示为准。