feat: add i18n support for Claude Code ENOENT error with updated documentation link

roomote · roomote · commit 6de2d67f7346 · 2025-07-18T15:16:41.000Z
- Add notFound error message key to all supported locales (18 languages) - Update installation URL to https://docs.anthropic.com/en/docs/claude-code/setup - Create CLAUDE_CODE_INSTALLATION_URL constant for easy future updates - Refactor createClaudeCodeNotFoundError to use i18n translation system - Maintain backward compatibility while improving user experience
diff --git a/src/i18n/locales/ca/common.json b/src/i18n/locales/ca/common.json
@@ -78,7 +78,8 @@
 			"errorOutput": "Sortida d'error: {{output}}",
 			"processExitedWithError": "El procés Claude Code ha sortit amb codi {{exitCode}}. Sortida d'error: {{output}}",
 			"stoppedWithReason": "Claude Code s'ha aturat per la raó: {{reason}}",
-			"apiKeyModelPlanMismatch": "Les claus API i els plans de subscripció permeten models diferents. Assegura't que el model seleccionat estigui inclòs al teu pla."
+			"apiKeyModelPlanMismatch": "Les claus API i els plans de subscripció permeten models diferents. Assegura't que el model seleccionat estigui inclòs al teu pla.",
+			"notFound": "No s'ha trobat l'executable Claude Code '{{claudePath}}'.\n\nInstal·la Claude Code CLI:\n1. Visita {{installationUrl}} per descarregar Claude Code\n2. Segueix les instruccions d'instal·lació per al teu sistema operatiu\n3. Assegura't que la comanda 'claude' estigui disponible al teu PATH\n4. Alternativament, configura una ruta personalitzada a la configuració de Roo sota 'Ruta de Claude Code'\n\nError original: {{originalError}}"
 		},
 		"mode_import_failed": "Ha fallat la importació del mode: {{error}}"
 	},
diff --git a/src/i18n/locales/de/common.json b/src/i18n/locales/de/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Fehlerausgabe: {{output}}",
 			"processExitedWithError": "Claude Code Prozess wurde mit Code {{exitCode}} beendet. Fehlerausgabe: {{output}}",
 			"stoppedWithReason": "Claude Code wurde mit Grund gestoppt: {{reason}}",
-			"apiKeyModelPlanMismatch": "API-Schlüssel und Abonnement-Pläne erlauben verschiedene Modelle. Stelle sicher, dass das ausgewählte Modell in deinem Plan enthalten ist."
+			"apiKeyModelPlanMismatch": "API-Schlüssel und Abonnement-Pläne erlauben verschiedene Modelle. Stelle sicher, dass das ausgewählte Modell in deinem Plan enthalten ist.",
+			"notFound": "Claude Code ausführbare Datei '{{claudePath}}' nicht gefunden.\n\nBitte installiere Claude Code CLI:\n1. Besuche {{installationUrl}} um Claude Code herunterzuladen\n2. Folge den Installationsanweisungen für dein Betriebssystem\n3. Stelle sicher, dass der 'claude' Befehl in deinem PATH verfügbar ist\n4. Alternativ konfiguriere einen benutzerdefinierten Pfad in den Roo-Einstellungen unter 'Claude Code Pfad'\n\nUrsprünglicher Fehler: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/en/common.json b/src/i18n/locales/en/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Error output: {{output}}",
 			"processExitedWithError": "Claude Code process exited with code {{exitCode}}. Error output: {{output}}",
 			"stoppedWithReason": "Claude Code stopped with reason: {{reason}}",
-			"apiKeyModelPlanMismatch": "API keys and subscription plans allow different models. Make sure the selected model is included in your plan."
+			"apiKeyModelPlanMismatch": "API keys and subscription plans allow different models. Make sure the selected model is included in your plan.",
+			"notFound": "Claude Code executable '{{claudePath}}' not found.\n\nPlease install Claude Code CLI:\n1. Visit {{installationUrl}} to download Claude Code\n2. Follow the installation instructions for your operating system\n3. Ensure the 'claude' command is available in your PATH\n4. Alternatively, configure a custom path in Roo settings under 'Claude Code Path'\n\nOriginal error: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/es/common.json b/src/i18n/locales/es/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Salida de error: {{output}}",
 			"processExitedWithError": "El proceso de Claude Code terminó con código {{exitCode}}. Salida de error: {{output}}",
 			"stoppedWithReason": "Claude Code se detuvo por la razón: {{reason}}",
-			"apiKeyModelPlanMismatch": "Las claves API y los planes de suscripción permiten diferentes modelos. Asegúrate de que el modelo seleccionado esté incluido en tu plan."
+			"apiKeyModelPlanMismatch": "Las claves API y los planes de suscripción permiten diferentes modelos. Asegúrate de que el modelo seleccionado esté incluido en tu plan.",
+			"notFound": "Ejecutable de Claude Code '{{claudePath}}' no encontrado.\n\nPor favor instala Claude Code CLI:\n1. Visita {{installationUrl}} para descargar Claude Code\n2. Sigue las instrucciones de instalación para tu sistema operativo\n3. Asegúrate de que el comando 'claude' esté disponible en tu PATH\n4. Alternativamente, configura una ruta personalizada en la configuración de Roo bajo 'Ruta de Claude Code'\n\nError original: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/fr/common.json b/src/i18n/locales/fr/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Sortie d'erreur : {{output}}",
 			"processExitedWithError": "Le processus Claude Code s'est terminé avec le code {{exitCode}}. Sortie d'erreur : {{output}}",
 			"stoppedWithReason": "Claude Code s'est arrêté pour la raison : {{reason}}",
-			"apiKeyModelPlanMismatch": "Les clés API et les plans d'abonnement permettent différents modèles. Assurez-vous que le modèle sélectionné est inclus dans votre plan."
+			"apiKeyModelPlanMismatch": "Les clés API et les plans d'abonnement permettent différents modèles. Assurez-vous que le modèle sélectionné est inclus dans votre plan.",
+			"notFound": "Exécutable Claude Code '{{claudePath}}' introuvable.\n\nVeuillez installer Claude Code CLI :\n1. Visitez {{installationUrl}} pour télécharger Claude Code\n2. Suivez les instructions d'installation pour votre système d'exploitation\n3. Assurez-vous que la commande 'claude' est disponible dans votre PATH\n4. Alternativement, configurez un chemin personnalisé dans les paramètres Roo sous 'Chemin de Claude Code'\n\nErreur originale : {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/hi/common.json b/src/i18n/locales/hi/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "त्रुटि आउटपुट: {{output}}",
 			"processExitedWithError": "Claude Code प्रक्रिया कोड {{exitCode}} के साथ समाप्त हुई। त्रुटि आउटपुट: {{output}}",
 			"stoppedWithReason": "Claude Code इस कारण से रुका: {{reason}}",
-			"apiKeyModelPlanMismatch": "API कुंजी और सब्सक्रिप्शन प्लान अलग-अलग मॉडल की अनुमति देते हैं। सुनिश्चित करें कि चयनित मॉडल आपकी योजना में शामिल है।"
+			"apiKeyModelPlanMismatch": "API कुंजी और सब्सक्रिप्शन प्लान अलग-अलग मॉडल की अनुमति देते हैं। सुनिश्चित करें कि चयनित मॉडल आपकी योजना में शामिल है।",
+			"notFound": "Claude Code निष्पादन योग्य फ़ाइल '{{claudePath}}' नहीं मिली।\n\nकृपया Claude Code CLI इंस्टॉल करें:\n1. Claude Code डाउनलोड करने के लिए {{installationUrl}} पर जाएं\n2. अपने ऑपरेटिंग सिस्टम के लिए इंस्टॉलेशन निर्देशों का पालन करें\n3. सुनिश्चित करें कि 'claude' कमांड आपके PATH में उपलब्ध है\n4. वैकल्पिक रूप से, Roo सेटिंग्स में 'Claude Code Path' के तहत एक कस्टम पथ कॉन्फ़िगर करें\n\nमूल त्रुटि: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/id/common.json b/src/i18n/locales/id/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Output error: {{output}}",
 			"processExitedWithError": "Proses Claude Code keluar dengan kode {{exitCode}}. Output error: {{output}}",
 			"stoppedWithReason": "Claude Code berhenti karena alasan: {{reason}}",
-			"apiKeyModelPlanMismatch": "Kunci API dan paket berlangganan memungkinkan model yang berbeda. Pastikan model yang dipilih termasuk dalam paket Anda."
+			"apiKeyModelPlanMismatch": "Kunci API dan paket berlangganan memungkinkan model yang berbeda. Pastikan model yang dipilih termasuk dalam paket Anda.",
+			"notFound": "File executable Claude Code '{{claudePath}}' tidak ditemukan.\n\nSilakan instal Claude Code CLI:\n1. Kunjungi {{installationUrl}} untuk mengunduh Claude Code\n2. Ikuti petunjuk instalasi untuk sistem operasi Anda\n3. Pastikan perintah 'claude' tersedia di PATH Anda\n4. Atau, konfigurasikan jalur kustom di pengaturan Roo di bawah 'Jalur Claude Code'\n\nError asli: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/it/common.json b/src/i18n/locales/it/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Output di errore: {{output}}",
 			"processExitedWithError": "Il processo Claude Code è terminato con codice {{exitCode}}. Output di errore: {{output}}",
 			"stoppedWithReason": "Claude Code si è fermato per il motivo: {{reason}}",
-			"apiKeyModelPlanMismatch": "Le chiavi API e i piani di abbonamento consentono modelli diversi. Assicurati che il modello selezionato sia incluso nel tuo piano."
+			"apiKeyModelPlanMismatch": "Le chiavi API e i piani di abbonamento consentono modelli diversi. Assicurati che il modello selezionato sia incluso nel tuo piano.",
+			"notFound": "Eseguibile Claude Code '{{claudePath}}' non trovato.\n\nInstalla Claude Code CLI:\n1. Visita {{installationUrl}} per scaricare Claude Code\n2. Segui le istruzioni di installazione per il tuo sistema operativo\n3. Assicurati che il comando 'claude' sia disponibile nel tuo PATH\n4. In alternativa, configura un percorso personalizzato nelle impostazioni Roo sotto 'Percorso Claude Code'\n\nErrore originale: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/ja/common.json b/src/i18n/locales/ja/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "エラー出力：{{output}}",
 			"processExitedWithError": "Claude Code プロセスがコード {{exitCode}} で終了しました。エラー出力：{{output}}",
 			"stoppedWithReason": "Claude Code が理由により停止しました：{{reason}}",
-			"apiKeyModelPlanMismatch": "API キーとサブスクリプションプランでは異なるモデルが利用可能です。選択したモデルがプランに含まれていることを確認してください。"
+			"apiKeyModelPlanMismatch": "API キーとサブスクリプションプランでは異なるモデルが利用可能です。選択したモデルがプランに含まれていることを確認してください。",
+			"notFound": "Claude Code 実行ファイル '{{claudePath}}' が見つかりません。\n\nClaude Code CLI をインストールしてください：\n1. {{installationUrl}} にアクセスして Claude Code をダウンロード\n2. お使いのオペレーティングシステムのインストール手順に従ってください\n3. 'claude' コマンドが PATH で利用可能であることを確認してください\n4. または、Roo 設定の 'Claude Code パス' でカスタムパスを設定してください\n\n元のエラー：{{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/ko/common.json b/src/i18n/locales/ko/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "오류 출력: {{output}}",
 			"processExitedWithError": "Claude Code 프로세스가 코드 {{exitCode}}로 종료되었습니다. 오류 출력: {{output}}",
 			"stoppedWithReason": "Claude Code가 다음 이유로 중지되었습니다: {{reason}}",
-			"apiKeyModelPlanMismatch": "API 키와 구독 플랜에서 다른 모델을 허용합니다. 선택한 모델이 플랜에 포함되어 있는지 확인하세요."
+			"apiKeyModelPlanMismatch": "API 키와 구독 플랜에서 다른 모델을 허용합니다. 선택한 모델이 플랜에 포함되어 있는지 확인하세요.",
+			"notFound": "Claude Code 실행 파일 '{{claudePath}}'을 찾을 수 없습니다.\n\nClaude Code CLI를 설치해주세요:\n1. {{installationUrl}}에 방문하여 Claude Code를 다운로드하세요\n2. 운영 체제의 설치 지침을 따르세요\n3. 'claude' 명령이 PATH에서 사용 가능한지 확인하세요\n4. 또는 Roo 설정의 'Claude Code 경로'에서 사용자 정의 경로를 구성하세요\n\n원본 오류: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/nl/common.json b/src/i18n/locales/nl/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Foutuitvoer: {{output}}",
 			"processExitedWithError": "Claude Code proces beëindigd met code {{exitCode}}. Foutuitvoer: {{output}}",
 			"stoppedWithReason": "Claude Code gestopt om reden: {{reason}}",
-			"apiKeyModelPlanMismatch": "API-sleutels en abonnementsplannen staan verschillende modellen toe. Zorg ervoor dat het geselecteerde model is opgenomen in je plan."
+			"apiKeyModelPlanMismatch": "API-sleutels en abonnementsplannen staan verschillende modellen toe. Zorg ervoor dat het geselecteerde model is opgenomen in je plan.",
+			"notFound": "Claude Code uitvoerbaar bestand '{{claudePath}}' niet gevonden.\n\nInstalleer Claude Code CLI:\n1. Bezoek {{installationUrl}} om Claude Code te downloaden\n2. Volg de installatie-instructies voor je besturingssysteem\n3. Zorg ervoor dat het 'claude' commando beschikbaar is in je PATH\n4. Of configureer een aangepast pad in Roo instellingen onder 'Claude Code Pad'\n\nOriginele fout: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/pl/common.json b/src/i18n/locales/pl/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Wyjście błędu: {{output}}",
 			"processExitedWithError": "Proces Claude Code zakończył się kodem {{exitCode}}. Wyjście błędu: {{output}}",
 			"stoppedWithReason": "Claude Code zatrzymał się z powodu: {{reason}}",
-			"apiKeyModelPlanMismatch": "Klucze API i plany subskrypcji pozwalają na różne modele. Upewnij się, że wybrany model jest zawarty w twoim planie."
+			"apiKeyModelPlanMismatch": "Klucze API i plany subskrypcji pozwalają na różne modele. Upewnij się, że wybrany model jest zawarty w twoim planie.",
+			"notFound": "Plik wykonywalny Claude Code '{{claudePath}}' nie został znaleziony.\n\nZainstaluj Claude Code CLI:\n1. Odwiedź {{installationUrl}} aby pobrać Claude Code\n2. Postępuj zgodnie z instrukcjami instalacji dla twojego systemu operacyjnego\n3. Upewnij się, że polecenie 'claude' jest dostępne w twoim PATH\n4. Alternatywnie skonfiguruj niestandardową ścieżkę w ustawieniach Roo pod 'Ścieżka Claude Code'\n\nOryginalny błąd: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/pt-BR/common.json b/src/i18n/locales/pt-BR/common.json
@@ -79,7 +79,8 @@
 			"errorOutput": "Saída de erro: {{output}}",
 			"processExitedWithError": "O processo Claude Code saiu com código {{exitCode}}. Saída de erro: {{output}}",
 			"stoppedWithReason": "Claude Code parou pela razão: {{reason}}",
-			"apiKeyModelPlanMismatch": "Chaves de API e planos de assinatura permitem modelos diferentes. Certifique-se de que o modelo selecionado esteja incluído no seu plano."
+			"apiKeyModelPlanMismatch": "Chaves de API e planos de assinatura permitem modelos diferentes. Certifique-se de que o modelo selecionado esteja incluído no seu plano.",
+			"notFound": "Executável Claude Code '{{claudePath}}' não encontrado.\n\nInstale o Claude Code CLI:\n1. Visite {{installationUrl}} para baixar o Claude Code\n2. Siga as instruções de instalação para o seu sistema operacional\n3. Certifique-se de que o comando 'claude' esteja disponível no seu PATH\n4. Alternativamente, configure um caminho personalizado nas configurações do Roo em 'Caminho do Claude Code'\n\nErro original: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/ru/common.json b/src/i18n/locales/ru/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Вывод ошибки: {{output}}",
 			"processExitedWithError": "Процесс Claude Code завершился с кодом {{exitCode}}. Вывод ошибки: {{output}}",
 			"stoppedWithReason": "Claude Code остановился по причине: {{reason}}",
-			"apiKeyModelPlanMismatch": "API-ключи и планы подписки позволяют использовать разные модели. Убедитесь, что выбранная модель включена в ваш план."
+			"apiKeyModelPlanMismatch": "API-ключи и планы подписки позволяют использовать разные модели. Убедитесь, что выбранная модель включена в ваш план.",
+			"notFound": "Исполняемый файл Claude Code '{{claudePath}}' не найден.\n\nУстановите Claude Code CLI:\n1. Посетите {{installationUrl}} для загрузки Claude Code\n2. Следуйте инструкциям по установке для вашей операционной системы\n3. Убедитесь, что команда 'claude' доступна в вашем PATH\n4. Альтернативно настройте пользовательский путь в настройках Roo в разделе 'Путь к Claude Code'\n\nИсходная ошибка: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/tr/common.json b/src/i18n/locales/tr/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Hata çıktısı: {{output}}",
 			"processExitedWithError": "Claude Code işlemi {{exitCode}} koduyla çıktı. Hata çıktısı: {{output}}",
 			"stoppedWithReason": "Claude Code şu nedenle durdu: {{reason}}",
-			"apiKeyModelPlanMismatch": "API anahtarları ve abonelik planları farklı modellere izin verir. Seçilen modelin planınıza dahil olduğundan emin olun."
+			"apiKeyModelPlanMismatch": "API anahtarları ve abonelik planları farklı modellere izin verir. Seçilen modelin planınıza dahil olduğundan emin olun.",
+			"notFound": "Claude Code çalıştırılabilir dosyası '{{claudePath}}' bulunamadı.\n\nClaude Code CLI'yi yükleyin:\n1. Claude Code'u indirmek için {{installationUrl}} adresini ziyaret edin\n2. İşletim sisteminiz için kurulum talimatlarını takip edin\n3. 'claude' komutunun PATH'inizde mevcut olduğundan emin olun\n4. Alternatif olarak, Roo ayarlarında 'Claude Code Yolu' altında özel bir yol yapılandırın\n\nOrijinal hata: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/vi/common.json b/src/i18n/locales/vi/common.json
@@ -75,7 +75,8 @@
 			"errorOutput": "Đầu ra lỗi: {{output}}",
 			"processExitedWithError": "Tiến trình Claude Code thoát với mã {{exitCode}}. Đầu ra lỗi: {{output}}",
 			"stoppedWithReason": "Claude Code dừng lại vì lý do: {{reason}}",
-			"apiKeyModelPlanMismatch": "Khóa API và gói đăng ký cho phép các mô hình khác nhau. Đảm bảo rằng mô hình đã chọn được bao gồm trong gói của bạn."
+			"apiKeyModelPlanMismatch": "Khóa API và gói đăng ký cho phép các mô hình khác nhau. Đảm bảo rằng mô hình đã chọn được bao gồm trong gói của bạn.",
+			"notFound": "Không tìm thấy tệp thực thi Claude Code '{{claudePath}}'.\n\nVui lòng cài đặt Claude Code CLI:\n1. Truy cập {{installationUrl}} để tải xuống Claude Code\n2. Làm theo hướng dẫn cài đặt cho hệ điều hành của bạn\n3. Đảm bảo lệnh 'claude' có sẵn trong PATH của bạn\n4. Hoặc cấu hình đường dẫn tùy chỉnh trong cài đặt Roo dưới 'Đường dẫn Claude Code'\n\nLỗi gốc: {{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/zh-CN/common.json b/src/i18n/locales/zh-CN/common.json
@@ -80,7 +80,8 @@
 			"errorOutput": "错误输出：{{output}}",
 			"processExitedWithError": "Claude Code 进程退出，退出码：{{exitCode}}。错误输出：{{output}}",
 			"stoppedWithReason": "Claude Code 停止，原因：{{reason}}",
-			"apiKeyModelPlanMismatch": "API 密钥和订阅计划支持不同的模型。请确保所选模型包含在您的计划中。"
+			"apiKeyModelPlanMismatch": "API 密钥和订阅计划支持不同的模型。请确保所选模型包含在您的计划中。",
+			"notFound": "未找到 Claude Code 可执行文件 '{{claudePath}}'。\n\n请安装 Claude Code CLI：\n1. 访问 {{installationUrl}} 下载 Claude Code\n2. 按照操作系统的安装说明进行操作\n3. 确保 'claude' 命令在 PATH 中可用\n4. 或者在 Roo 设置中的 'Claude Code 路径' 下配置自定义路径\n\n原始错误：{{originalError}}"
 		}
 	},
 	"warnings": {
diff --git a/src/i18n/locales/zh-TW/common.json b/src/i18n/locales/zh-TW/common.json
diff --git a/src/integrations/claude-code/run.ts b/src/integrations/claude-code/run.ts
