配置与模型 - MiniMax Agent 文档

本页说明 CLI 用户可以控制的配置。需要查看当前生效值时，优先使用 TUI 的 /status、/doctor 和 /model，或直接运行对应命令的 --help。

配置层级

层级	入口	作用
当前运行	命令行参数，例如 `mcode exec --model ...`	只覆盖本次进程或本次任务
Runtime 配置	`<data-dir>/config.yaml`	保存默认模型、权限模式和 MiniMax 来源
Provider 凭证	`mcode provider ...`	保存 Provider 元数据和凭证引用
项目规则	工作区中的 `AGENTS.md`	描述项目约定、验证方式和协作边界

命令行覆盖只对当前运行生效，不会悄悄改写全局配置。

数据目录

默认数据根目录是 ~/.minimax，其中保存配置、Session、日志、Plugin、Skill 和其他运行数据。使用环境变量切换目录：

export MINIMAX_DATA_DIR=/path/to/mcode-data

MAVIS_DATA_DIR 是兼容回退变量；同时设置时优先使用 MINIMAX_DATA_DIR。配置文件位置：

<data-dir>/config.yaml

常用 Runtime 配置

defaultModel: "provider-id/model-id"
defaultModelVariant: standard
permissionMode: auto
minimaxModelSource: token_plan

字段说明：

字段	可用值或格式	说明
`defaultModel`	`provider/model`	默认模型
`defaultModelVariant`	Provider 支持的变体	默认模型变体
`permissionMode`	`default`、`auto`、`bypassPermissions`、`off`	默认工具权限模式
`minimaxModelSource`	`token_plan`、`minimax_api_key`	MiniMax 凭证来源

模型可以写成 provider/model#variant。TUI 中用 /model [filter] 选择；单次 Headless 任务用 --model 覆盖。

上下文容量与状态栏

新会话会继承所选模型的上下文容量。从 0.4.12 起，默认状态栏在尚无有效用量时显示已知总容量，例如 Context 1M 或 Context 512K；获得有效用量后，自动切换为剩余百分比，例如 Context 80% left，不再同时展示总容量。终端空间不足时会使用保留 Ctx 的简短形式。如果已经自定义状态栏，运行 /statusline 勾选 context-window，或恢复默认配置。该项展示总容量；context-remaining 展示剩余百分比。显式配置时两者可以同时启用，不受默认状态栏的自动切换规则影响。当前会话的容量尚不可用时，总容量项隐藏，不会显示其他会话的值。

登录与 MiniMax 凭证

mcode login
mcode login --region global
mcode logout

中国大陆账号使用默认区域，Global 账号传入 --region global。运行 mcode logout 或 TUI 中的 /logout 会清理本地登录态，打印完整的浏览器登出链接，并尝试打开当前账号地区和环境对应的登出页。在开发机或无图形界面的环境中，可以复制屏幕上的链接到自己的浏览器打开。命令完成无需等待浏览器或页面结果。如果选择 Token Plan，CLI 会检查登录状态；如果选择 API Key，先设置环境变量：

export MCODE_PROVIDER_API_KEY="你的 MiniMax API Key"
mcode provider set-minimax-key

可以使用 --api-key-env <name> 指定其他变量名。CLI 只读取环境变量，不会在命令输出中打印 Key。

自定义 Provider

添加 Provider 至少需要一个模型：

export MCODE_PROVIDER_API_KEY="兼容服务的 API Key"

mcode provider add \
  --name "我的兼容服务" \
  --base-url "https://api.example.com/v1" \
  --api-format openai-completions \
  --model "model-id" \
  --use

支持的 API 格式：

anthropic-messages
openai-completions
openai-responses

常用管理命令：

mcode provider list
mcode provider list --json
mcode provider test <provider-id> --model <model-id>
mcode provider test <provider-id> --json
mcode provider remove <provider-id> --yes

同一 Provider 可以重复传入 --model 添加多个模型。--use 会将第一个模型设为默认模型。MiniMax OAuth Provider 通过 mcode login 管理，不通过 provider test 测试。

代理

CLI 支持以下代理环境变量及其小写形式：

export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=internal.example.com

支持 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY。CLI 始终绕过 localhost、127.0.0.1 和 ::1，以保证登录回调和本地服务可用。

Skills 与 MCP

在 TUI 中：

/skills [filter]
/mcp [filter]

/skills 用于搜索可用 Skill，/mcp 用于搜索 MCP 配置。Skill 和 MCP 的具体可用项取决于当前数据目录、项目和宿主环境；先用 /doctor 检查配置，再用 /status 确认运行状态。从 0.4.5 起，支持联网搜索的模型直接使用内置搜索工具，无需单独配置搜索 MCP 服务。用户自行配置的 MCP 服务不受影响。

Plugin

Plugin 分为官方源和本地源：

mcode plugin marketplace list
mcode plugin list
mcode plugin list --available
mcode plugin marketplace upgrade

安装和管理：

mcode plugin add <plugin>@official
mcode plugin enable <plugin>@official
mcode plugin disable <plugin>@official
mcode plugin remove <plugin>@official

同名 Plugin 需要追加 @official 或 @local，也可以传入 -m, --marketplace official|local。脚本场景追加 --json。本地 Plugin 源位于数据目录下的 plugins 目录。

配置排查

mcode --version
mcode provider list --json
mcode plugin list --json

进入 TUI 后运行 /doctor 检查配置、/status 检查账号和模型、/model 检查可用模型。遇到认证问题时，确认当前使用的 minimaxModelSource 与登录或 API Key 配置一致。

​配置层级

​数据目录

​常用 Runtime 配置

​上下文容量与状态栏

​登录与 MiniMax 凭证

​自定义 Provider

​代理

​Skills 与 MCP

​Plugin

​配置排查