Aller au contenu
opencodex

Clients MiniMax

MiniMax publie deux produits distincts en ligne de commande. OpenCodex intègre chacun à la frontière du protocole qu’il expose réellement :

  • MiniMax Code (mcode) est un agent de programmation prenant en charge les fournisseurs Anthropic Messages personnalisés.
  • MiniMax CLI (mmx) est un CLI de plateforme multimodale. Seule sa ressource text utilise l’API compatible avec Anthropic qu’OpenCodex peut router.

MiniMax Code

Section intitulée « MiniMax Code »

Installez MiniMax Code et connectez-vous d’abord en suivant les instructions de MiniMax. Démarrez ensuite OpenCodex et activez l’intégration de fichier réversible :

Terminal window
ocx start
ocx integration client enable --client mcode
ocx mcode

Intégration MiniMax Code avec des données d’exemple isolées

L’intégration fusionne un bloc dans ~/.minimax/config.yaml :

custom_provider:
  opencodex:
    name: OpenCodex
    kind: custom
    enabled: true
    api: anthropic-messages
    options:
      apiKey: opencodex-loopback
      baseURL: http://127.0.0.1:10100
      authMode: api-key
    models:
      anthropic/claude-opus-5: {}

La liste de modèles réellement générée provient du catalogue OpenCodex actif. Le bloc n’écrit aucune clé réelle, ne remplace pas defaultModel et ne modifie pas votre connexion MiniMax. Dans MCode, choisissez un modèle sous custom_provider:opencodex/....

ocx mcode vérifie que ce fournisseur pointe vers le proxy actuellement actif avant de lancer le client. Si le port a changé, actualisez le bloc géré en relançant la commande d’activation. Désactivez-le ou restaurez-le au moyen du même système d’intégration audité :

Terminal window
ocx integration client disable --client mcode
ocx integration client history --client mcode
ocx integration client restore --op <opId> [--confirm-drift]

MINIMAX_DATA_DIR et l’ancienne variable MAVIS_DATA_DIR sont prises en charge. Les chemins relatifs sont refusés, car OpenCodex et MCode peuvent démarrer depuis des répertoires de travail différents.

MiniMax CLI (mmx)

Section intitulée « MiniMax CLI (mmx) »

Installez séparément le CLI officiel :

Terminal window
npm install -g mmx-cli
mmx --version

Routez une commande textuelle par OpenCodex en utilisant l’enveloppe et un identifiant de modèle OpenCodex :

Terminal window
ocx mmx text chat \
  --model anthropic/claude-opus-5 \
  --message "Explain this function"


ocx mmx --output json text chat \
  --model openai/gpt-5.6-sol \
  --message "Return a JSON summary"

MMX ajoute systématiquement /anthropic/v1/messages à son URL de base d’API. L’enveloppe démarre un pont local temporaire pendant la durée du processus enfant. Celui-ci accepte uniquement les requêtes POST vers ce chemin Messages et vers /anthropic/v1/messages/count_tokens, puis les associe aux plans de données /v1/messages et /v1/messages/count_tokens existants d’OpenCodex tout en préservant le corps et les paramètres des requêtes. La traduction canonique des requêtes OpenCodex, le suivi de l’utilisation et l’authentification configurée des fournisseurs en aval restent actifs ; les fournisseurs reçoivent x-api-key ou un jeton porteur selon leur configuration. La diffusion conserve les événements Anthropic de message et de contenu. Avant le transfert, le pont retire les en-têtes d’identification d’admission entrants et fixe la valeur publique temporaire opencodex-loopback. Aucune autre ressource Anthropic n’est transmise et le pont n’est jamais exposé au-delà de l’adresse locale.

L’enveloppe crée également un MMX_CONFIG_DIR temporaire qui ne contient que cette valeur publique, puis le supprime à la fermeture de mmx. Votre fichier ~/.mmx/config.json, vos jetons OAuth et votre clé d’API MiniMax ne sont jamais chargés ni copiés.

Les limites suivantes sont intentionnelles :

  • Seules les commandes text chat et text repl sont routées par OpenCodex.
  • L’enveloppe refuse --api-key, --base-url et --region afin que les identifiants ou les destinations fournis par l’appelant n’entrent pas en conflit avec le pont isolé.
  • Le pont est limité à l’adresse locale, car MMX ne peut pas envoyer l’en-tête d’admission dédié x-opencodex-api-key d’OpenCodex pour une liaison distante.
  • Utilisez directement mmx pour image, video, speech, music, vision, search, quota, auth, config, file et update ; ces ressources appellent des API propres à MiniMax qu’OpenCodex n’émule pas.

Le modèle textuel par défaut de mmx est MiniMax-M3. Fournissez --model <provider/model> pour cibler une route OpenCodex précise ; sinon, les règles normales de routage des modèles OpenCodex déterminent si l’identifiant par défaut est disponible.