MiniMax-AI/minimax-code
An open-source coding agent for your terminal, powered by MiniMax.
MiniMax Code – 一款基于终端的编码助手
它是什么 – MiniMax Code（通常调用为 mcode）是一个命令行工具，让您可以与大型语言模型 (LLM) 对话，直接从终端理解、编辑和测试代码。它适用于 MiniMax 托管的模型、“Token Plan”账户，或您提供的任何兼容 OpenAI 或 Anthropic 的端点。
核心功能
| 功能 | 您可以做什么 |
|---|---|
| 交互式 TUI | 打开基于文本的 UI，描述任务（例如，“修复失败的测试”），并观察代理读取文件、提出差异、运行命令并应用更改。 |
| 无头/CI 模式 | mcode exec "<prompt>" 在没有 UI 的情况下运行 – 非常适合脚本、CI 流水线或批量评估。 |
| 模型灵活性 | 使用 MiniMax 账户或通过 mcode provider add … 添加您自己的提供商。支持 OpenAI 风格的补全、OpenAI 风格的响应和 Anthropic 风格的消息。 |
| 工具使用 | 代理可以调用内置搜索、文件系统浏览、Shell 命令和媒体工具 (mcode-tools)。权限和沙箱确保执行安全。 |
| 会话管理 | 恢复之前的工作 (mcode --continue)，选择过去的会话 (mcode --session)，或通过“计划模式”切换导出计划。 |
| 编辑器集成 | 通过代理客户端协议 (ACP)，您可以将 CLI 挂接到理解该协议的编辑器中。 |
快速入门
- 安装 – 一键安装程序 (macOS/Linux/WSL) 或 Windows 的 PowerShell 脚本，或
npm i -g @minimax-ai/code。安装程序还会在需要时提取兼容的 Node.js 运行时。 - 登录 –
mcode login（非中国账户使用--region global）。或者设置MCODE_PROVIDER_API_KEY并添加自定义提供商。 - 运行 –
cd /path/to/your/project && mcode（交互式）或mcode "Fix the failing test"（单条提示）。在 UI 内使用快捷键（Enter发送，Alt+Enter加入队列，Shift+Tab切换计划模式等）。
安装详情
- 默认安装位置：
~/.minimax-code(POSIX) 或%USERPROFILE%\.minimax-code(Windows)。CLI 二进制文件为mcode（或mcode.cmd/.ps1）。 - 用户数据（登录令牌、提供商配置、会话历史）位于
~/.minimax（或通过MINIMAX_DATA_DIR指定的自定义目录）。 - 通过删除安装文件夹和可选的
~/.minimax数据目录来卸载；README 提供了确切的 Shell 命令。
从源代码构建
git clone https://github.com/MiniMax-AI/minimax-code.git
cd minimax-code
pnpm install --frozen-lockfile # 需要 Node 22‑26 和 pnpm 9.12+
pnpm build
pnpm mcode # 运行刚构建的 CLI
源代码检出产生的 CLI 与发布为 npm 包 @minimax-ai/code@0.4.12 的相同。
文档与帮助
- 完整文档：
docs/README.md - 任务示例：
docs/examples.md - 常见问题解答/故障排除：
docs/installation.md#faq - 问题：在 GitHub 上开启（协作者可以提交 PR，其他人应提交 Issue）。
许可证 – 项目本身的代码是 MIT 许可的（参见 LICENSE）。第三方依赖项保留其原始许可证，列于 THIRD_PARTY_NOTICES.md 中。
MiniMax Code 是一款真正的开源 AI 驱动编码助手，将 LLM 驱动的代码理解、编辑和测试带到了终端。
相关
- 项目
- 项目
- 项目
- 项目