Guide de configuration des fournisseurs

Ce guide couvre les instructions de configuration detaillees pour chaque fournisseur supporte par Claudex, incluant les fournisseurs par cle API, les abonnements OAuth, les plateformes cloud et les modeles locaux.

Fournisseurs par cle API

Anthropic

1. Inscrivez-vous sur console.anthropic.com
2. Naviguez vers API Keys et creez une nouvelle cle (format : sk-ant-*)

[[profiles]]
name = "anthropic"
provider_type = "DirectAnthropic"
base_url = "https://api.anthropic.com"
api_key = "sk-ant-..."
default_model = "claude-sonnet-4-20250514"

claudex profile test anthropic

MiniMax

1. Inscrivez-vous sur platform.minimaxi.com
2. Naviguez vers API Keys dans la console

[[profiles]]
name = "minimax"
provider_type = "DirectAnthropic"
base_url = "https://api.minimax.io/anthropic"
api_key = "..."
default_model = "claude-sonnet-4-20250514"

claudex profile test minimax

OpenRouter

1. Inscrivez-vous sur openrouter.ai
2. Obtenez votre cle API sur openrouter.ai/keys

[[profiles]]
name = "openrouter"
provider_type = "OpenAICompatible"
base_url = "https://openrouter.ai/api/v1"
api_key = "sk-or-..."
default_model = "anthropic/claude-sonnet-4"

claudex profile test openrouter

Astuce

OpenRouter supporte des centaines de modeles de differents fournisseurs. Utilisez le prefixe anthropic/ pour les modeles Claude.

Grok (xAI)

1. Inscrivez-vous sur console.x.ai
2. Creez une cle API dans la console

[[profiles]]
name = "grok"
provider_type = "OpenAICompatible"
base_url = "https://api.x.ai/v1"
api_key = "xai-..."
default_model = "grok-3-beta"

claudex profile test grok

OpenAI

1. Inscrivez-vous sur platform.openai.com
2. Creez une cle API sur platform.openai.com/api-keys

[[profiles]]
name = "chatgpt"
provider_type = "OpenAICompatible"
base_url = "https://api.openai.com/v1"
api_key = "sk-..."
default_model = "gpt-4o"

claudex profile test chatgpt

DeepSeek

1. Inscrivez-vous sur platform.deepseek.com
2. Creez une cle API dans la console

[[profiles]]
name = "deepseek"
provider_type = "OpenAICompatible"
base_url = "https://api.deepseek.com"
api_key = "sk-..."
default_model = "deepseek-chat"

claudex profile test deepseek

Kimi / Moonshot

1. Inscrivez-vous sur platform.moonshot.cn
2. Creez une cle API dans la console

[[profiles]]
name = "kimi"
provider_type = "OpenAICompatible"
base_url = "https://api.moonshot.ai/v1"
api_key = "sk-..."
default_model = "kimi-k2-0905-preview"

claudex profile test kimi

GLM / Zhipu

1. Inscrivez-vous sur open.bigmodel.cn
2. Creez une cle API dans la console

[[profiles]]
name = "glm"
provider_type = "OpenAICompatible"
base_url = "https://api.z.ai/api/paas/v4"
api_key = "..."
default_model = "glm-4.6"

claudex profile test glm

Groq

1. Inscrivez-vous sur console.groq.com
2. Creez une cle API dans Settings > API Keys

[[profiles]]
name = "groq"
provider_type = "OpenAICompatible"
base_url = "https://api.groq.com/openai/v1"
api_key = "gsk_..."
default_model = "llama-3.3-70b-versatile"

claudex profile test groq

Astuce

Groq fournit une inference extremement rapide pour les modeles open source. Les modeles populaires incluent llama-3.3-70b-versatile, mixtral-8x7b-32768 et gemma2-9b-it.

Mistral AI

1. Inscrivez-vous sur console.mistral.ai
2. Creez une cle API dans la console

[[profiles]]
name = "mistral"
provider_type = "OpenAICompatible"
base_url = "https://api.mistral.ai/v1"
api_key = "..."
default_model = "mistral-large-latest"

claudex profile test mistral

Together AI

1. Inscrivez-vous sur api.together.ai
2. Creez une cle API dans le tableau de bord

[[profiles]]
name = "together"
provider_type = "OpenAICompatible"
base_url = "https://api.together.xyz/v1"
api_key = "..."
default_model = "meta-llama/Llama-3.3-70B-Instruct-Turbo"

claudex profile test together

Perplexity

1. Inscrivez-vous sur perplexity.ai
2. Creez une cle API sur perplexity.ai/settings/api

[[profiles]]
name = "perplexity"
provider_type = "OpenAICompatible"
base_url = "https://api.perplexity.ai"
api_key = "pplx-..."
default_model = "sonar-pro"

claudex profile test perplexity

Note

Les modeles Perplexity integrent des capacites de recherche web. Utile pour les taches orientees recherche.

Cerebras

1. Inscrivez-vous sur cloud.cerebras.ai
2. Creez une cle API dans le tableau de bord

[[profiles]]
name = "cerebras"
provider_type = "OpenAICompatible"
base_url = "https://api.cerebras.ai/v1"
api_key = "..."
default_model = "llama-3.3-70b"

claudex profile test cerebras

Plateformes cloud

Azure OpenAI

1. Creez une ressource Azure OpenAI dans le portail Azure
2. Deployez un modele et notez le nom de la ressource et du deploiement
3. Obtenez votre cle API depuis Keys and Endpoint

[[profiles]]
name = "azure-openai"
provider_type = "OpenAICompatible"
base_url = "https://YOUR_RESOURCE.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT"
api_key = "YOUR_AZURE_KEY"
default_model = "gpt-4o"

[profiles.query_params]
api-version = "2024-12-01-preview"

claudex profile test azure-openai

Note

Azure OpenAI est auto-detecte par la presence de openai.azure.com dans la base_url. L’authentification utilise l’en-tete api-key au lieu de Authorization: Bearer. Le parametre de requete api-version est requis.

Google Vertex AI

1. Activez l’API Vertex AI dans votre projet GCP
2. Generez un token d’acces avec gcloud auth print-access-token

[[profiles]]
name = "vertex-ai"
provider_type = "DirectAnthropic"
base_url = "https://us-east5-aiplatform.googleapis.com/v1/projects/YOUR_PROJECT/locations/us-east5/publishers/anthropic/models"
api_key = "YOUR_GCLOUD_TOKEN"
default_model = "claude-sonnet-4@20250514"

claudex profile test vertex-ai

Attention

Le token gcloud auth print-access-token expire apres environ 1 heure. Pour une utilisation en production, envisagez un compte de service avec automatisation du rafraichissement de token.

AWS Bedrock (via LiteLLM)

AWS Bedrock est supporte via un proxy LiteLLM :

1. Installez LiteLLM : pip install litellm
2. Demarrez le proxy :

litellm --model bedrock/anthropic.claude-sonnet-4-20250514-v2:0

3. Configurez Claudex :

[[profiles]]
name = "bedrock"
provider_type = "OpenAICompatible"
base_url = "http://localhost:4000/v1"
api_key = "sk-litellm"
default_model = "bedrock/anthropic.claude-sonnet-4-20250514-v2:0"

Abonnements OAuth

L’authentification OAuth vous permet d’utiliser des abonnements fournisseurs existants (ChatGPT Plus, Claude Max, etc.) au lieu de cles API separees.

Claude Max / Pro

Utilisez votre abonnement Claude existant via la session OAuth native de Claude Code.

Prerequis : Claude Code installe et connecte (la commande claude fonctionne normalement)

[[profiles]]
name = "claude-max"
provider_type = "DirectAnthropic"
base_url = "https://api.claude.ai"
default_model = "claude-sonnet-4-20250514"
auth_type = "oauth"
oauth_provider = "claude"

[profiles.models]
haiku = "claude-haiku-4-20250514"
sonnet = "claude-sonnet-4-20250514"
opus = "claude-opus-4-20250514"

Note

Les profils OAuth Claude utilisent un mode gateway auth special. Claudex contourne le proxy et laisse Claude Code utiliser son propre OAuth directement. Aucune etape claudex auth login separee n’est necessaire.

ChatGPT Plus / Codex CLI

Utilisez votre abonnement ChatGPT Plus ou Pro via le token Codex CLI.

Prerequis : Installez Codex CLI et authentifiez-vous :

# Installer Codex CLI
npm install -g @openai/codex

# S'authentifier (ouvre le navigateur)
codex auth

Puis configurez Claudex :

[[profiles]]
name = "codex-sub"
provider_type = "OpenAIResponses"
base_url = "https://chatgpt.com/backend-api/codex"
default_model = "gpt-5.3-codex"
auth_type = "oauth"
oauth_provider = "openai"

[profiles.models]
haiku = "codex-mini-latest"
sonnet = "gpt-5.3-codex"
opus = "gpt-5.3-codex"

# Lire le token depuis Codex CLI
claudex auth login openai --profile codex-sub

# Verifier
claudex auth status

# Executer
claudex run codex-sub

Astuce

Modeles supportes sur l’endpoint Codex : gpt-5.3-codex, gpt-5.1-codex, codex-mini-latest. Notez que gpt-4o n’est PAS supporte sur l’endpoint Codex de chatgpt.com. strip_params = "auto" detectera automatiquement cet endpoint et supprimera temperature/top_p/top_k.

Google Gemini

Utilisez votre compte Google via les credentials du Gemini CLI.

[[profiles]]
name = "gemini-sub"
provider_type = "OpenAICompatible"
base_url = "https://generativelanguage.googleapis.com/v1beta/openai"
default_model = "gemini-2.5-pro"
auth_type = "oauth"
oauth_provider = "google"

[profiles.models]
haiku = "gemini-2.0-flash"
sonnet = "gemini-2.5-pro"
opus = "gemini-2.5-pro"

# La connexion lit depuis les credentials du Gemini CLI
claudex auth login google --profile gemini-sub

# Verifier
claudex auth status

Qwen / Tongyi Qianwen

Utilisez votre compte Qwen via le flux OAuth Device Code.

[[profiles]]
name = "qwen-oauth"
provider_type = "OpenAICompatible"
base_url = "https://chat.qwen.ai/api"
default_model = "qwen3-235b-a22b"
auth_type = "oauth"
oauth_provider = "qwen"

# Demarrer le flux device code
claudex auth login qwen --profile qwen-oauth

# Verifier
claudex auth status

Kimi / Moonshot (OAuth)

Utilisez votre compte Kimi via les credentials du Kimi CLI.

[[profiles]]
name = "kimi-oauth"
provider_type = "OpenAICompatible"
base_url = "https://api.moonshot.cn/v1"
default_model = "moonshot-v1-128k"
auth_type = "oauth"
oauth_provider = "kimi"

# La connexion lit depuis les credentials du Kimi CLI
claudex auth login kimi --profile kimi-oauth

# Verifier
claudex auth status

GitHub Copilot

Utilisez votre abonnement GitHub Copilot via le flux OAuth Device Code.

[[profiles]]
name = "copilot"
provider_type = "OpenAICompatible"
base_url = "https://api.githubcopilot.com"
default_model = "gpt-4o"
auth_type = "oauth"
oauth_provider = "github"

# Demarrer le flux device code (ouvre le navigateur pour la connexion GitHub)
claudex auth login github --profile copilot

# Verifier
claudex auth status

GitLab Duo

Utilisez votre abonnement GitLab Duo via un Personal Access Token.

[[profiles]]
name = "gitlab-duo"
provider_type = "OpenAICompatible"
base_url = "https://gitlab.com/api/v4/ai/llm/proxy"
default_model = "claude-sonnet-4-20250514"
auth_type = "oauth"
oauth_provider = "gitlab"

# Definissez votre token GitLab comme variable d'environnement
export GITLAB_TOKEN=glpat-...

# Connexion
claudex auth login gitlab --profile gitlab-duo

# Verifier
claudex auth status

Note

GitLab Duo necessite une variable d’environnement GITLAB_TOKEN avec un Personal Access Token ayant le scope ai_features. Pour les instances GitLab auto-hebergees, mettez a jour base_url en consequence.

Modeles locaux

Ollama

1. Installez Ollama : ollama.com
2. Telechargez un modele :

ollama pull qwen2.5:72b

3. Configurez Claudex :

[[profiles]]
name = "local-qwen"
provider_type = "OpenAICompatible"
base_url = "http://localhost:11434/v1"
api_key = ""
default_model = "qwen2.5:72b"

claudex profile test local-qwen

Note

Ollama ne necessite pas de cle API. Laissez api_key vide ou omettez-le.

vLLM

1. Installez et demarrez vLLM :

pip install vllm
vllm serve meta-llama/Llama-3.3-70B-Instruct --port 8000

2. Configurez Claudex :

[[profiles]]
name = "local-llama"
provider_type = "OpenAICompatible"
base_url = "http://localhost:8000/v1"
api_key = ""
default_model = "meta-llama/Llama-3.3-70B-Instruct"

LM Studio

1. Telechargez LM Studio depuis lmstudio.ai
2. Chargez un modele et demarrez le serveur local (port par defaut : 1234)

[[profiles]]
name = "lm-studio"
provider_type = "OpenAICompatible"
base_url = "http://localhost:1234/v1"
api_key = "lm-studio"
default_model = "local-model"

Verification de votre configuration

Apres avoir configure un fournisseur, verifiez la connectivite :

# Tester un profil specifique
claudex profile test <profile-name>

# Tester tous les profils
claudex profile test all

# Lister tous les profils configures
claudex profile list