# How to use MiniMax Code with Subconscious

> To use MiniMax Code with Subconscious, install the mcode CLI, then run `mcode provider add` with base URL `https://api.subconscious.dev/v1`, API format `openai-completions`, model `subconscious/glm-5.3-marathon`, and `--api-key-env SUBCONSCIOUS_API_KEY`. Start mcode and it runs on Subconscious, billed per token.

Canonical page: https://www.subconscious.dev/agents/terminal-and-ide/minimax-code
Category: [Terminal and IDE agents](https://www.subconscious.dev/agents/terminal-and-ide)
Last verified: 2026-09-30
MiniMax Code: https://agent.minimax.io

## Before you start

- macOS, Linux or Windows with a terminal
- A Subconscious account and API key

## Set up MiniMax Code

### 1. Install the MiniMax Code CLI

The official install script puts the mcode command on your PATH.

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

### 2. Create a Subconscious API key

Sign in at https://platform.subconscious.dev, create an API key, and export it so the tool can read it.

```bash
export SUBCONSCIOUS_API_KEY="your_key"
```

### 3. Add Subconscious as a provider

--use makes it the active provider. Without --api-key-env, mcode reads the key from MCODE_PROVIDER_API_KEY.

```bash
mcode provider add --name "Subconscious" \
  --base-url "https://api.subconscious.dev/v1" \
  --api-format openai-completions \
  --model "subconscious/glm-5.3-marathon" \
  --api-key-env SUBCONSCIOUS_API_KEY --use
```

### 4. Start mcode

Run mcode, then /status to confirm the Subconscious provider is active.

```bash
mcode
```

## Connection details

- OpenAI-compatible base URL: https://api.subconscious.dev/v1
- Anthropic-compatible base URL: https://api.subconscious.dev
- API key: From subc login or the Subconscious dashboard
- Model: subconscious/glm-5.3-marathon
- Multimodal, high-throughput model: subconscious/deepseek-v4.1-flash-marathon

Full API reference: https://docs.subconscious.dev

## Frequently asked questions

### How do I use Subconscious in the MiniMax Code desktop app?

Open Settings, then Usage & model, and choose Add model under Custom model. Pick Others, enter a provider name, the base URL https://api.subconscious.dev/v1, your API key and the model ID, then save, run the connectivity test and select the model.

### Which Subconscious model should I use with MiniMax Code?

Start with subconscious/glm-5.3-marathon, an open frontier coding model built for long agent runs. subconscious/deepseek-v4.1-flash-marathon is a cheaper, high-throughput alternative that also takes image input. Use the full model ID, including the subconscious/ prefix.

### Is MiniMax Code on Subconscious OpenAI- or Anthropic-compatible?

This guide connects MiniMax Code through the OpenAI-compatible Subconscious API. Subconscious serves both formats: OpenAI Chat Completions at https://api.subconscious.dev/v1 and Anthropic Messages at https://api.subconscious.dev.

### How is MiniMax Code usage on Subconscious billed?

Per token by default, with no commitment. Heavy users can switch to a monthly token plan: a fixed price for a large daily token allowance shared across your team.