# MiniMax Code

来源: https://docs.aicentos.com/clients/minimax-code

Language: zh-CN

> 在 MiniMax Code（mcode）里接入 aicentos —— 用 provider add 加一个 OpenAI 兼容 provider

MiniMax Code 是 MiniMax 官方的编码 CLI（命令 `mcode`），自带 TUI、headless 执行、ACP 和 TypeScript SDK。它支持 BYOK：可以用 `mcode provider add` 挂任意 OpenAI 兼容端点。

## 准备工作

先在控制台为 MiniMax Code 建一个专用 Key（建议命名 `minimax-code`），然后安装：

```bash
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash
```

也可以走 npm：

```bash
npm install -g @minimax-ai/code@latest
mcode --version
```

## 需要填写的配置

| 字段              | 值                         |
| --------------- | ------------------------- |
| provider 名      | 自取，例如 `aicentos`          |
| `--base-url`    | `https://aicentos.com/v1` |
| `--api-format`  | `openai-completions`      |
| `--model`       | 控制台「模型广场」中的模型名            |
| `--api-key-env` | `MCODE_PROVIDER_API_KEY`  |

## 配置步骤

一条命令注册并切过去：

```bash
export MCODE_PROVIDER_API_KEY="sk-你的-API-Key"

mcode provider add \
  --name aicentos \
  --base-url https://aicentos.com/v1 \
  --api-format openai-completions \
  --model 你的模型名 \
  --api-key-env MCODE_PROVIDER_API_KEY \
  --use
```

`--use` 表示注册完立刻切到这个 provider。它会把配置写进当前 profile 的 `config.yaml`（默认数据目录 `~/.minimax`）的 `custom_provider` 段，等价写法：

```yaml
custom_provider:
  aicentos:
    options:
      apiKey: sk-你的-API-Key
      baseURL: https://aicentos.com/v1
    models:
      你的模型名: {}
```

注意这里的键是 `baseURL`（大写 URL），不是 `base-url`。

## 测试

```bash
mcode exec "用一句话自我介绍"
```

headless 能返回即说明配置生效。再进 TUI 跑一轮真实任务，最后回控制台核对用量。

## 注意事项

* 自定义模型要显式给上下文与输出上限（`--context-limit`、`--output-limit`），否则它按默认值裁剪，长文件容易被截断。
* 一键安装脚本不支持 Alpine / musl，这类环境改用 npm 安装。
* 想走 Anthropic 兼容协议做中转时，请求里仍会附带 `x-api-key`，上游若只认 `Authorization` 需要自己加一层转换。
* provider 是**按 profile** 存的，切换 profile 后要重新确认当前生效的是哪一条。

## 相关链接

* [MiniMax Code 快速开始](https://agent.minimax.io/docs/cli/quick-start)
* [minimax-code 仓库](https://github.com/MiniMax-AI/minimax-code)