需安装CLI并验证版本，首次运行启动TUI完成浏览器授权，无浏览器环境须手动设置以xai-开头的API密钥；支持单次问答、目录绑定和管道输入三种调用模式，TUI内可用/help等快捷指令管理会话。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在终端里快速调用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 —— 清空当前会话历史，释放内存并重置上下文，避免长会话后推理偏移。
