☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
需安装cli并验证版本,首次运行启动tui完成浏览器授权,无浏览器环境须手动设置以xai-开头的api密钥;支持单次问答、目录绑定和管道输入三种调用模式,tui内可用/help等快捷指令管理会话。
你需要在终端里快速调用grok模型完成代码生成、日志分析或文件处理,但每次都要翻文档查参数、记命令格式、反复试错确认——这种低效卡点正在拖慢你的开发节奏。
基础启动与身份验证
第一步:确保已安装并验证版本,执行 【grok --version】。若提示“command not found”,说明未完成安装,需先运行 curl -fsSL https://x.ai/cli/install.sh | bash(macOS/Linux)或 irm https://x.ai/cli/install.ps1 | iex(Windows PowerShell)。
第二步:进入项目根目录,执行 grok 启动交互式 TUI。首次运行会自动打开浏览器进行 xAI 账号授权,点击“允许”即可完成绑定。
第三步:无浏览器环境(如远程服务器)下,必须手动设置 API 密钥:export XAI_API_KEY="xai-你的密钥",密钥需从 https://console.x.ai/team/default/api-keys 页面复制,【密钥开头必须是 xai-,否则认证失败】。
核心CLI参数速查表
方法一:单次问答模式(适合脚本调用)
grok "解释这段 Python 代码" --model grok-3 --timeout 60 --max-tokens 2048
注意:--model 参数必须指定有效模型名(如 grok-3、grok-2.5),不填则使用默认模型,响应可能不稳定。
方法二:目录上下文绑定(推荐用于代码任务)
grok --dir ./src "重构这个模块,把 class A 拆成两个独立 service"
这一步会强制 Grok 加载当前目录结构与文件内容,【不加 --dir 时,Grok 默认只读取当前工作目录下的文件,深层子目录内容不可见】。
方法三:管道输入(适合日志/JSON 处理)
cat error.log | grok "提取所有 5xx 错误行并统计出现次数"
管道输入会自动禁用 TUI 界面,直接返回纯文本结果,避免 ANSI 控制符干扰后续解析。
TUI 内快捷指令清单
/help —— 打开动态帮助面板,实时显示所有可用命令及当前上下文支持的技能。
/plan —— 进入规划模式,Grok 会先输出分步执行计划再确认执行,复杂任务务必先用此命令。
/yolo —— 开启自动批准模式,跳过每步操作前的确认弹窗;关闭时输入 /always-approve false。
/inspect —— 查看当前加载的技能列表、插件状态与项目配置摘要,排查功能异常时必用。
/clear —— 清空当前会话历史,释放内存并重置上下文,避免长会话后推理偏移。











