Skip to main content

Codex

Utilisez les modèles Alibaba Cloud Model Studio dans Codex.

Démarrage rapide

  1. 1

    Ouvrir ou créer le fichier de configuration

    • macOS / Linux : ~/.codex/config.toml
    • Windows : C:\Users\<username>\.codex\config.toml
  2. 2

    Configurer le modèle

    Pour passer d'un modèle à l'autre, consultez Configurer les métadonnées du modèle.
    • Token Plan
    • Paiement à l'usage
    • Coding Plan
    Remplacez OPENAI_API_KEY par votre clé API Token Plan :
    model_provider = "Token_Plan"
    model = "auto"
    
    [model_providers.Token_Plan]
    name = "Token_Plan"
    base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
    env_key = "OPENAI_API_KEY"
    wire_api = "responses"
    
  3. 3

    Vérifier

    Exécutez la commande suivante dans le répertoire de votre projet :
    codex exec "Hello"
    

Configurer les métadonnées du modèle

Les métadonnées du modèle permettent de passer d'un modèle à l'autre dans Codex. Sans cette configuration, le modèle spécifié dans config.toml fonctionne toujours, mais Codex affiche l'avertissement Model metadata ... not found au démarrage et utilise les métadonnées par défaut. Après la configuration, changez de modèle avec codex -m ou /model dans le TUI.
  • Token Plan Personal Edition
  • Token Plan Team Edition
  • Paiement à l'usage
Créez ~/.codex/model-catalog.local.json avec le contenu suivant :
{
  "models": [
    {
      "slug": "auto",
      "display_name": "auto",
      "description": "DashScope model: auto",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 1,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen4-max-preview",
      "display_name": "qwen4-max-preview",
      "description": "DashScope model: qwen4-max-preview",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 2,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen4-max",
      "display_name": "qwen4-max",
      "description": "DashScope model: qwen4-max",
      "default_reasoning_level": "high",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "high",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 2,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.8-max",
      "display_name": "qwen3.8-max",
      "description": "DashScope model: qwen3.8-max",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 3,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.8-flash",
      "display_name": "qwen3.8-flash",
      "description": "DashScope model: qwen3.8-flash",
      "default_reasoning_level": "xhigh",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 983616,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 4,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.7-max",
      "display_name": "qwen3.7-max",
      "description": "DashScope model: qwen3.7-max",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 5,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.7-plus",
      "display_name": "qwen3.7-plus",
      "description": "DashScope model: qwen3.7-plus",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 6,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "qwen3.6-flash",
      "display_name": "qwen3.6-flash",
      "description": "DashScope model: qwen3.6-flash",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 7,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "glm-5.3",
      "display_name": "glm-5.3",
      "description": "DashScope model: glm-5.3",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 8,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "glm-5.2",
      "display_name": "glm-5.2",
      "description": "DashScope model: glm-5.2",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 9,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4.1-flash",
      "display_name": "deepseek-v4.1-flash",
      "description": "DashScope model: deepseek-v4.1-flash",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 10,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4.1-flash-1017",
      "display_name": "deepseek-v4.1-flash-1017",
      "description": "DashScope model: deepseek-v4.1-flash-1017",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": true,
      "input_modalities": [
        "text",
        "image"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 11,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4-pro",
      "display_name": "deepseek-v4-pro",
      "description": "DashScope model: deepseek-v4-pro",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 12,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4-pro-0813",
      "display_name": "deepseek-v4-pro-0813",
      "description": "DashScope model: deepseek-v4-pro-0813",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 13,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    },
    {
      "slug": "deepseek-v4-flash-0731",
      "display_name": "deepseek-v4-flash-0731",
      "description": "DashScope model: deepseek-v4-flash-0731",
      "default_reasoning_level": "medium",
      "supported_reasoning_levels": [
        {
          "effort": "low",
          "description": "Fast responses with lighter reasoning"
        },
        {
          "effort": "medium",
          "description": "Balances speed and reasoning depth"
        },
        {
          "effort": "high",
          "description": "Greater reasoning depth for complex problems"
        },
        {
          "effort": "xhigh",
          "description": "Extra high reasoning depth for complex problems"
        }
      ],
      "context_window": 1000000,
      "effective_context_window_percent": 95,
      "supports_parallel_tool_calls": false,
      "supports_image_detail_original": false,
      "input_modalities": [
        "text"
      ],
      "shell_type": "default",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 14,
      "base_instructions": "",
      "support_verbosity": false,
      "supports_reasoning_summaries": false,
      "experimental_supported_tools": [],
      "truncation_policy": {
        "mode": "bytes",
        "limit": 10000
      }
    }
  ]
}
Ajoutez ce qui suit à ~/.codex/config.toml :
model_catalog_json = "~/.codex/model-catalog.local.json"
Après la configuration, spécifiez un modèle avec codex -m (par exemple, codex -m qwen3.8-flash) ou saisissez /model dans le TUI pour passer d'un modèle configuré à l'autre.
qwen4-max dispose d'un contexte de 1 M de tokens. La sortie maximale est de 131 072 tokens en mode sans réflexion et de 262 144 tokens pour la réflexion et la réponse finale combinées. Les valeurs par défaut sont reasoning_effort=high et thinking_budget=131072. Utilisez codex -m qwen4-max pour sélectionner le modèle.

Configuration de Chat Completions

Codex 0.94.0 et les versions ultérieures ne prennent en charge que l'API Responses. Si vous utilisez Codex 0.93.0 ou une version antérieure, ou si votre modèle ne prend en charge que Chat Completions, utilisez la configuration suivante. Pour le chemin du fichier de configuration, consultez Démarrage rapide.
  • Token Plan
  • Paiement à l'usage
  • Coding Plan
Remplacez OPENAI_API_KEY par votre clé API Token Plan :
model_provider = "Token_Plan"
model = "auto"

[model_providers.Token_Plan]
name = "Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

Utiliser CC Switch

CC Switch est une interface graphique de bureau open source développée par la communauté qui permet de basculer entre des clés API ou des plans de facturation.

Ajouter un fournisseur

  1. 1
    Dans la barre d'outils de CC Switch, sélectionnez l'icône Codex, cliquez sur + pour ouvrir Add provider, sélectionnez l'onglet correspondant à votre plan de facturation, renseignez la configuration, puis cliquez sur Add.
    • Token Plan
    • Paiement à l'usage
    • Coding Plan
    • Nom du fournisseur : Bailian-Token Plan
    • Clé API : Obtenir depuis la console
    • Endpoint : https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  2. 2
    Développez Advanced options et saisissez un modèle parmi les modèles pris en charge pour votre plan, par exemple qwen3.8-max.
  3. 3
    Cliquez sur Enable à côté du fournisseur, puis rouvrez le terminal et exécutez codex pour que la configuration prenne effet.

Codes d'erreur

Si vous rencontrez des erreurs lors de la configuration, consultez la FAQ correspondant à votre plan de facturation :

FAQ

Cet avertissement apparaît lorsque les métadonnées du modèle ne sont pas configurées. Codex utilise les métadonnées par défaut pour le modèle, et les appels ne sont pas affectés. Pour passer d'un modèle à l'autre, consultez Configurer les métadonnées du modèle.
La configuration du paiement à l'usage reste la même : utilisez la clé API générale Model Studio et l'URL de base. Après l'achat d'un plan d'économie, il prend effet automatiquement et l'utilisation éligible est déduite automatiquement. Consultez Plans d'économie.
Cause : Certains outils de gestion tiers (comme CC-Switch) envoient une sonde de contrôle d'état ou de test de connexion lors du changement de fournisseur. Le format de la sonde diffère du format de requête réellement utilisé par Codex ; la passerelle Model Studio peut donc renvoyer 400 Bad request et l'outil signale "domestic models not supported". Ce message indique uniquement que la sonde a échoué ; il ne signifie pas que Model Studio ne prend pas en charge les modèles de Chine continentale et n'affecte pas l'utilisation réelle de Codex.Solution : Configurez Codex directement dans ~/.codex/config.toml comme décrit dans Démarrage rapide, sans vous appuyer sur le contrôle d'état de l'outil tiers. Après la configuration, suivez l'étape Vérifier pour démarrer Codex ; une réponse normale indique que les modèles de Chine continentale fonctionnent.
Cause : Codex 0.94.0 et les versions ultérieures ne prennent plus en charge wire_api = "chat". Selon la version, l'une des erreurs suivantes peut apparaître :
  • wire_api = "chat" is no longer supported
  • unknown configuration field wire_api
Solution :
  • Erreur wire_api = "chat" is no longer supported : remplacez wire_api par responses et vérifiez base_url.
  • Erreur unknown configuration field wire_api : supprimez wire_api de la section du fournisseur correspondant dans ~/.codex/config.toml.
  • Pour continuer à utiliser Chat Completions, installez Codex 0.93.0 ou une version antérieure (par exemple 0.80.0).
Cause :
  • La clé API appartient à un autre plan (les clés API des plans Token Plan, Coding Plan et Paiement à l'usage ne sont pas interchangeables).
  • L'abonnement a expiré.
  • La clé API a été copiée de manière incorrecte (incomplète, espaces supplémentaires ou faute de frappe).
Solution :
  • Vérifiez que vous utilisez la clé API du plan sélectionné.
  • Consultez la page de gestion du plan pour vérifier l'expiration de l'abonnement.
  • Copiez à nouveau la clé API et assurez-vous qu'elle est complète et ne contient aucun espace.
  • Si l'erreur persiste, réinitialisez la clé API sur la page de gestion du plan et configurez la nouvelle clé.
Cause : La valeur de base_url ou de wire_api dans le fichier de configuration est incorrecte.Solution : Assurez-vous que base_url et wire_api correspondent à la configuration de votre plan. Consultez Démarrage rapide.
Cause : La connexion de streaming entre Codex et le serveur s'est fermée avant la fin de la réponse. Causes courantes :
  • Le fil de conversation est trop long et le compactage du contexte échoue.
  • Le réseau est instable et la connexion SSE ou WebSocket est interrompue.
  • Le serveur est surchargé ou la limitation de débit met fin prématurément à la connexion.
Solution :
  • Démarrez un nouveau fil de conversation pour éviter une accumulation excessive de contexte.
  • Vérifiez la stabilité du réseau. Désactivez le VPN ou le proxy et réessayez.
  • Attendez et réessayez. Codex dispose d'un mécanisme de nouvelle tentative intégré qui résout la plupart des échecs temporaires.
Cause : Une erreur 429 a deux causes courantes :
  • Limitation du débit des requêtes (429 Requests rate limit exceeded) : trop de requêtes sur une courte période.
  • Quota épuisé (429 Allocated quota exceeded ou Your token-plan quota has been exhausted) : le quota mensuel du Token Plan est épuisé.
Solution :
  • Limitation du débit des requêtes : attendez une minute et réduisez la fréquence des requêtes.
  • Quota épuisé : attendez le prochain mois d'abonnement, achetez un forfait d'utilisation (le quota est automatiquement déduit du forfait une fois le quota mensuel épuisé) ou mettez à niveau votre plan. L'heure de réinitialisation indiquée dans le message d'erreur (par exemple The quota will reset at HH:MM:SS UTC) est exprimée en UTC ; ajoutez 8 heures pour convertir en heure de Singapour (CST).