coding-agent-telegram 2026.4.7__tar.gz → 2026.7.18__tar.gz

{coding_agent_telegram-2026.4.7 → coding_agent_telegram-2026.7.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-agent-telegram
-Version: 2026.4.7
+Version: 2026.7.18
 Summary: Telegram bot bridge for local coding agents (Codex/Copilot CLI)
 Author: DCHA
 License: MIT
@@ -49,14 +49,14 @@ Dynamic: license-file
    ## ✨ Why Use It
    - ✅ Lightweight: no heavy frameworks, full transparency
    - ✅ Multi-bot: multiple chats, multiple sessions
-   - ✅ Use Telegram to control Codex / Copilot CLI
+   - ✅ Use Telegram to control Codex / Copilot / Claude Code CLI
    - ✅ Easily review files changed by agent in code block
    - ✅ Queue follow-up messages while the agent is working
    - ✅ Accept ✏️ Text, 🌄 Image, and 🎙️ Voice messages
 
    ## 🔁 Seamless Device/Session Switching
    
-   Start a session on Telegram, later on you can still continue the same Codex/Copilot CLI session on your computer, and switch back again without hassle.
+   Start a session on Telegram, later on you can still continue the same Codex/Copilot/Claude Code CLI session on your computer, and switch back again without hassle.
    
    - Use `/switch` in Telegram to continue a local session
    - Support historical sessions
@@ -100,6 +100,7 @@ curl -fsSL https://raw.githubusercontent.com/daocha/coding-agent-telegram/main/i
    - Existing folders can require trust before mutating git operations
    - The server does not make hidden external calls. Everything stays under your control.
    - Works well with Codex Sandbox mode (you don't have to grant `danger-full-access`)
+   - Claude Code integration supports configurable permission modes and tool allow/deny lists
    </td>
    <td width="35%" valign="top">
       
@@ -110,15 +111,74 @@ curl -fsSL https://raw.githubusercontent.com/daocha/coding-agent-telegram/main/i
    - Python 3.9 or newer
    - Telegram bot token created from _@BotFather_
    - Your Telegram chat ID
-   - Codex CLI and/or Copilot CLI installed locally
-   - [Codex CLI install](https://developers.openai.com/codex/cli) / [Copilot CLI install](https://github.com/features/copilot/cli)
+   - Codex CLI and/or Copilot CLI and/or Claude Code CLI installed locally
+   - [Codex CLI install](https://developers.openai.com/codex/cli) / [Copilot CLI install](https://github.com/features/copilot/cli) / [Claude Code CLI install](https://code.claude.com/docs/en/quickstart)
    - [Optional] `Whisper`, `ffmpeg`
    </td>
    </tr>
 </table>
 
 ## 🦞 Why do I need it if I have Openclaw already?
-Openclaw offers you full capabilities and has integrated agent loop called Pi-Agent. It's quite comprehensive and designed for more diversified use cases. I am also Openclaw lover and I used to code with Openclaw. However, that is not the best choice for coding due to the built in large system prompt and context. Using Claude Code / Codex / Copilot for coding is still more effecient, accurate, less distracted, and straightforward. This project is quite simple, purely integrating with Codex / Copilot CLI. So you are directly delegating Codex / Copilot to work for you.
+Openclaw offers you full capabilities and has integrated agent loop called Pi-Agent. It's quite comprehensive and designed for more diversified use cases. I am also Openclaw lover and I used to code with Openclaw. However, that is not the best choice for coding due to the built in large system prompt and context. Using Claude Code / Codex / Copilot for coding is still more effecient, accurate, less distracted, and straightforward. This project is quite simple, purely integrating with Codex / Copilot / Claude Code CLI. So you are directly delegating Codex / Copilot / Claude Code to work for you.
+
+## 🆚 Why do I need it if I have Claude Code + Telegram Plugin already?
+
+| Capability | Claude Code + Official Telegram Plugin | coding-agent-telegram (with Claude support) |
+|------------|-----------------------------------------|---------------------------------------------|
+| Telegram chat with AI | ✅ | ✅ |
+| Edit local code and run commands | ✅ | ✅ |
+| Requires an already-running CLI session | **Yes** | **No** (automatically starts or resumes sessions) |
+| Multiple AI providers | ❌ Claude only | ✅ Claude Code, Codex CLI, GitHub Copilot CLI |
+| Project management from Telegram | ❌ | ✅ `/project` |
+| Branch management from Telegram | Manual Git commands | ✅ `/branch` workflow |
+| Create and switch sessions | Limited to active Claude session | ✅ `/new`, `/switch`, `/current`, `/compact` |
+| Resume existing local CLI sessions | ❌ | ✅ |
+| Cross-device session continuity | Limited | ✅ |
+| Workspace concurrency protection | ❌ | ✅ Prevents multiple agents from editing the same project simultaneously |
+| Task queue while an agent is busy | ❌ | ✅ |
+| Independent filesystem snapshot & diff | ❌ | ✅ |
+| View structured file diffs in Telegram | ❌ | ✅ |
+| Secret / sensitive diff filtering | ❌ | ✅ |
+| Built-in Git workflow (pull / push / commit) | Manual | ✅ |
+| Multi-bot support | Multiple instances required | ✅ Managed by a single server |
+| Project-level state management | ❌ | ✅ |
+| Provider-agnostic architecture | ❌ | ✅ |
+
+> **Key difference**
+>
+> The official Claude Code Telegram plugin connects Telegram to **one already-running Claude Code session**.
+>
+> **coding-agent-telegram** acts as a **Telegram control plane** that manages projects, branches, sessions, Git workflows, and multiple coding agents (Claude Code, Codex CLI, GitHub Copilot CLI) from a single interface.
+
+### 🏛️ Architecture
+
+#### Claude Code + Telegram Plugin
+
+```text
+Telegram
+    │
+    ▼
+Claude Code Channel
+    │
+    ▼
+One running Claude Code session
+```
+
+#### coding-agent-telegram
+
+```text
+Telegram
+    │
+    ▼
+coding-agent-telegram
+    │
+    ├── Claude Code
+    ├── Codex CLI
+    └── GitHub Copilot CLI
+           │
+           ▼
+Project • Branch • Session • Queue • Git • Diff • Secret Filter
+```
 
 ## 🚀 Quick Start
 
@@ -228,7 +288,7 @@ The bot currently accepts:
 - Text messages
 - photos
 - voice messages when `ENABLE_OPENAI_WHISPER_SPEECH_TO_TEXT=true` and local Whisper prerequisites are installed
-- Codex and Copilot currently supports text and image only, video is not supported.
+- Codex and Claude Code sessions support text and image; Copilot sessions currently support text only. Video is not supported by any provider.
 
 ## 🤖 Telegram Commands
 
@@ -259,7 +319,7 @@ The bot currently accepts:
   </tr>
   <tr>
     <td><code>/switch</code></td>
-    <td>Show the latest sessions, newest first. The list includes both bot-managed sessions and local Codex/Copilot CLI sessions for the current project.</td>
+    <td>Show the latest sessions, newest first. The list includes both bot-managed sessions and local Codex/Copilot/Claude Code CLI sessions for the current project.</td>
   </tr>
   <tr>
     <td><code>/switch page &lt;number&gt;</code></td>
@@ -337,13 +397,21 @@ The bot currently accepts:
     <td width="332"><code>APP_LOCALE</code></td>
     <td>UI locale for shared bot messages and command descriptions. Supported values: <code>en</code>, <code>de</code>, <code>fr</code>, <code>ja</code>, <code>ko</code>, <code>nl</code>, <code>th</code>, <code>vi</code>, <code>zh-CN</code>, <code>zh-HK</code>, <code>zh-TW</code>.</td>
   </tr>
+  <tr>
+    <td><code>DEFAULT_AGENT_PROVIDER</code></td>
+    <td>Default provider for new sessions: <code>codex</code>, <code>copilot</code>, or <code>claude</code>. Default: <code>codex</code>.</td>
+  </tr>
   <tr>
     <td><code>CODEX_BIN</code></td>
-    <td>Command used to launch Codex CLI. Default: <code>codex</code>.</td>
+    <td>Command used to launch Codex CLI. The app would try to detect the locally installed Codex path when initializing the <code>.env_coding_agent_telegram</code>. Alternatively use <code>which codex</code> to view the path. </td>
   </tr>
   <tr>
     <td><code>COPILOT_BIN</code></td>
-    <td>Command used to launch Copilot CLI. Default: <code>copilot</code>.</td>
+    <td>Command used to launch Copilot CLI. The app would try to detect the locally installed Copilot path when initializing the <code>.env_coding_agent_telegram</code>. Alternatively use <code>which copilot</code> to view the path. </td>
+  </tr>
+  <tr>
+    <td><code>CLAUDE_BIN</code></td>
+    <td>Command used to launch Claude Code CLI. The app would try to detect the locally installed Claude path when initializing the <code>.env_coding_agent_telegram</code>. Alternatively use <code>which claude</code> to view the path. </td>
   </tr>
   <tr>
     <td><code>CODEX_MODEL</code></td>
@@ -361,6 +429,14 @@ The bot currently accepts:
     <a href="https://docs.github.com/en/copilot/reference/ai-models/supported-models" target="_blank">GitHub Copilot supported models</a>
     </td>
   </tr>
+  <tr>
+    <td><code>CLAUDE_MODEL</code></td>
+    <td>Optional Claude Code model override.
+    Leave empty to use the Claude Code CLI default model.
+    Examples: <code>sonnet</code>, <code>opus</code>, <code>haiku</code>
+    <a href="https://code.claude.com/docs/en/model-config" target="_blank">Claude Code model configuration</a>
+    </td>
+  </tr>
   <tr>
     <td><code>CODEX_APPROVAL_POLICY</code></td>
     <td>Approval mode passed to Codex. Default: <code>never</code>.</td>
@@ -373,6 +449,18 @@ The bot currently accepts:
     <td><code>CODEX_SKIP_GIT_REPO_CHECK</code></td>
     <td>If enabled, always bypass Codex trusted-repo checks.</td>
   </tr>
+  <tr>
+    <td><code>CLAUDE_PERMISSION_MODE</code></td>
+    <td>Permission mode passed to Claude Code. One of <code>default</code>, <code>acceptEdits</code>, <code>plan</code>, <code>auto</code>, <code>dontAsk</code>, <code>bypassPermissions</code>, <code>manual</code>. Default: <code>bypassPermissions</code> (fully autonomous, since there is no interactive terminal to approve prompts).</td>
+  </tr>
+  <tr>
+    <td><code>CLAUDE_ALLOWED_TOOLS</code></td>
+    <td>Comma-separated Claude Code tool allowlist, using Claude Code's permission rule syntax. Example: <code>Read,Edit,Bash(git *)</code></td>
+  </tr>
+  <tr>
+    <td><code>CLAUDE_DISALLOWED_TOOLS</code></td>
+    <td>Comma-separated Claude Code tool denylist. Example: <code>Bash(rm *)</code></td>
+  </tr>
   <tr>
     <td><code>ENABLE_COMMIT_COMMAND</code></td>
     <td>Enable the <code>/commit</code> Telegram command. Default: <code>false</code>.</td>
@@ -454,8 +542,10 @@ ALLOWED_CHAT_IDS=123456789
 DEFAULT_AGENT_PROVIDER=codex
 CODEX_BIN=codex
 COPILOT_BIN=copilot
+CLAUDE_BIN=claude
 CODEX_APPROVAL_POLICY=never
 CODEX_SANDBOX_MODE=workspace-write
+CLAUDE_PERMISSION_MODE=bypassPermissions
 ENABLE_SENSITIVE_DIFF_FILTER=true
 ENABLE_SECRET_SCRUB_FILTER=true
 ```
@@ -521,7 +611,7 @@ If the current run is aborted and there are queued questions waiting, the bot do
 
 ## ⚠️ Diff (file changes)
 
-_During each agent run, the bot also takes a lightweight before/after project snapshot so it can summarize changed files and send diffs back to Telegram. This snapshot is taken by the bot app itself, not by Codex or Copilot._
+_During each agent run, the bot also takes a lightweight before/after project snapshot so it can summarize changed files and send diffs back to Telegram. This snapshot is taken by the bot app itself, not by Codex, Copilot, or Claude Code._
 
 **Snapshot notes:**
 

{coding_agent_telegram-2026.4.7 → coding_agent_telegram-2026.7.18}/README.de.md

@@ -35,14 +35,14 @@
    ## ✨ Warum dieses Projekt
   - ✅ Leichtgewichtig: keine schweren Frameworks, volle Transparenz
   - ✅ Multi-Bot: mehrere Chats, mehrere Sessions
-  - ✅ Telegram zum Steuern von Codex / Copilot CLI verwenden
+  - ✅ Telegram zum Steuern von Codex / Copilot / Claude Code CLI verwenden
   - ✅ Antworten und geänderte Dateien bequem in Code-Blöcken prüfen
   - ✅ Folgefragen während eines laufenden Agentenlaufs in die Queue stellen
   - ✅ Akzeptiert ✏️ Text-, 🌄 Bild- und 🎙️ Sprachnachrichten
 
    ## 🔁 Nahtlos zwischen Geräten und Sessions wechseln
 
-  Starte eine Session in Telegram und setze dieselbe Codex/Copilot CLI-Session später ohne Umwege am Computer fort. Mit `/switch` kannst du auch wieder sauber von Telegram zurück ins Terminal wechseln.
+  Starte eine Session in Telegram und setze dieselbe Codex/Copilot/Claude Code CLI-Session später ohne Umwege am Computer fort. Mit `/switch` kannst du auch wieder sauber von Telegram zurück ins Terminal wechseln.
   
   - Nutze `/switch`, um eine lokale Session weiterzuführen
   - Historische Sessions werden ebenfalls unterstützt
@@ -86,6 +86,7 @@ curl -fsSL https://raw.githubusercontent.com/daocha/coding-agent-telegram/main/i
 - Bestehende Ordner können vor schreibenden Git-Operationen eine Vertrauensbestätigung verlangen
 - Der Server führt keine versteckten externen Aufrufe aus. Alles bleibt unter deiner Kontrolle.
 - Funktioniert gut mit dem Codex Sandbox mode; du musst `danger-full-access` nicht freigeben
+- Die Claude Code-Integration unterstützt konfigurierbare Permission-Modi sowie Allow-/Deny-Listen für Tools
    </td>
    <td width="35%" valign="top">
 
@@ -96,16 +97,74 @@ Vor dem Start des Servers brauchst du:
 - Python 3.9 oder neuer
 - Einen Telegram-Bot-Token von _@BotFather_
 - Deine Telegram-Chat-ID
-- Lokal installiertes Codex CLI und/oder Copilot CLI
-- [Codex CLI Installation](https://developers.openai.com/codex/cli)
-- [Copilot CLI Installation](https://github.com/features/copilot/cli)
+- Lokal installiertes Codex CLI und/oder Copilot CLI und/oder Claude Code CLI
+- [Codex CLI Installation](https://developers.openai.com/codex/cli) / [Copilot CLI Installation](https://github.com/features/copilot/cli) / [Claude Code CLI Installation](https://code.claude.com/docs/en/quickstart)
 - [Optional] Whisper, ffmpeg
    </td>
    </tr>
 </table>
 
 ## 🦞 Warum brauche ich das, wenn ich Openclaw bereits habe?
-Openclaw bietet dir sehr umfassende Funktionen und hat mit Pi-Agent bereits eine integrierte Agent-Loop. Es ist vielseitig und für breitere Einsatzfälle gedacht. Ich mag Openclaw ebenfalls und habe selbst damit entwickelt. Für Coding ist es aber nicht immer die beste Wahl, weil der eingebaute große System-Prompt und der zusätzliche Kontext eher ablenken können. Claude Code / Codex / Copilot sind fürs Coding oft effizienter, präziser, weniger abgelenkt und direkter. Dieses Projekt bleibt bewusst einfach und integriert nur Codex / Copilot CLI. Du delegierst also direkt an Codex / Copilot.
+Openclaw bietet dir sehr umfassende Funktionen und hat mit Pi-Agent bereits eine integrierte Agent-Loop. Es ist vielseitig und für breitere Einsatzfälle gedacht. Ich mag Openclaw ebenfalls und habe selbst damit entwickelt. Für Coding ist es aber nicht immer die beste Wahl, weil der eingebaute große System-Prompt und der zusätzliche Kontext eher ablenken können. Claude Code / Codex / Copilot sind fürs Coding oft effizienter, präziser, weniger abgelenkt und direkter. Dieses Projekt bleibt bewusst einfach und integriert nur Codex / Copilot / Claude Code CLI. Du delegierst also direkt an Codex / Copilot / Claude Code.
+
+## 🆚 Warum brauche ich coding-agent-telegram, wenn ich bereits Claude Code + Telegram Plugin habe?
+
+| Funktion | Claude Code + offizielles Telegram Plugin | coding-agent-telegram (mit Claude-Unterstützung) |
+|----------|--------------------------------------------|--------------------------------------------------|
+| KI-Chat über Telegram | ✅ | ✅ |
+| Lokalen Code bearbeiten und Befehle ausführen | ✅ | ✅ |
+| Erfordert eine bereits laufende CLI-Sitzung | **Ja** | **Nein** (startet oder setzt Sitzungen automatisch fort) |
+| Unterstützung mehrerer KI-Anbieter | ❌ Nur Claude | ✅ Claude Code, Codex CLI, GitHub Copilot CLI |
+| Projektverwaltung über Telegram | ❌ | ✅ `/project` |
+| Branch-Verwaltung über Telegram | Manuelle Git-Befehle | ✅ `/branch`-Workflow |
+| Sitzungen erstellen und wechseln | Auf die aktive Claude-Sitzung beschränkt | ✅ `/new`, `/switch`, `/current`, `/compact` |
+| Vorhandene lokale CLI-Sitzungen fortsetzen | ❌ | ✅ |
+| Sitzungen geräteübergreifend fortsetzen | Eingeschränkt | ✅ |
+| Schutz vor gleichzeitigen Änderungen im Workspace | ❌ | ✅ Verhindert, dass mehrere Agents gleichzeitig dasselbe Projekt bearbeiten |
+| Aufgabenwarteschlange bei ausgelastetem Agent | ❌ | ✅ |
+| Unabhängige Dateisystem-Snapshots und Diffs | ❌ | ✅ |
+| Strukturierte Datei-Diffs direkt in Telegram anzeigen | ❌ | ✅ |
+| Filterung von Secrets und sensiblen Diffs | ❌ | ✅ |
+| Integrierter Git-Workflow (pull / push / commit) | Manuell | ✅ |
+| Unterstützung mehrerer Bots | Mehrere Instanzen erforderlich | ✅ Verwaltung über einen einzigen Server |
+| Projektbezogene Statusverwaltung | ❌ | ✅ |
+| Anbieterunabhängige Architektur | ❌ | ✅ |
+
+> **Wichtigster Unterschied**
+>
+> Das offizielle Claude Code Telegram Plugin verbindet Telegram mit **einer bereits laufenden Claude Code-Sitzung**.
+>
+> **coding-agent-telegram** fungiert als **Telegram-Kontrollzentrale**, die Projekte, Branches, Sitzungen, Git-Workflows und mehrere Coding-Agents (Claude Code, Codex CLI, GitHub Copilot CLI) über eine einzige Oberfläche verwaltet.
+
+### 🏛️ Architektur
+
+#### Claude Code + Telegram Plugin
+
+```text
+Telegram
+    │
+    ▼
+Claude Code Channel
+    │
+    ▼
+Eine laufende Claude Code-Sitzung
+```
+
+#### coding-agent-telegram
+
+```text
+Telegram
+    │
+    ▼
+coding-agent-telegram
+    │
+    ├── Claude Code
+    ├── Codex CLI
+    └── GitHub Copilot CLI
+           │
+           ▼
+Projekt • Branch • Sitzung • Warteschlange • Git • Diff • Secret-Filter
+```
 
 ## 🚀 Schnellstart
 
@@ -203,7 +262,7 @@ Der Bot akzeptiert derzeit:
 - Textnachrichten
 - Fotos
 - Sprachnachrichten und Audiodateien, wenn `ENABLE_OPENAI_WHISPER_SPEECH_TO_TEXT=true` gesetzt ist und die lokalen Whisper-Voraussetzungen installiert sind
-- Codex und Copilot unterstützen aktuell nur Text und Bilder, kein Video.
+- Codex- und Claude Code-Sessions unterstützen Text und Bilder; Copilot-Sessions unterstützen aktuell nur Text. Video wird von keinem Provider unterstützt.
 
 ## 🤖 Telegram-Befehle
 
@@ -234,7 +293,7 @@ Der Bot akzeptiert derzeit:
   </tr>
   <tr>
     <td width="332"><code>/switch</code></td>
-    <td>Die neuesten Sessions anzeigen, zuerst die neuesten. Die Liste enthält sowohl vom Bot verwaltete Sessions als auch lokale Codex/Copilot CLI-Sessions für das aktuelle Projekt.</td>
+    <td>Die neuesten Sessions anzeigen, zuerst die neuesten. Die Liste enthält sowohl vom Bot verwaltete Sessions als auch lokale Codex/Copilot/Claude Code CLI-Sessions für das aktuelle Projekt.</td>
   </tr>
   <tr>
     <td width="332"><code>/switch page &lt;number&gt;</code></td>
@@ -313,13 +372,21 @@ Der Bot akzeptiert derzeit:
     <td width="332"><code>APP_LOCALE</code></td>
     <td>UI-Sprache für gemeinsame Bot-Meldungen und Befehlsbeschreibungen. Unterstützte Werte: <code>en</code>, <code>de</code>, <code>fr</code>, <code>ja</code>, <code>ko</code>, <code>nl</code>, <code>th</code>, <code>vi</code>, <code>zh-CN</code>, <code>zh-HK</code>, <code>zh-TW</code>.</td>
   </tr>
+  <tr>
+    <td><code>DEFAULT_AGENT_PROVIDER</code></td>
+    <td>Standard-Provider für neue Sessions: <code>codex</code>, <code>copilot</code> oder <code>claude</code>. Standard: <code>codex</code>.</td>
+  </tr>
   <tr>
     <td width="332"><code>CODEX_BIN</code></td>
-    <td>Befehl zum Starten von Codex CLI. Standard: <code>codex</code>.</td>
+    <td>Befehl zum Starten von Codex CLI. Die Anwendung versucht beim Initialisieren der <code>.env_coding_agent_telegram</code>-Datei, den lokal installierten Codex-Pfad automatisch zu erkennen. Alternativ können Sie mit <code>which codex</code> den Pfad anzeigen.</td>
   </tr>
   <tr>
     <td width="332"><code>COPILOT_BIN</code></td>
-    <td>Befehl zum Starten von Copilot CLI. Standard: <code>copilot</code>.</td>
+    <td>Befehl zum Starten von Copilot CLI. Die Anwendung versucht beim Initialisieren der <code>.env_coding_agent_telegram</code>-Datei, den lokal installierten Copilot-Pfad automatisch zu erkennen. Alternativ können Sie mit <code>which copilot</code> den Pfad anzeigen.</td>
+  </tr>
+  <tr>
+    <td><code>CLAUDE_BIN</code></td>
+    <td>Befehl zum Starten von Claude Code CLI. Die Anwendung versucht beim Initialisieren der <code>.env_coding_agent_telegram</code>-Datei, den lokal installierten Claude-Pfad automatisch zu erkennen. Alternativ können Sie mit <code>which claude</code> den Pfad anzeigen.</td>
   </tr>
   <tr>
     <td width="332"><code>CODEX_MODEL</code></td>
@@ -329,6 +396,14 @@ Der Bot akzeptiert derzeit:
     <td width="332"><code>COPILOT_MODEL</code></td>
     <td>Optionale Model-Überschreibung für Copilot. Leer lassen, um das Standardmodell von Copilot CLI zu verwenden. Beispiele: <code>gpt-5.4</code>, <code>claude-sonnet-4.6</code> <a href="https://docs.github.com/en/copilot/reference/ai-models/supported-models" target="_blank">GitHub Copilot unterstützte modelle</a></td>
   </tr>
+  <tr>
+    <td><code>CLAUDE_MODEL</code></td>
+    <td>Optionale Model-Überschreibung für Claude Code.
+    Leer lassen, um das Standardmodell von Claude Code CLI zu verwenden.
+    Beispiele: <code>sonnet</code>, <code>opus</code>, <code>haiku</code>
+    <a href="https://code.claude.com/docs/en/model-config" target="_blank">Claude Code Modellkonfiguration</a>
+    </td>
+  </tr>
   <tr>
     <td width="332"><code>CODEX_APPROVAL_POLICY</code></td>
     <td>An Codex übergebener Freigabemodus. Standard: <code>never</code>.</td>
@@ -341,6 +416,18 @@ Der Bot akzeptiert derzeit:
     <td width="332"><code>CODEX_SKIP_GIT_REPO_CHECK</code></td>
     <td>Wenn aktiviert, werden Codex-Prüfungen für vertrauenswürdige Repositories immer übersprungen.</td>
   </tr>
+  <tr>
+    <td><code>CLAUDE_PERMISSION_MODE</code></td>
+    <td>An Claude Code übergebener Permission-Modus. Einer von <code>default</code>, <code>acceptEdits</code>, <code>plan</code>, <code>auto</code>, <code>dontAsk</code>, <code>bypassPermissions</code>, <code>manual</code>. Standard: <code>bypassPermissions</code> (vollständig autonom, da kein interaktives Terminal zum Bestätigen von Prompts vorhanden ist).</td>
+  </tr>
+  <tr>
+    <td><code>CLAUDE_ALLOWED_TOOLS</code></td>
+    <td>Kommagetrennte Allowlist für Claude Code-Tools, nach der Permission-Regel-Syntax von Claude Code. Beispiel: <code>Read,Edit,Bash(git *)</code></td>
+  </tr>
+  <tr>
+    <td><code>CLAUDE_DISALLOWED_TOOLS</code></td>
+    <td>Kommagetrennte Denylist für Claude Code-Tools. Beispiel: <code>Bash(rm *)</code></td>
+  </tr>
   <tr>
     <td width="332"><code>ENABLE_COMMIT_COMMAND</code></td>
     <td>Den Telegram-Befehl <code>/commit</code> aktivieren. Standard: <code>false</code>.</td>
@@ -422,8 +509,10 @@ ALLOWED_CHAT_IDS=123456789
 DEFAULT_AGENT_PROVIDER=codex
 CODEX_BIN=codex
 COPILOT_BIN=copilot
+CLAUDE_BIN=claude
 CODEX_APPROVAL_POLICY=never
 CODEX_SANDBOX_MODE=workspace-write
+CLAUDE_PERMISSION_MODE=bypassPermissions
 ENABLE_SENSITIVE_DIFF_FILTER=true
 ENABLE_SECRET_SCRUB_FILTER=true
 ```
@@ -489,7 +578,7 @@ Wird der aktuelle Lauf abgebrochen und es warten noch Fragen, setzt der Bot nich
 
 ## ⚠️ Diff (Dateiänderungen)
 
-_Während jedes Agentenlaufs erstellt der Bot außerdem einen leichten Vorher/Nachher-Snapshot des Projekts, damit er geänderte Dateien zusammenfassen und Diffs an Telegram senden kann. Dieser Snapshot wird von der Bot-App selbst erstellt, nicht von Codex oder Copilot._
+_Während jedes Agentenlaufs erstellt der Bot außerdem einen leichten Vorher/Nachher-Snapshot des Projekts, damit er geänderte Dateien zusammenfassen und Diffs an Telegram senden kann. Dieser Snapshot wird von der Bot-App selbst erstellt, nicht von Codex, Copilot oder Claude Code._
 
 **Hinweise zum Snapshot:**
 

{coding_agent_telegram-2026.4.7 → coding_agent_telegram-2026.7.18}/README.fr.md

@@ -35,14 +35,14 @@
    ## ✨ Pourquoi l’utiliser
   - ✅ Léger : pas de framework lourd, transparence totale
   - ✅ Multi-bot : plusieurs chats, plusieurs sessions
-  - ✅ Utiliser Telegram pour piloter Codex / Copilot CLI
+  - ✅ Utiliser Telegram pour piloter Codex / Copilot / Claude Code CLI
   - ✅ Révision facile des réponses et des fichiers modifiés dans des blocs de code
   - ✅ Les messages de suivi peuvent être mis en file d’attente pendant qu’un agent travaille
   - ✅ Accepte les messages ✏️ texte, 🌄 image et 🎙️ vocaux
 
    ## 🔁 Changement fluide entre appareils et sessions
 
-  Démarrez une session dans Telegram, puis reprenez la même session Codex/Copilot CLI plus tard sur votre ordinateur sans friction. Avec `/switch`, vous pouvez aussi repasser simplement de Telegram à la ligne de commande.
+  Démarrez une session dans Telegram, puis reprenez la même session Codex/Copilot/Claude Code CLI plus tard sur votre ordinateur sans friction. Avec `/switch`, vous pouvez aussi repasser simplement de Telegram à la ligne de commande.
   
   - Utilisez `/switch` pour reprendre une session locale
   - Les sessions historiques sont également prises en charge
@@ -86,6 +86,7 @@ curl -fsSL https://raw.githubusercontent.com/daocha/coding-agent-telegram/main/i
 - Les dossiers existants peuvent exiger une confirmation de confiance avant les opérations Git modifiantes
 - Le serveur n’effectue aucun appel externe caché. Vous gardez le contrôle.
 - Fonctionne bien avec le mode sandbox de Codex, sans devoir accorder `danger-full-access`
+- L’intégration Claude Code prend en charge des modes de permission configurables ainsi que des listes d’autorisation/interdiction d’outils
    </td>
    <td width="35%" valign="top">
 
@@ -96,16 +97,74 @@ Avant de démarrer le serveur, assurez-vous d’avoir :
 - Python 3.9 ou plus récent
 - Un token de bot Telegram créé via _@BotFather_
 - Votre identifiant de chat Telegram
-- Codex CLI et/ou Copilot CLI installés localement
-- [Installation Codex CLI](https://developers.openai.com/codex/cli)
-- [Installation Copilot CLI](https://github.com/features/copilot/cli)
+- Codex CLI et/ou Copilot CLI et/ou Claude Code CLI installés localement
+- [Installation Codex CLI](https://developers.openai.com/codex/cli) / [Installation Copilot CLI](https://github.com/features/copilot/cli) / [Installation Claude Code CLI](https://code.claude.com/docs/en/quickstart)
 - [Optionnel] Whisper, ffmpeg
    </td>
    </tr>
 </table>
 
 ## 🦞 Pourquoi en ai-je besoin si j’ai déjà Openclaw ?
-Openclaw offre des capacités très complètes et intègre déjà une boucle d’agent appelée Pi-Agent. C’est un outil riche, pensé pour des cas d’usage plus variés. J’aime aussi Openclaw et j’ai déjà codé avec lui. Mais pour le coding pur, ce n’est pas toujours le meilleur choix à cause du gros system prompt intégré et du contexte supplémentaire. Pour coder, Claude Code / Codex / Copilot restent souvent plus efficaces, plus précis, moins distraits et plus directs. Ce projet reste volontairement simple et se contente d’intégrer Codex / Copilot CLI. Vous déléguez donc directement le travail à Codex / Copilot.
+Openclaw offre des capacités très complètes et intègre déjà une boucle d’agent appelée Pi-Agent. C’est un outil riche, pensé pour des cas d’usage plus variés. J’aime aussi Openclaw et j’ai déjà codé avec lui. Mais pour le coding pur, ce n’est pas toujours le meilleur choix à cause du gros system prompt intégré et du contexte supplémentaire. Pour coder, Claude Code / Codex / Copilot restent souvent plus efficaces, plus précis, moins distraits et plus directs. Ce projet reste volontairement simple et se contente d’intégrer Codex / Copilot / Claude Code CLI. Vous déléguez donc directement le travail à Codex / Copilot / Claude Code.
+
+## 🆚 Pourquoi utiliser coding-agent-telegram si j'ai déjà Claude Code + Telegram Plugin ?
+
+| Fonctionnalité | Claude Code + Plugin Telegram officiel | coding-agent-telegram (avec prise en charge de Claude) |
+|----------------|-----------------------------------------|--------------------------------------------------------|
+| Discussion avec l'IA via Telegram | ✅ | ✅ |
+| Modifier le code local et exécuter des commandes | ✅ | ✅ |
+| Nécessite une session CLI déjà en cours d'exécution | **Oui** | **Non** (démarre ou reprend automatiquement les sessions) |
+| Prise en charge de plusieurs fournisseurs d'IA | ❌ Claude uniquement | ✅ Claude Code, Codex CLI, GitHub Copilot CLI |
+| Gestion des projets depuis Telegram | ❌ | ✅ `/project` |
+| Gestion des branches depuis Telegram | Commandes Git manuelles | ✅ Workflow `/branch` |
+| Créer et changer de session | Limité à la session Claude active | ✅ `/new`, `/switch`, `/current`, `/compact` |
+| Reprendre des sessions CLI locales existantes | ❌ | ✅ |
+| Continuité des sessions entre plusieurs appareils | Limitée | ✅ |
+| Protection contre les modifications simultanées d'un même workspace | ❌ | ✅ Empêche plusieurs agents de modifier le même projet en même temps |
+| File d'attente des tâches lorsqu'un agent est occupé | ❌ | ✅ |
+| Snapshots et diffs du système de fichiers indépendants | ❌ | ✅ |
+| Affichage des diffs structurés directement dans Telegram | ❌ | ✅ |
+| Filtrage des secrets et des diffs sensibles | ❌ | ✅ |
+| Workflow Git intégré (pull / push / commit) | Manuel | ✅ |
+| Prise en charge de plusieurs bots | Plusieurs instances nécessaires | ✅ Gérés par un serveur unique |
+| Gestion de l'état au niveau du projet | ❌ | ✅ |
+| Architecture indépendante du fournisseur | ❌ | ✅ |
+
+> **Différence principale**
+>
+> Le plugin Telegram officiel de Claude Code connecte Telegram à **une seule session Claude Code déjà en cours d'exécution**.
+>
+> **coding-agent-telegram** agit comme un **plan de contrôle Telegram** permettant de gérer les projets, les branches, les sessions, les workflows Git et plusieurs agents de développement (Claude Code, Codex CLI, GitHub Copilot CLI) depuis une interface unique.
+
+### 🏛️ Architecture
+
+#### Claude Code + Telegram Plugin
+
+```text
+Telegram
+    │
+    ▼
+Canal Claude Code
+    │
+    ▼
+Une session Claude Code en cours d'exécution
+```
+
+#### coding-agent-telegram
+
+```text
+Telegram
+    │
+    ▼
+coding-agent-telegram
+    │
+    ├── Claude Code
+    ├── Codex CLI
+    └── GitHub Copilot CLI
+           │
+           ▼
+Projet • Branche • Session • File d'attente • Git • Diff • Filtre des secrets
+```
 
 ## 🚀 Démarrage rapide
 
@@ -203,7 +262,7 @@ Le bot accepte actuellement :
 - les messages texte
 - les photos
 - les messages vocaux et les fichiers audio quand `ENABLE_OPENAI_WHISPER_SPEECH_TO_TEXT=true` et que les prérequis locaux de Whisper sont installés
-- Codex et Copilot prennent actuellement en charge uniquement le texte et les images, pas la vidéo
+- Codex et Claude Code prennent en charge le texte et les images ; Copilot ne prend actuellement en charge que le texte. Aucun fournisseur ne prend en charge la vidéo.
 
 ## 🤖 Commandes Telegram
 
@@ -234,7 +293,7 @@ Le bot accepte actuellement :
   </tr>
   <tr>
     <td width="332"><code>/switch</code></td>
-    <td>Afficher les sessions les plus récentes, de la plus récente à la plus ancienne. La liste inclut les sessions gérées par le bot et les sessions locales Codex/Copilot CLI du projet courant.</td>
+    <td>Afficher les sessions les plus récentes, de la plus récente à la plus ancienne. La liste inclut les sessions gérées par le bot et les sessions locales Codex/Copilot/Claude Code CLI du projet courant.</td>
   </tr>
   <tr>
     <td width="332"><code>/switch page &lt;number&gt;</code></td>
@@ -313,13 +372,21 @@ Le bot accepte actuellement :
     <td width="332"><code>APP_LOCALE</code></td>
     <td>Langue de l’interface pour les messages partagés du bot et les descriptions de commandes. Valeurs prises en charge : <code>en</code>, <code>de</code>, <code>fr</code>, <code>ja</code>, <code>ko</code>, <code>nl</code>, <code>th</code>, <code>vi</code>, <code>zh-CN</code>, <code>zh-HK</code>, <code>zh-TW</code>.</td>
   </tr>
+  <tr>
+    <td width="332"><code>DEFAULT_AGENT_PROVIDER</code></td>
+    <td>Fournisseur par défaut pour les nouvelles sessions : <code>codex</code>, <code>copilot</code>, ou <code>claude</code>. Valeur par défaut : <code>codex</code>.</td>
+  </tr>
   <tr>
     <td width="332"><code>CODEX_BIN</code></td>
-    <td>Commande utilisée pour lancer Codex CLI. Valeur par défaut : <code>codex</code>.</td>
+    <td>Commande utilisée pour lancer Codex CLI. L'application essaiera de détecter automatiquement le chemin d'installation local de Codex lors de l'initialisation de <code>.env_coding_agent_telegram</code>. Vous pouvez également utiliser <code>which codex</code> pour afficher ce chemin.</td>
   </tr>
   <tr>
     <td width="332"><code>COPILOT_BIN</code></td>
-    <td>Commande utilisée pour lancer Copilot CLI. Valeur par défaut : <code>copilot</code>.</td>
+    <td>Commande utilisée pour lancer Copilot CLI. L'application essaiera de détecter automatiquement le chemin d'installation local de Copilot lors de l'initialisation de <code>.env_coding_agent_telegram</code>. Vous pouvez également utiliser <code>which copilot</code> pour afficher ce chemin.</td>
+  </tr>
+  <tr>
+    <td width="332"><code>CLAUDE_BIN</code></td>
+    <td>Commande utilisée pour lancer Claude Code CLI. L'application essaiera de détecter automatiquement le chemin d'installation local de Claude lors de l'initialisation de <code>.env_coding_agent_telegram</code>. Vous pouvez également utiliser <code>which claude</code> pour afficher ce chemin.</td>
   </tr>
   <tr>
     <td width="332"><code>CODEX_MODEL</code></td>
@@ -329,6 +396,14 @@ Le bot accepte actuellement :
     <td width="332"><code>COPILOT_MODEL</code></td>
     <td>Remplacement optionnel du modèle Copilot. Laissez vide pour utiliser le modèle par défaut de Copilot CLI. Exemples : <code>gpt-5.4</code>, <code>claude-sonnet-4.6</code> <a href="https://docs.github.com/en/copilot/reference/ai-models/supported-models" target="_blank">Modèles pris en charge par GitHub Copilot</a></td>
   </tr>
+  <tr>
+    <td width="332"><code>CLAUDE_MODEL</code></td>
+    <td>Remplacement optionnel du modèle Claude Code.
+    Laissez vide pour utiliser le modèle par défaut de Claude Code CLI.
+    Exemples : <code>sonnet</code>, <code>opus</code>, <code>haiku</code>
+    <a href="https://code.claude.com/docs/en/model-config" target="_blank">Configuration des modèles Claude Code</a>
+    </td>
+  </tr>
   <tr>
     <td width="332"><code>CODEX_APPROVAL_POLICY</code></td>
     <td>Mode d’approbation transmis à Codex. Défaut : <code>never</code>.</td>
@@ -341,6 +416,18 @@ Le bot accepte actuellement :
     <td width="332"><code>CODEX_SKIP_GIT_REPO_CHECK</code></td>
     <td>Si activé, contourne toujours les vérifications de dépôt trusted de Codex.</td>
   </tr>
+  <tr>
+    <td width="332"><code>CLAUDE_PERMISSION_MODE</code></td>
+    <td>Mode de permission transmis à Claude Code. Un parmi <code>default</code>, <code>acceptEdits</code>, <code>plan</code>, <code>auto</code>, <code>dontAsk</code>, <code>bypassPermissions</code>, <code>manual</code>. Défaut : <code>bypassPermissions</code> (entièrement autonome, puisqu’il n’y a pas de terminal interactif pour approuver les invites).</td>
+  </tr>
+  <tr>
+    <td width="332"><code>CLAUDE_ALLOWED_TOOLS</code></td>
+    <td>Liste blanche d’outils Claude Code séparés par des virgules, utilisant la syntaxe des règles de permission de Claude Code. Exemple : <code>Read,Edit,Bash(git *)</code></td>
+  </tr>
+  <tr>
+    <td width="332"><code>CLAUDE_DISALLOWED_TOOLS</code></td>
+    <td>Liste noire d’outils Claude Code séparés par des virgules. Exemple : <code>Bash(rm *)</code></td>
+  </tr>
   <tr>
     <td width="332"><code>ENABLE_COMMIT_COMMAND</code></td>
     <td>Active la commande Telegram <code>/commit</code>. Défaut : <code>false</code>.</td>
@@ -422,8 +509,10 @@ ALLOWED_CHAT_IDS=123456789
 DEFAULT_AGENT_PROVIDER=codex
 CODEX_BIN=codex
 COPILOT_BIN=copilot
+CLAUDE_BIN=claude
 CODEX_APPROVAL_POLICY=never
 CODEX_SANDBOX_MODE=workspace-write
+CLAUDE_PERMISSION_MODE=bypassPermissions
 ENABLE_SENSITIVE_DIFF_FILTER=true
 ENABLE_SECRET_SCRUB_FILTER=true
 ```
@@ -487,7 +576,7 @@ Si l'exécution en cours est annulée et que des questions attendent encore, le
 
 ## ⚠️ Diff (modifications de fichiers)
 
-_Pendant chaque exécution d'agent, le bot prend aussi un léger instantané avant/après du projet afin de résumer les fichiers modifiés et d'envoyer des diffs vers Telegram. Ce instantané est produit par le bot lui-même, pas par Codex ou Copilot._
+_Pendant chaque exécution d'agent, le bot prend aussi un léger instantané avant/après du projet afin de résumer les fichiers modifiés et d'envoyer des diffs vers Telegram. Ce instantané est produit par le bot lui-même, pas par Codex, Copilot ou Claude Code._
 
 **À savoir sur le instantané :**