aicentos客户端接入
Grok CLI
在 Grok CLI 中使用 aicentos —— 通过环境变量或配置文件接入
最后更新于:
Grok CLI 是一个命令行工具，使用 OpenAI 兼容接口，可以直接将自定义 API 地址作为其后端服务接入。
准备工作
需要先安装 Node.js 18+ 和 npm。
推荐从 Node.js 官方下载页安装：https://nodejs.org/en/download
- macOS/Windows：下载并安装 LTS 版本
- Linux：按发行版方式安装
macOS 用户也可以使用 Homebrew：
brew install node安装完成后确认：
node -v
npm -v安装 Grok CLI
使用 npm 全局安装：
npm install -g @vibe-kit/grok-cli安装完成后验证：
grok --version配置接入
Grok CLI 提供三种配置方式，优先级为：命令行参数 > 环境变量 > 配置文件。
方式一：环境变量（推荐）
设置以下环境变量：
export GROK_BASE_URL="https://aicentos.com/v1"
export GROK_API_KEY="your_api_key_here"临时测试直接在当前 shell 执行 export 即可。永久生效需将上述语句加入 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc 使其生效。
方式二：配置文件
编辑 ~/.grok/user-settings.json：
{
"apiKey": "your_api_key_here",
"baseURL": "https://aicentos.com/v1",
"defaultModel": "gpt-4o"
}方式三：命令行参数
启动时通过参数指定：
grok --base-url https://aicentos.com/v1启动使用
配置完成后，直接运行：
grok启动后在 Grok CLI 中发起对话，如果能正常收到回复，说明接入成功。
验证与排查
如果遇到鉴权错误，请检查：
GROK_API_KEY是否正确GROK_BASE_URL/baseURL是否指向正确的服务地址（需要带/v1后缀）
确认配置无误后重新启动即可。
注意事项
- Grok CLI 使用 OpenAI 兼容接口，配置简单直接
- 三种配置方式可以灵活选择，推荐使用环境变量方式
- API 地址必须包含
/v1后缀 - 支持自定义默认模型