Grok CLI 接入数眼智能教程

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

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

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

配置项	推荐填写内容	注意事项
API Key	`sk-xxxxxxxxxxxxxxxx`	请直接填写纯文本密钥，不要带 `Bearer` 前缀。
Base URL	`https://platform.shuyanai.com`	不包含 `/v1`。
模型名称	填写数眼智能实际支持的模型名	必须填写你账号有权限调用且平台真实存在的模型。

二、安装 Grok CLI

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

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

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

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

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

参数详解：

-p 3001：指定运行端口（避开默认的 3000 端口）。

-k：你的 API Key。（只需输入一次，后续启动可省略此参数）。

--base-url：填写数眼智能接口根地址（推荐 https://platform.shuyanai.com ）。

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

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

Windows 用户 (PowerShell):
在终端输入以下命令打开配置文件：

notepad $PROFILE

在打开的记事本末尾，粘贴下面这段代码（请替换为你的模型名）：

function grok-short {
    grok -p 3001 --base-url "https://platform.shuyanai.com" --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://platform.shuyanai.com" --reasoning-model "deepseek-v3.2-exp" --completion-model "deepseek-v3.2-exp"
}
# 使用 -Force 强制覆盖，不再需要繁琐的 if 判断
Set-Alias grok grok-short -Force
'@
Set-Content -Path $PROFILE -Value $content
. $PROFILE

这里的model ""可以换成控制台支持的海量模型。

macOS / Linux 用户:
在终端输入：

五、常见问题 (FAQ)

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

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

错误写法：

https://platform.shuyanai.com
/v1

正确写法：

https://platform.shuyanai.com

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

Grok CLI

Grok CLI 接入 数眼智能 教程#

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

二、安装 Grok CLI#

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