跳到主要内容

Grok CLI

Grok CLI 接入 菜ai 教程

Grok CLI 是一款轻量级的终端命令行动力工具。通过配置兼容 OpenAI 的接口环境变量，你可以轻松将 Grok CLI 的底层大脑切换为 菜ai 提供的高性能模型。

一、接入前准备（核心 3 要素）​

在开始配置前，请先明确以下 3 个核心参数，后续终端配置将直接用到它们：

配置项推荐填写内容注意事项
API Keysk-xxxxxxxxxxxxxxxx请直接填写纯文本密钥，不要带 Bearer 前缀。
Base URLhttps://cloud.ai.liandxu.cn不包含 /v1。
模型名称填写 菜ai 实际支持的模型名必须填写你账号有权限调用且平台真实存在的模型。

二、安装 Grok CLI​

Grok CLI 依赖 Node.js 环境，请确保你的电脑已安装 Node.js。

打开终端（Windows 推荐 PowerShell，Mac 推荐 Terminal），直接运行以下命令进行全局安装：

npm install -g grok-cli

安装跑完进度条后，在终端中输入 grok --help。如果能正常输出使用指南，说明安装成功，可以进行下一步配置。

三、一键启动命令（请替换你的 Key）​

复制以下命令并回车运行。注意：--base-url 结尾请勿携带 /v1。

grok -p 3001 -k "你的菜ai密钥" --base-url "https://cloud.ai.liandxu.cn" --reasoning-model "deepseek-v3.2-251201" --completion-model "deepseek-v3.2-251201"

参数详解：

  • -p 3001：指定运行端口（避开默认的 3000 端口）。
  • -k：你的 API Key。（只需输入一次，后续启动可省略此参数）。
  • --base-url：填写 菜ai 接口根地址（推荐 https://cloud.ai.liandxu.cn ）。

四、配置永久快捷启动（配置后只需输入 grok）​

为了避免每次都输入长命令，建议将配置保存到系统中：

  1. Windows 用户 (PowerShell): 在终端输入以下命令打开配置文件：
notepad $PROFILE
  • 在打开的记事本末尾，粘贴下面这段代码（请替换为你的模型名）：
function grok-short {
    grok -p 3001 --base-url "https://cloud.ai.liandxu.cn" --reasoning-model "你的模型名" --completion-model "你的模型名"
}
Set-Alias grok grok-short
  • 记得把模型名换上再保存并关闭记事本。重启终端后，你以后只需要输入 grok 即可一键进入。
  • 如果失败，终端输入：
$content = @'
function grok-short {
    # 使用 grok.cmd 避免死循环，使用 -p 3001 避免端口冲突
    grok.cmd -p 3001 --base-url "https://cloud.ai.liandxu.cn" --reasoning-model "deepseek-v3.2-251201" --completion-model "deepseek-v3.2-251201"
}
# 使用 -Force 强制覆盖，不再需要繁琐的 if 判断
Set-Alias grok grok-short -Force
'@
Set-Content -Path $PROFILE -Value $content
. $PROFILE
  • 这里的model ""可以换成控制台支持的海量模型。
  1. macOS / Linux 用户: 在终端输入：
echo 'alias grok="grok -p 3001 --base-url https://cloud.ai.liandxu.cn --reasoning-model 你的模型名 --completion-model 你的模型名"' >> ~/.zshrc
source ~/.zshrc

五、常见问题 (FAQ)​

Q：为什么启动后显示的是 "Claude Code" 的界面？ A：这是正常的！Grok CLI 本质上是一个高性能代理，它"借用"了 Claude Code 的优秀交互界面，但背后的模型和算力全部来自你配置的 菜ai。

Q：输入问题后提示 "404 Not Found" 或模型不存在？ A：请检查你的 --base-url。请确保网址末尾没有 /v1。

  • 错误写法：https://cloud.ai.liandxu.cn/v1
  • 正确写法：https://cloud.ai.liandxu.cn

Q：提示端口冲突 (EADDRINUSE)？ A：说明 3001 端口被占用，请将命令中的 -p 3001 改为 -p 3002 或其他任意四位数端口。