快速开始

挑一个最贴近你的使用场景，下面会自动展开对应的完整步骤。如果不确定怎么选，留在 🖥️ 桌面 App · 本机一键这条路上 — 绝大多数新用户最快上手的姿势。

你打算怎么用 MIRA?

👆 点上面任意一张卡，下面会展开完整步骤。你的选择会记住在本浏览器里，下次刷新还在；URL 会带上 #scenario-xxx，方便分享。

通用前置

不管走哪条路，至少需要：

• macOS 12+ / Windows 10+ / Linux x86_64 一台
• 至少一个 LLM Provider 的 API key（OpenAI / Anthropic / OpenRouter / DeepSeek / 阿里 DashScope / 智谱 / 火山 / Azure / Ollama 等任一即可；OpenRouter 一把钥匙调遍全家，新人最省事）
• 想跑本地模型：先装好 Ollama 并 ollama pull qwen2.5:14b

---

Provider 配置参考

普通 API key provider 可以直接编辑 ~/.mira/config.json。OAuth provider（OpenAI Codex / GitHub Copilot）不能手写 key，必须走 mira onboard --wizard 的浏览器登录流程。

选项 A：OpenRouter（最简单，一把钥匙调全家）

{
  "agents": {
    "defaults": {
      "provider": "openrouter",
      "model": "anthropic/claude-sonnet-4-5",
      "maxTokens": 8192,
      "temperature": 0.1,
      "maxToolIterations": 60
    }
  },
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-..."
    }
  }
}

选项 B：直接 OpenAI + Anthropic 双账号

{
  "agents": {
    "defaults": {
      "provider": "auto",
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "providers": {
    "openai":    { "apiKey": "sk-..." },
    "anthropic": { "apiKey": "sk-ant-..." }
  }
}

provider: "auto" 会按 model 字段自动匹配：anthropic/... → anthropic，openai/... → openai。

选项 C：OAuth（OpenAI Codex / GitHub Copilot）

OAuth provider 不在 config.json 里写 API key：

mira onboard --wizard
# 选择 openai-codex 或 github-copilot，按提示在浏览器登录

登录后 token 由专用 OAuth 状态目录托管。常见 agents.defaults 字段：

{
  "agents": {
    "defaults": {
      "provider": "openai_codex",
      "model": "openai-codex/gpt-5.3-codex"
    }
  }
}

选项 D：本地 Ollama（无需 API key）

先装 Ollama 并 ollama pull qwen2.5:14b，然后：

{
  "agents": {
    "defaults": {
      "provider": "ollama",
      "model": "qwen2.5:14b"
    }
  },
  "providers": {
    "ollama": {
      "apiBase": "http://localhost:11434"
    }
  }
}

完整 provider / 模型 / 路由参数：Provider 与运行时参数、模型路由（Router）模式。

下一步去哪

用得更顺手

• 核心概念 — 弄清楚 task_plan / project / experiment 的边界。
• UI 功能总览 — 把每个面板的快捷键和按钮过一遍。
• 运行模式与 Profile — 学会切到 auto，吞吐量翻倍。

调优

• Provider 与运行时参数 — 切模型、调温度、改回合上限。
• 模型路由（Router）模式 — 让便宜模型干便宜的活。
• Skills 与 Tools — 看看还有哪些 skill 可用，怎么挂自定义 MCP 工具。

扩展

• Channel 配置 — 把 Agent 接到飞书 / Slack / Telegram。
• 自托管部署 — 把后端搬到团队服务器。
• 本地服务（mira-engine） — 让引擎像系统服务一样常驻。

出问题了

• FAQ 与故障排查