配置文件落在哪
用户级配置常见是家目录下的 .grok/config.toml。Windows 写在用户目录对应位置。项目里还可能有本地覆盖，以 inspect 列出的源为准。
公开文档展示过在用户配置里声明自定义模型：模型 id、base_url、展示名和密钥环境变量名，以及默认模型。字段名以当天文档为准。
改完配置先跑 inspect，再在 TUI 用 /model 或无头的 -m 选择。不要假设保存即生效却不重启会话。
- 先找到用户级 config.toml。
- 只加你理解的字段。
- 改完用 inspect 核对。
把 grok inspect 当成体检
inspect 会显示当前目录发现的配置源、说明书、技能、插件、钩子和 MCP。它是排错的第一刀，也是写说明书前的地图。
若某条技能或 MCP 没出现，先看路径和项目根，再怀疑产品坏了。
把 inspect 输出当检查清单，不要当要贴进聊天的机密。里面可能有服务器名和路径。
- 确认当前目录是仓库根。
- 记下说明书和技能来源。
- 没出现的项先查路径。
AGENTS.md 写什么
说明书是始终生效的短事实：语言、包管理器、测试命令、禁区。不是团队文化散文。
只写 Agent 不知道就会做错的事。README 已经有的架构故事，不必再抄一遍。
仓库级一份即可。用户级补充个人习惯。两边打架时，以你真正想执行的那份为准并删掉另一份。
- 测试命令用本机真实命令。
- 禁区写成路径，不要写成形容词。
- 先短后长，宁可缺一句。
模型和 /model
公开材料提过 Grok 4.6 作为驱动 Build 的模型之一，也允许自定义模型。默认值会变。
TUI 里用 /model 切换。无头用文档中的模型参数。先在小事上试，再换到长任务。
自定义模型要写对 base_url 和密钥变量名。配错时 inspect 往往比报错信息更早露出端倪。
- 先记下当前默认模型。
- 自定义模型单独一节，不要覆盖你还没理解的默认值。
- 切换后做一次只读自检。
插件和市场
插件是可安装的扩展，市场是发现入口。第一周只装你能说出用途的一项。
TUI 里通常有插件与市场相关的斜杠命令。装完立刻 inspect，确认来源路径。
- 只装官方或你审查过的来源。
- 装完用 inspect 核对。
- 不需要的立刻关掉。
钩子做什么
钩子在特定生命周期插入你自己的检查，例如拦一次危险命令。它不是第二份说明书。
先写一条只读或拒绝规则练手。钩子写错会让会话变得难以解释。
- 一条钩子只做一件事。
- 先在练习仓库验证。
- 用 inspect 确认已加载。
工作树和子代理
公开功能里包含工作树和子代理，用来隔离并行改动。第一周不是必选项。
只有当你已经能复查单会话 diff，再让第二个代理去并行。否则你只是并行制造混乱。
- 先精通单会话。
- 并行前准备独立工作树或分支。
- 每个子代理也要有验收命令。
配置阶段的错
把别人的 config.toml 整份粘贴进来，连同他们的 MCP 和密钥变量名。
说明书写成小说，inspect 里却找不到测试命令。
- 未跑 inspect 就加插件。
- 用户级和仓库级规矩互相打架。
- 把密钥写进 toml。
配置章完成标准
你能指出配置文件、inspect 里的说明书来源，以及三条禁区。
- 打开过用户级 config.toml。
- 跑过 inspect。
- 仓库里有一份短 AGENTS.md。
- 没有把密钥写进文件。
- 知道 /model 在哪。
下一步：把重复劳动收成技能
技能章会写可复用剧本，并用 /skillify 从一次做好的任务抽取。
MCP 仍然再等一章。先让说明书稳定。