# MiniMax Code 文档

- [欢迎使用 MiniMax Code](https://agent.minimaxi.com/docs/code/welcome.md): MiniMax Code 是面向桌面端的 AI Agent 应用，支持代码开发、日常工作流、自动化任务和远程控制。
- [下载与安装](https://agent.minimaxi.com/docs/code/get-started/download.md): 下载 MiniMax Code 桌面端，并在 macOS 或 Windows 上完成安装。
- [创建第一个任务](https://agent.minimaxi.com/docs/code/get-started/first-task.md): 从首页输入目标、选择工作区并发送任务，让 MiniMax Code 开始工作。
- [Coding 与 Work 模式](https://agent.minimaxi.com/docs/code/workflows/modes.md): 了解 MiniMax Code 的两种桌面端工作模式，以及何时使用 Coding 或 Work。
- [工作区与项目上下文](https://agent.minimaxi.com/docs/code/workflows/workspace.md): 为任务选择本地项目目录，让 Agent 理解文件结构、代码约定和运行环境。
- [对话、任务与历史管理](https://agent.minimaxi.com/docs/code/workflows/tasks.md): 管理 MiniMax Code 中的任务、会话历史、置顶和归档。
- [对话协作](https://agent.minimaxi.com/docs/code/workflows/conversation-collaboration.md): 在对话中直接引用、评论和评价 Agent 回复。
- [代码审查](https://agent.minimaxi.com/docs/code/workflows/code-review.md): 使用内置代码审查指令审查本地代码变更。
- [权限与安全确认](https://agent.minimaxi.com/docs/code/workflows/permissions.md): 了解 Agent 执行文件、命令和外部操作时的权限确认机制。
- [无限画布](https://agent.minimaxi.com/docs/code/desktop/infinite-canvas.md): 把素材、灵感和生成结果铺在同一张画布上，和 Agent 一起完成多媒体创作。
- [内置浏览器](https://agent.minimaxi.com/docs/code/desktop/browser.md): 在 MiniMax Code 右侧面板打开网页、预览 HTML 产物并辅助调试。
- [电脑操控](https://agent.minimaxi.com/docs/code/desktop/computer-use.md): 让 MiniMax Code 直接操作电脑上的应用，完成需要图形界面交互的任务。
- [文件、变更与终端面板](https://agent.minimaxi.com/docs/code/desktop/panels.md): 使用 MiniMax Code 的文件、变更和终端面板查看任务执行过程。
- [界面外观](https://agent.minimaxi.com/docs/code/desktop/appearance.md): 调整 MiniMax Code 的明暗模式、主题风格、界面密度、字体和页面配色。
- [快捷键与快捷小窗](https://agent.minimaxi.com/docs/code/desktop/shortcuts.md): 使用全局快捷键、命令面板和快捷小窗更快发起任务。
- [应用更新与问题反馈](https://agent.minimaxi.com/docs/code/desktop/updates-feedback.md): 检查 MiniMax Code 更新，并通过统一的问题反馈流程提交工单。
- [目标功能](https://agent.minimaxi.com/docs/code/desktop/goal.md): 使用 Goal 为 MiniMax Code 设定可验证的最终目标，让任务持续推进直到达标或遇到阻塞。
- [Agent Team](https://agent.minimaxi.com/docs/code/agents/team.md): 使用 Agent Team 处理需要拆解、协作和校验的复杂任务。
- [自定义 Agent](https://agent.minimaxi.com/docs/code/agents/custom-agents.md): 创建具有固定角色、指令、技能和工作区的专属 Agent。
- [Mini App](https://agent.minimaxi.com/docs/code/agents/mini-apps.md): 把信息、工具和操作集中到一个页面中，并通过对话持续调整。
- [H3 Max 视频生成](https://agent.minimaxi.com/docs/code/agents/h3-max.md): 在 MiniMax Code 中，用文字和参考素材创作带声音的视频。
- [插件市场](https://agent.minimaxi.com/docs/code/agents/plugins.md): 在 MiniMax Code 中安装和使用领域插件。
- [插件开发与上架指南](https://agent.minimaxi.com/docs/code/agents/plugin-submission.md): MiniMax Plugin 的能力选择、目录结构、Manifest 字段、Skill 与 MCP 编写、包体限制和提交流程。
- [MCP 服务](https://agent.minimaxi.com/docs/code/agents/mcp.md): 将外部工具和数据源连接到 MiniMax Code。
- [记忆机制](https://agent.minimaxi.com/docs/code/agents/memory.md): MiniMax Code 通过记忆沉淀你的偏好、项目约定和长期经验。
- [定时任务](https://agent.minimaxi.com/docs/code/automation/schedules.md): 让 Agent 按计划自动执行重复任务。
- [远程控制](https://agent.minimaxi.com/docs/code/automation/remote-control.md): 在手机上连接桌面端 Agent，查看进度、补充指令和处理权限确认。
- [IM 连接](https://agent.minimaxi.com/docs/code/automation/im.md): 通过微信、飞书、Telegram 或 Lark 与 Agent 协作。
- [M Plan 与积分](https://agent.minimaxi.com/docs/code/account/usage.md): 查看 MiniMax Code 的订阅套餐、积分余额和用量额度。
- [MiniMax API 密钥](https://agent.minimaxi.com/docs/code/account/minimax-api.md): 在 MiniMax Code 中配置自己的 MiniMax API Key。
- [自定义模型 / BYOK](https://agent.minimaxi.com/docs/code/account/byok.md): 通过 Base URL、API Key 和模型名添加自定义模型供应商。
- [Agent 的 BYOK 模型配置指南](https://agent.minimaxi.com/docs/code/account/byok-agent-setup.md): 指导 Agent 配置自定义模型，并在 macOS 和 Windows 上通过 curl 验证真实回复。
- [常见问题](https://agent.minimaxi.com/docs/code/help/faq.md): MiniMax Code 桌面端常见问题。
- [问题反馈](https://agent.minimaxi.com/docs/code/help/feedback.md): 遇到问题时，通过问题反馈提交复现信息、截图和诊断信息。
- [快速开始](https://agent.minimaxi.com/docs/cli/quick-start.md): 安装 MiniMax Code CLI，登录账号并完成第一个终端任务。
- [WebUI](https://agent.minimaxi.com/docs/cli/webui.md): 在本机启动 MiniMax Code Web，用浏览器下指令、看进度、批权限。
- [能力总览](https://agent.minimaxi.com/docs/cli/features.md): 了解 MiniMax Code CLI 的入口、核心能力和文档导航。
- [工作流](https://agent.minimaxi.com/docs/cli/workflows.md): 使用 MiniMax Code CLI 完成仓库协作、多轮任务、计划、权限和 Session 恢复。
- [配置与模型](https://agent.minimaxi.com/docs/cli/configuration.md): 配置 MiniMax Code CLI 的数据目录、账号来源、Provider、模型、代理、Skills、MCP 和 Plugin。
- [Headless 与 CI](https://agent.minimaxi.com/docs/cli/automation.md): 使用 mcode exec 接入 Shell、CI、批处理和评测，并处理结构化输出与退出码。
- [TypeScript SDK](https://agent.minimaxi.com/docs/cli/sdk.md): 用 @minimax-ai/code-sdk 在 Node.js 中程序化驱动本机 MiniMax Code。
- [Python SDK](https://agent.minimaxi.com/docs/cli/sdk-python.md): 用 minimax-code-sdk 在 Python 中程序化驱动本机 MiniMax Code。
- [ACP 集成](https://agent.minimaxi.com/docs/cli/integrations.md): 将 MiniMax Code CLI 接入支持 Agent Client Protocol 的编辑器和 Agent 宿主。
- [Computer Use](https://agent.minimaxi.com/docs/cli/computer-use.md): 在交互式 TUI 中让 MiniMax Code 操作 macOS / Windows 电脑上的应用。
- [命令参考](https://agent.minimaxi.com/docs/cli/reference.md): 查看 MiniMax Code CLI 的顶层命令、参数和机器可读输出入口。
- [安全与权限](https://agent.minimaxi.com/docs/cli/security.md): 理解 MiniMax Code CLI 的权限模式、凭证保护和自动化安全边界。
- [常见问题](https://agent.minimaxi.com/docs/cli/faq.md): 排查 MiniMax Code CLI 的安装、登录、配置、自动化和终端问题。
- [什么是 Mini App？](https://agent.minimaxi.com/docs/miniapp/overview.md)
- [功能一览](https://agent.minimaxi.com/docs/miniapp/features.md): Mini App 能做什么：界面与窗口、设备、后端与数据、与 Agent 协作、会话、构建分发、运行管理和安全。
- [能力与进展](https://agent.minimaxi.com/docs/miniapp/progress.md): 按模块查看 Mini App 各项能力的状态：已发布、实验性、即将发布、规划中。
- [架构概览](https://agent.minimaxi.com/docs/miniapp/learn/architecture.md): Mini App 由哪些部分组成、它们怎么通信，以及一次完整调用的全过程。
- [Mini App 与会话](https://agent.minimaxi.com/docs/miniapp/sessions.md)
- [运行与更新](https://agent.minimaxi.com/docs/miniapp/host/lifecycle.md): 宿主怎样发现、启动、更新和回收一个 Mini App。写 Mini App 不需要读完这页，遇到边界情况时再来查。
- [安全模型](https://agent.minimaxi.com/docs/miniapp/host/security.md): Mini App 的运行权限，以及宿主对端口、凭据和 Agent 接口的限制。
- [用 Agent 构建 Mini App](https://agent.minimaxi.com/docs/miniapp/authors/quickstart.md): 在 MiniMax Code 桌面端用 /miniapp-creator，从一句需求走到可用的页面。
- [包结构与清单](https://agent.minimaxi.com/docs/miniapp/authors/package.md): Mini App 是一个普通的 MiniMax Plugin，多了一份 miniapp.json 声明和页面、Node 两份运行载荷。
- [Node 运行时](https://agent.minimaxi.com/docs/miniapp/authors/node-runtime.md): 入口模块导出 start(context)。宿主负责拉起进程、分配端口、鉴权和回收。
- [页面 Client API](https://agent.minimaxi.com/docs/miniapp/authors/client-api.md): 宿主通过 preload 向 Mini App 主页面注入 window.mcode。调用之前先确认方法存在。
- [与 Agent 双向协作](https://agent.minimaxi.com/docs/miniapp/authors/agent.md): Agent 可以调用 Mini App 的工具，Mini App 也可以把工作交给 Agent。关键节点上始终由人确认。
- [接入数据与服务](https://agent.minimaxi.com/docs/miniapp/authors/data.md): 业务数据的读写放在 Mini App 的 Node 服务里，页面只调用 Node 提供的业务接口。
- [发布、调试与排错](https://agent.minimaxi.com/docs/miniapp/authors/publish.md): 发布是一次可以回滚的事务。出问题时，先看宿主返回的结构化结果。
- [上架与分享](https://agent.minimaxi.com/docs/miniapp/authors/share.md): 企业开发者走官方合作流程上架插件市场，个人开发者通过开源社区分享。
- [Client API 参考](https://agent.minimaxi.com/docs/miniapp/reference/client-api.md): 页面侧 window.mcode.miniapp 的方法签名、参数、返回值、权限和生命周期。
- [Node API 参考](https://agent.minimaxi.com/docs/miniapp/reference/node-api.md): start(context)、生命周期、日志、Host Connector 和统一工具入口的签名、参数与返回类型。
- [Agent API 参考](https://agent.minimaxi.com/docs/miniapp/reference/agent-api.md): Mini App 页面和 Node 服务调用 Agent 的完整签名、数据类型、事件、权限和取消约定。
- [miniapp.json 字段](https://agent.minimaxi.com/docs/miniapp/reference/manifest.md): Mini App 声明的全部字段。未知字段一律拒绝。
- [错误码参考](https://agent.minimaxi.com/docs/miniapp/reference/errors.md): Mini App 页面、Node、Agent 与生命周期工具的错误形状、码值和恢复方式。
- [更新日志](https://agent.minimaxi.com/docs/changelog.md): 追踪 MiniMax Code 功能发布记录。
- [研究](https://agent.minimaxi.com/docs/techblog.md): MiniMax Code 团队的研究与工程实践。
- [Skills](https://agent.minimaxi.com/docs/code/agents/skills.md)
- [常见问题](https://agent.minimaxi.com/docs/question.md): MiniMax Code 客户端常见启动、登录、无响应和日志反馈问题的解决方案。
- [产品日记：构建生长在 Agent OS 之上的专业级 Mini App](https://agent.minimaxi.com/docs/techblog/agent-as-os.md): 从 Chatbot、工作流到 Agent，再到 Mini App，为什么我们选择让 Agent 内化为一种系统服务？
- [从 Personal Agent 到 Agent Team：BYOB 协作协议的设计与开源实现](https://agent.minimaxi.com/docs/techblog/byob-agent-table.md): 在互相信任的团队里，每个人都在用自己的 bot 干活，人却成了 bot 之间的中继。我们把大家的 bot 放到同一张桌子上：共享账本、席位、发言权和提交网关，桌子不托管任何一个 bot。协议和参考实现已开源。
- [给 Coding Agent 建一座试验场](https://agent.minimaxi.com/docs/techblog/coding-agent-eval.md): 从 MiniMax Code 出发，搭建能验证 Harness 改动的评测系统。
- [Agent 越多，我越忙：我如何走出 AI 编程的监工困境](https://agent.minimaxi.com/docs/techblog/coding-agent-workflow-and-skills.md): 从一次多 Agent 编排的审计出发，分享我现在使用的需求定义、独立验证和交付工作流，以及 core-grill、core-spec、deliver 三个 Skill。
- [MCode 工程笔记 01｜subagent 不是越多越好：先管好 context，再谈并行](https://agent.minimaxi.com/docs/techblog/mcode-notes-01-subagent.md): subagent 是用来管 context 的，不是用来分地盘的：什么时候该拆、什么时候别拆，拆多了怎么收回来。
- [MCode 工程笔记 02｜工具一多，context 就爆：从 tool search 到 PTC](https://agent.minimaxi.com/docs/techblog/mcode-notes-02-tool-search-ptc.md): 按 MiniMax Code 实际走过的顺序：先做减法，再上 tool search，最后走到 PTC（让模型写程序调工具）。
- [MCode 工程笔记 03｜长会话怎么不变傻：compaction 和 memory 的取舍](https://agent.minimaxi.com/docs/techblog/mcode-notes-03-compaction-memory.md): 会话越来越长以后怎么办：compaction 和 memory 各管什么、各自会在哪儿出问题、怎么配合。
- [MCode 工程笔记 04｜一条 bash 命令该等多久：从前台阻塞到后台任务](https://agent.minimaxi.com/docs/techblog/mcode-notes-04-bash-background.md): Agent 跑一条 bash 命令，要不要等它跑完？从前台阻塞一路推到后台任务，以及随之而来的通知、防轮询、回收和压缩后的提醒。
- [MCode 工程笔记 05｜怎么让 Agent 知道当前时间](https://agent.minimaxi.com/docs/techblog/mcode-notes-05-prefix-cache.md): 模型没有时钟。最直接的做法是往系统提示词里注入时间，但时间每轮都变会拖垮前缀缓存。由浅入深：为什么前缀这么重要，以及 MCode 现在怎么做。
- [MiniMax Code 正式开源：拆解 Coding Agent 背后的 Harness 架构](https://agent.minimaxi.com/docs/techblog/minimax-code-harness.md): 沿着一次任务的执行路径，拆解 MiniMax Code 如何装配每轮能力、管理上下文、执行工具、提交历史，以及在多 Agent 协作中确认子任务结果。
- [插件即应用：MiniMax Code Mini App 正式发布](https://agent.minimaxi.com/docs/techblog/minimax-code-mini-app.md): Mini App 是一种带前端和后端、可以长期运行的应用，以插件形式安装，能和 Agent 互相调用，让 Agent 干的活留在一个一直在跑的页面上。
- [好奇心、执行力、科学素养：AI 时代真正稀缺的三样东西](https://agent.minimaxi.com/docs/techblog/why-be-in-ai.md): 实验几乎免费以后，稀缺的是问对问题、设计对对照。好奇心、执行力、科学素养，三者怎么叠起来。

## AsyncAPI Specs

- [asyncapi](/docs/api-reference/speech/t2a/api/asyncapi.json)