GpcClaude

De wiki_pcwiki2
Version datée du 15 novembre 2026 à 16:38 par Pchevalier (discussion | contributions) (Page créée avec « 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 <code>pcClaude --provider ...</code> dans un terminal graphique. == Fonctionnement == * '''Liste des LLM''' : HAL (llama-server local), OpenRouter (gpt-oss-120b par défaut... »)
(diff) ← Version précédente | Version actuelle (diff) | Version suivante → (diff)
Aller à la navigationAller à la recherche

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 (variable PCCLAUDE_PROVIDERS ou option --providers pour 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 affiche inconnu (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'environnement OPENROUTER_API_KEY (prioritaire), puis dans le secret openrouter du 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 -c autour 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 : ctest dans le répertoire de build.

Défauts et limites

  • Budget : exige que la clé soit lisible (variable OPENROUTER_API_KEY ou 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.