一般的なエラーメッセージ、原因と解決方法、およびよくある質問
本ページでは、一般的なエラーメッセージの意味と解決方法、およびよくある質問をまとめています。より詳細なトラブルシューティングについては、各専門ページを参照してください。
ネットワークリクエストが失敗しました。通常、ネットワークまたはプロキシに関連しています。
現在サインインしていないか、資格情報が無効になっています。
ツール呼び出しが権限システムまたはフックによってブロックされました。
設定がより高い優先度の設定によって上書きされている、再起動が必要、または形式が正しくありません。設定が反映されないを参照してください。
コマンドラインでは
よくあるエラー
fetch failed / リクエスト送信失敗
ネットワークリクエストが失敗しました。通常、ネットワークまたはプロキシに関連しています。
- ネットワーク接続とプロキシ構成を確認してください。ネットワーク、プロキシ、および VPC の問題を参照してください。
general.retryFetchErrors（デフォルトで有効）により、この種のエラーの一部は自動的に再試行されます。
未認証 / サインインが必要
現在サインインしていないか、資格情報が無効になっています。
/loginを実行して再度サインインするか、QODER_PERSONAL_ACCESS_TOKENを設定してください。- 詳細はサインインと認証の問題を参照してください。
コマンドが見つかりません（command not found: qoder）
qoder が PATH にありません。インストールとアップグレードの問題を参照してください。
アクセスが拒否されました / アクションがブロックされました
ツール呼び出しが権限システムまたはフックによってブロックされました。
/permissionsを使用して現在の権限モードとルールを確認し、必要に応じて調整してください。Shift+Tab で権限モードを切り替えることもできます。- フックによってブロックされた場合（終了コード
2）、フィードバックメッセージを確認してください。フック、MCP、およびプラグインの問題を参照してください。
設定が反映されていない
設定がより高い優先度の設定によって上書きされている、再起動が必要、または形式が正しくありません。設定が反映されないを参照してください。
よくある質問
バージョンを確認するには？
スクリプトで非対話型で実行するには？
--print（-p）を使用します。--output-format json と組み合わせると、プログラムでの利用が容易になります。スクリプトでの実行を参照してください。
前回のセッションを続行するには？
qoder --continue（-c）を使用して直近のセッションを続行するか、--resume（-r）で履歴セッションを選択します。セッション管理を参照してください。
モデルを切り替えるには？
コマンドラインでは -m <モデル> を、対話モードでは /model を使用します。モデルと推論強度の選択を参照してください。
以前のコードまたは会話にロールバックするには？
/rewind またはチェックポイント機能を使用して復元します。取り消しと復元を参照してください。
使用量とクォータを確認するには？
/usage を使用して使用量統計を確認します。使用量とクォータを参照してください。
コンテキストウィンドウがいっぱいになりそうな場合は？
/compact を使用して手動で圧縮するか、新しいセッションを開始してください。パフォーマンス、コンテキスト、および長時間のセッションに関する問題を参照してください。
詳細なヘルプ
- 対話モードで
/helpを実行してヘルプを表示するか、/docsでドキュメントを開きます。 /feedbackを使用してフィードバックを送信します。--debug（-d）を有効にしてデバッグログを取得し、問題の特定に役立ててください。
次のステップ
- インストールの問題：インストールとアップグレードの問題。
- サインインの問題：サインインと認証の問題。
- ネットワークの問題：ネットワーク、プロキシ、および VPC の問題。
- パフォーマンスの問題：パフォーマンス、コンテキスト、および長時間のセッションに関する問題。
- 読み込みの問題：メモリ、スキル、およびエージェントが読み込まれていません。
- 設定の問題：設定が反映されない。
- 拡張機能の問題：フック、MCP、およびプラグインの問題。