# MiniMax Code

來源: https://docs.aicentos.com/zh-TW/clients/minimax-code

Language: zh-TW

> 在 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)