> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置与模型

> 配置 MiniMax Code CLI 的数据目录、账号来源、Provider、模型、代理、Skills、MCP 和 Plugin。

<div className="code-docs">
  本页说明 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 和其他运行数据。使用环境变量切换目录：

  ```bash theme={null}
  export MINIMAX_DATA_DIR=/path/to/mcode-data
  ```

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

  ```text theme={null}
  <data-dir>/config.yaml
  ```

  ## 常用 Runtime 配置

  ```yaml theme={null}
  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 凭证

  ```bash theme={null}
  mcode login
  mcode login --region global
  mcode logout
  ```

  中国大陆账号使用默认区域，Global 账号传入 `--region global`。

  运行 `mcode logout` 或 TUI 中的 `/logout` 会清理本地登录态，打印完整的浏览器登出链接，并尝试打开当前账号地区和环境对应的登出页。在开发机或无图形界面的环境中，可以复制屏幕上的链接到自己的浏览器打开。命令完成无需等待浏览器或页面结果。

  如果选择 Token Plan，CLI 会检查登录状态；如果选择 API Key，先设置环境变量：

  ```bash theme={null}
  export MCODE_PROVIDER_API_KEY="你的 MiniMax API Key"
  mcode provider set-minimax-key
  ```

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

  ## 自定义 Provider

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

  ```bash theme={null}
  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`

  常用管理命令：

  ```bash theme={null}
  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 支持以下代理环境变量及其小写形式：

  ```bash theme={null}
  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 中：

  ```text theme={null}
  /skills [filter]
  /mcp [filter]
  ```

  `/skills` 用于搜索可用 Skill，`/mcp` 用于搜索 MCP 配置。Skill 和 MCP 的具体可用项取决于当前数据目录、项目和宿主环境；先用 `/doctor` 检查配置，再用 `/status` 确认运行状态。

  从 0.4.5 起，支持联网搜索的模型直接使用内置搜索工具，无需单独配置搜索 MCP 服务。用户自行配置的 MCP 服务不受影响。

  ## Plugin

  Plugin 分为官方源和本地源：

  ```bash theme={null}
  mcode plugin marketplace list
  mcode plugin list
  mcode plugin list --available
  mcode plugin marketplace upgrade
  ```

  安装和管理：

  ```bash theme={null}
  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` 目录。

  ## 配置排查

  ```bash theme={null}
  mcode --version
  mcode provider list --json
  mcode plugin list --json
  ```

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