GpcClaude
KEYWORDS: GPCCLAUDE, PCCLAUDE
Le 15/11/2026:
gpcClaude
Version : 1.06 (livré avec pcClaude V1.06) — Date : 15/11/2026
Lanceur graphique (Qt6 Widgets) de pcClaude. On choisit un LLM dans une liste, on règle quelques paramètres de session, puis gpcClaude lance pcClaude --provider ... dans un terminal graphique.
Fonctionnement
- Liste des LLM : HAL (llama-server local), OpenRouter (gpt-oss-120b par défaut) et chaque section de
~/.config/pcClaude/providers.conf(variablePCCLAUDE_PROVIDERSou option--providerspour un autre fichier). L'ordre est celui du fichier (stable) ; un clic sur un en-tête de colonne trie. - Prix et fenêtres : lus en direct à chaque lancement sur
GET https://openrouter.ai/api/v1/models(public) : prix d'entrée et de sortie en $ par million de tokens, et fenêtre de contexte réelle. Aucun prix de repli : un modèle absent du catalogue afficheinconnu(jamais 0). - Budget restant : le plus petit du solde du compte (
/credits: total_credits − total_usage) et du plafond de la clé (/key: limit_remaining). La clé est cherchée dans la variable d'environnementOPENROUTER_API_KEY(prioritaire), puis dans le secretopenrouterdu coffre pcSecretd ; sinon « indisponible » (jamais 0). L'origine de la clé (« fournie par pcSecretd » ou « fournie par la variable d'environnement ») est affichée à côté du budget, et dans son infobulle. - Estimation du coût : sous la liste, un bandeau donne le coût d'une requête à contexte plein (entrée seule) et sa part du budget. Il passe en alerte (bordure rouge) si ce coût dépasse 25 % du budget ou si le contexte dépasse la fenêtre réelle du modèle. Au lancement, une confirmation est demandée si un contexte plein dépasserait le budget restant.
- Réglages (seuls ceux qui s'appliquent au LLM choisi sont affichés) :
- Répertoire de travail de la session (mémorisé, 10 derniers) ;
- Modèle (option) :
--model; - Contexte maximal :
--max-context(LLM distants) ; - Seuil d'alerte du contexte :
--context-alert-threshold(HAL), transmis seulement s'il diffère de 75 % ; - Serveur HAL :
--host/--port; - Filtre ZDR :
--zdr(LLM distants) ; - Terminal : sakura (défaut s'il est installé), mate-terminal, gnome-terminal, xfce4-terminal, konsole, xterm ou x-terminal-emulator (ceux qui sont installés) ;
- « Fermer gpcClaude après le lancement ».
- Lancement : le terminal exécute
bash -cautour de pcClaude. Si pcClaude se termine avec une erreur, le terminal reste ouvert (Entrée pour fermer) afin de lire le message. - Thèmes : menu Thème (plus de 40 thèmes lisibles testés, thèmes personnalisés, Ctrl+T), identique à gpcSecret.
Aucune clé d'API ne figure dans la ligne de commande (visible par ps).
Avantages
- Les coûts sont visibles avant de lancer : prix réels, budget réel, coût d'un contexte plein.
- Aucune valeur de repli qui fausserait l'appréciation des coûts.
- Ordre de la liste stable (contrairement au menu texte de pcClaude, trié par prix).
- Logique hors interface (
ClassProviderCatalog,ClassOpenRouterInfo,ClassSessionLauncher) et testée :ctestdans le répertoire de build.
Défauts et limites
- Budget : exige que la clé soit lisible (variable
OPENROUTER_API_KEYou coffre pcSecretd, root uniquement, daemon démarré et déverrouillé). Sinon « indisponible ». La clé est relue à chaque actualisation (F5). - Environnement : les terminaux à instance unique (mate-terminal, gnome-terminal) peuvent ne pas transmettre l'environnement de gpcClaude à la session ; pcClaude retombe alors sur le coffre pcSecretd (la clé reste donc trouvée).
- Version de pcClaude : gpcClaude s'appuie sur les options de pcClaude V1.06 (
--provider,--max-context,--zdr...). - Le lancement réel dans sakura ou mate-terminal n'est testé automatiquement qu'avec un faux terminal ; le rendu a été vérifié par captures hors écran.
- Interface en français uniquement : l'internationalisation (.po,
--language) n'est pas faite. - Les prix sont ceux de l'entrée ; le coût réel d'une session dépend aussi de la sortie et du cache de prompt.
Syntaxe
gpcClaude [--provider ID] [--providers FICHIER] [--pcclaude CHEMIN]
[--dry-run] [--theme ID] [--list-themes] [-h|--help]
Build
apt install qt6-base-dev cmake g++ libcurl4-openssl-dev nlohmann-json3-dev libboost-dev cd build && cmake .. && make ctest --output-on-failure
Qt6 est optionnel : sans lui, seul pcClaude est construit.
Options
(aucune)
Ouvre la fenêtre de choix.
Exemple : gpcClaude
--provider ID
Présélectionne un LLM : hal, openrouter ou l'identifiant d'une section de providers.conf.
Exemple : gpcClaude --provider grok_4_7
--providers FICHIER
Fichier providers.conf à lire (défaut : $PCCLAUDE_PROVIDERS, sinon ~/.config/pcClaude/providers.conf).
Exemple : gpcClaude --providers /tmp/essai.conf
--pcclaude CHEMIN
Exécutable pcClaude à lancer (défaut : PATH, puis /home/local/bin/pcClaude).
Exemple : gpcClaude --pcclaude build/pcClaude
--dry-run
Affiche la commande pcClaude (sur la sortie standard et dans une boîte de dialogue) au lieu de lancer le terminal. Utile pour vérifier les réglages.
Exemple : gpcClaude --dry-run
--theme ID
Thème visuel (mémorisé ensuite).
Exemple : gpcClaude --theme neon
--list-themes
Liste les thèmes disponibles et quitte.
Exemple : gpcClaude --list-themes
-h, --help
Affiche l'aide et quitte.
Exemple : gpcClaude --help
Pièges
- Un contexte maximal élevé laisse la conversation grossir avant compactage : chaque requête renvoie tout le contexte, facturé en entrée.
- Un LLM de providers.conf dont l'identifiant de modèle n'existe pas au catalogue OpenRouter affiche « inconnu » et ne fonctionnera pas à l'usage.