五分钟，进入第一个 Agent 工作流。
从打开项目到审阅改动，下面是使用 Xora Code 最重要的五件事。
打开项目并开始会话
启动后选择文件夹或工作区。Xora Code 会恢复该项目最后一次会话并在后台准备 Runtime；点击右侧 + 可随时新建干净会话。
- 左侧选择文件和目录
- 中间编辑、运行与查看 Diff
- 右侧描述任务并跟踪 Agent
连接 Grok 或自定义模型
进入 Agent 设置，在“模型服务”中登录 Grok 订阅，或添加带 Base URL、API Key、协议与模型 ID 的兼容服务。模型选择会在项目和会话间保持一致。
- Grok 订阅登录由 Grok Build 处理
- 自定义服务支持三种常见协议
- API Key 不会写入页面和普通设置文件
发送任务并审阅执行
输入目标后，Xora Code 会先保存编辑器文件，再把任务发送给 Agent。过程中可查看计划、工具活动、终端输出与耗时；文件变更完成后可打开原生 Diff。
- Enter 发送，Shift + Enter 换行
- 同一会话可继续加入等待消息
- 上滑阅读时不会强制跳回底部
使用 Skills 与 MCP
在 Agent 设置中查看已安装的 Skills 与 MCP，并决定是否启用。输入框中键入 / 可以引用已加载的扩展；单个 MCP 配置异常只会隔离对应服务。
- 启停状态在升级后继续保留
- MCP 页面区分发现、诊断与会话加载
- Provider 切换不会清空统一扩展配置
选择权限方式
“请求审批”会在敏感操作前询问；“完全访问”允许 Agent 操作当前系统账户可访问的整块磁盘。选择会在所有项目、会话和窗口保持一致。
- 完全访问不会绕过操作系统权限
- 密钥和权限裁决位于 Electron 主进程
- 文件安全撤销前会校验写入后哈希
常见问题
这是 xAI 官方应用吗？
不是。Xora Code 是独立社区维护的开源项目，“Grok”仅用于准确描述 Grok Build 集成关系。
上下文过长会自动压缩吗？
会。Xora Code 复用 Grok Build 的原生上下文压缩机制，并展示真实 Token、压缩耗时与累计次数。
历史会话会丢失吗？
会话事件以脱敏 JSONL 保存在本机。项目打开时优先恢复最近会话；恢复失败时仍会保留只读历史，且不会自动重放旧任务。
在哪里反馈问题？
请前往 GitHub Issues，并附上操作系统、Xora Code 版本和经过脱敏的错误信息。