> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.
# トラブルシューティングガイド
このガイドでは、Qoder の診断スクリプトを使って、Qoder の起動や接続に関する問題を切り分ける方法を説明します。スクリプトは、環境情報、ネットワーク設定、Qoder サービスのステータス、関連ログなどの重要なシステム情報を自動で収集し、一般的な問題の迅速な診断と解決を可能にします。
## **前提条件**
診断スクリプトを実行する前に、次の点を確認してください:
* オペレーティングシステム: Windows
* 権限: システム設定やログへ完全にアクセスするため、スクリプトは管理者権限で実行してください。
* スクリプトファイル: [windows\_Qoder.bat](https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/Diagnosis/windows_qoder.bat) をダウンロードし、`.bat` ファイルとして保存します（例: `qoder_Debug.bat`）。
* インストールパス: Qoder がデフォルトのディレクトリ `C:\Users\\.qoder` にインストールされていることを確認してください。
## **診断スクリプトを実行**
### **ステップ 1: スクリプトを実行する**
1. 保存した `.bat` ファイルを探します。
例: `qoder_Debug.bat`
2. ファイルをダブルクリックしてスクリプトを実行します。
3. スクリプトは自動的に実行され、システムおよびアプリケーションのデータを収集します。
⚠️ スクリプトが最後まで完了するまで待機してください。コマンドウィンドウを途中で閉じないでください。
### **ステップ 2: 生成されたログを確認する**
スクリプトの実行が完了したら、次を確認してください:
* 収集されたログファイルおよび主要な設定ファイルを含む圧縮アーカイブ（ZIP）が自動的に生成されます。\
ファイル名の形式: `qoder-diagnosis_YYYYMMDD_HHMMSS.zip`\
*例:* `qoder-diagnosis_Sat_2025-10-11_16-00-03.93.zip`
* メインのログファイルはアーカイブに含まれており、ファイル名の形式は次のとおりです: `Qoder_Log_YYYYMMDD_HHMMSS.txt`\
*例:* `Qoder_Log_20250405_143022.txt`
* 問題の調査およびトラブルシューティングのために、診断用 ZIP パッケージ全体を Qoder の公式チームに送付できます。
## **よくある問題**
| 問題の種類 | 問題 | 解決策 |
| ------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ネットワーク | プロキシ設定の確認 | スクリプトはプロキシが有効かどうかをチェックします。期待どおりの動作か確認するため、`[Network Settings 0x0 means proxy is disabled]` のセクションを参照してください。
プロキシを利用している場合は、設定で Qoder のネットワークプロキシを手動で構成してください。 |
| Qoder サーバー状態 | Qoder.exe の有無 | スクリプトは Qoder.exe の存在を確認します。
エラーが発生した場合：
1. インストールパスを確認する。
2. .qoder ディレクトリを削除する。
3. IDE を再起動してディレクトリを再生成する。 |
| | バージョンと起動テスト | \[Version Test] と \[Start Qoder] のセクションを参照し、以下を確認してください：
\* Qoder のバージョン
\* 公開サーバーへの接続
「failed」と表示される場合は、エラーメッセージに記載の URL を用いて、設定でプロキシアクセスを構成してください。 |
| | Qoder.exe は動作中だがログイン失敗 | 実行ファイルを Windows ファイアウォールの許可リストに追加します：
パス：
1. Windows：C:\Users\ユーザー名\AppData\Local\Programs\Qoder\resources\app\resources\bin\`CPU\_architecture\_64\_system`\Qoder.exe
2. Mac：/Applications/Qoder.app/Contents/Resources/app/resources\bin\`CPU\_architecture\_64\_system\`\Qoder
手順：
コントロール パネル → システムとセキュリティ → Windows Defender ファイアウォール → 許可されたアプリ → 別のアプリの許可
その後、再度ログインしてください。 |
| システム互換性 | システムおよびハードウェア情報 | スクリプトは以下を収集します：
\* OS バージョン（例：Windows 10/11）
\* CPU モデル
\[Operating System Information] を確認し、システムが Qoder の要件を満たしていることを確認してください：
\* Windows 10 以降（64-bit）
\* x86\_64 互換 CPU |
| ログ解析 | Qoder アプリケーションログ | 生成されたログには `qoder.log` の末尾 80 行が含まれます。
これを用いて、実行時エラー、警告、接続問題を特定してください。 |
| | ディレクトリ構造とファイルサイズ | スクリプトは .qoder 配下のディレクトリ構造とファイルサイズを一覧表示します。これを用いて：
\* ディスク使用量を確認する。
\* ファイルの整合性（欠落や異常に小さいファイルなど）を検証する。 |
| 注意 | バイナリ実行の制限 | 一部の企業環境ではバイナリ実行が制限またはブロックされ、Qoder が起動できない場合があります。
アプリが起動しない場合は、権限設定の調整について IT 部門にお問い合わせください。 |
| 解決困難な問題 | 自己解決が難しい問題 | 解決できない場合は、次までご連絡ください： [contact@qoder.com](mailto:contact@qoder.com)。
サポートを迅速化するため、生成されたログファイル `Qoder_Log_YYYYMMDD_HHMMSS.txt` を添付してください。 |