> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# トラブルシューティング

> よくある問題とその対処法

<div id="installation-issues">
  ## インストールに関する問題
</div>

<AccordionGroup>
  <Accordion title="インストールコマンドが失敗する（macOS / Linux / WSL）">
    インストールスクリプトのダウンロードに失敗する場合:

    1. インターネット接続を確認します
    2. curl がインストールされていることを確認します: `which curl`
    3. 詳細出力を有効にして試します: `curl -fsSL -v https://cli.devin.ai/install.sh | bash`

    企業プロキシ環境を利用している場合は、プロキシ設定が必要になることがあります:

    ```bash theme={null}
    export https_proxy=http://your-proxy:port
    curl -fsSL https://cli.devin.ai/install.sh | bash
    ```
  </Accordion>

  <Accordion title="インストールコマンドが失敗する（Windows）">
    PowerShell のインストールスクリプトが失敗する場合:

    1. インターネット接続を確認します
    2. PowerShell を通常ユーザーとして実行していることを確認します (必要な場合を除き、管理者として実行しないでください)
    3. 実行ポリシー エラーが表示される場合は、次を試します:
       ```powershell theme={null}
       Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
       irm https://static.devin.ai/cli/setup.ps1 | iex
       ```
    4. 企業プロキシ環境を利用している場合は、インストールコマンドを実行する前に PowerShell でプロキシ設定を行います

    PowerShell スクリプトの代替手段として、スタンドアロン インストーラーを直接ダウンロードして実行することもできます:

    * [x86\_64](https://static.devin.ai/cli/devin-updater-x86_64-pc-windows.exe)
    * [ARM64](https://static.devin.ai/cli/devin-updater-aarch64-pc-windows.exe)
  </Accordion>

  <Accordion title="インストール中に permission denied が発生する">
    バイナリをインストールするには、インストーラーに書き込み権限が必要です。権限エラーが表示される場合:

    1. インストール先に書き込み権限があることを確認します
    2. インストーラーを `sudo` で実行しないでください — 所有者の問題が発生する可能性があります
    3. システムディレクトリにインストールする場合は、ユーザーに適切な権限があることを確認します
  </Accordion>

  <Accordion title="インストール後にバイナリが見つからない">
    インストールは完了しているのに `devin` が見つからない場合:

    **macOS / Linux / WSL:**

    1. ターミナルを再起動するか、`source ~/.bashrc` (または `~/.zshrc`) を実行します
    2. バイナリの場所が PATH に含まれているか確認します: `echo $PATH`
    3. バイナリが存在することを確認します: `ls -la ~/.local/bin/devin` (またはセットアップ中に表示されたインストール先)

    **Windows:**

    1. PowerShell セッションを再起動します
    2. バイナリの場所が PATH に含まれているか確認します: `$env:PATH -split ';'`
    3. セットアップ中に表示されたインストール先にバイナリが存在することを確認します
  </Accordion>

  <Accordion title="'irm' または 'iex' コマンドが見つからない（Windows）">
    `irm` と `iex` は PowerShell のエイリアスです。このエラーが表示される場合、インストールコマンドを PowerShell ではなく Git Bash または CMD で実行しています。

    **対処法:** **PowerShell** を開き、そこでインストールコマンドを実行します:

    ```powershell theme={null}
    irm https://static.devin.ai/cli/setup.ps1 | iex
    ```

    または、Git Bash または CMD から PowerShell を明示的に呼び出すこともできます:

    ```bash theme={null}
    powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
    ```

    インストール後は、**PowerShell**、**Windows Terminal**、または **Git Bash** から Devin CLI を利用できます。
  </Accordion>
</AccordionGroup>

***

<div id="authentication-issues">
  ## 認証に関する問題
</div>

<AccordionGroup>
  <Accordion title="ログインに失敗する、またはタイムアウトする">
    ブラウザベースのログインがうまくいかない場合:

    1. リモート/SSHセッションでは、手動のトークンフローを試してください:
       ```bash theme={null}
       devin auth login --force-manual-token-flow
       ```
    2. ブラウザから認証URLにアクセスできることを確認してください
    3. EnterpriseアカウントでDevin CLIへのアクセスが有効になっていることを確認してください
  </Accordion>

  <Accordion title="'Not authorized' または権限エラー">
    ログイン後に認可エラーが表示される場合:

    1. アカウントに、Devin CLIへのアクセスに必要な適切な権限が付与されていることを確認してください。管理者に問い合わせる必要がある場合があります。Enterpriseの場合、アクセスの設定方法については [Devin Auth](/ja/cli/enterprise/devin-auth#configuring-access) または [レガシー Windsurf Auth](/ja/cli/enterprise/windsurf-auth#prerequisites) を参照してください。
    2. 一度ログアウトしてから、再度ログインしてみてください: `devin auth logout && devin auth login`
    3. 認証の状態を確認してください: `devin auth status`
  </Accordion>

  <Accordion title="トークンが拒否された、または取り消された">
    Devin CLI APIトークンは、デフォルトでは期限切れになりません。保存済みのトークンが取り消されているか、受け付けられなくなっている場合は、再度ログインする前に削除してください:

    ```bash theme={null}
    devin auth logout && devin auth login
    ```

    これで保存されている認証情報を置き換えられます。
  </Accordion>
</AccordionGroup>

***

<div id="network-proxy-issues">
  ## ネットワークとプロキシに関する問題
</div>

<AccordionGroup>
  <Accordion title="企業のプロキシ環境下で接続に失敗する">
    プロキシが設定されている場合、CLI は自身の外向き HTTPS トラフィック (認証、更新、モデル APIコール、MCPサーバー) をプロキシ経由で送信します。設定方法は 2 つあります。

    **環境変数** — デフォルトの `system` プロキシモードでは、これらの設定が使用されます。

    ```bash theme={null}
    export HTTPS_PROXY=http://proxy.corp.example.com:8080
    export HTTP_PROXY=http://proxy.corp.example.com:8080
    export ALL_PROXY=socks5://proxy.corp.example.com:1080   # 任意、SOCKS5
    export NO_PROXY=localhost,127.0.0.1,.internal.corp      # プロキシをバイパスするホスト
    ```

    **`config.json`** — 環境に関係なく適用されます。

    ```json theme={null}
    {
      "proxy": {
        "mode": "manual",
        "url": "http://proxy.corp.example.com:8080",
        "no_proxy": "localhost,127.0.0.1,.internal.corp"
      }
    }
    ```

    利用可能なすべてのオプションについては、[`proxy` 設定リファレンス](/ja/cli/reference/configuration/config-file#proxy)を参照してください。macOS と Windows では、`system` モードはプラットフォーム標準の PAC (プロキシ自動設定) も使用します。

    プロキシが TLS インスペクションを行う場合、CLI はオペレーティングシステムの証明書ストアを利用するため、プロキシのルート CA を OS レベルでインストールしてください (macOS では Keychain、Windows では証明書ストア、Linux ではディストリビューションの CA バンドル) 。
  </Accordion>

  <Accordion title="デバッグのために HTTP リクエストの完全なログを取得する">
    リクエストのライフサイクル全体 (DNS、接続プーリング、TLS ハンドシェイク、ヘッダー、リダイレクト、リトライ) を詳しく確認するには、`RUST_LOG` でログレベルを上げ、`CHISEL_LOG_STDOUT` でログをターミナルにミラー出力します。

    ```bash theme={null}
    RUST_LOG="chisel=trace,windsurf_api_client=trace,connect_rpc=trace,reqwest=trace,hyper=trace,hyper_util=trace,rustls=trace" \
      CHISEL_LOG_STDOUT=1 \
      devin auth login
    ```

    各ターゲットで追加される内容:

    * `chisel`, `windsurf_api_client`, `connect_rpc` — CLI 自体のリクエストと認証に関するログ
    * `reqwest=trace` — 上位レベルのリクエスト/レスポンスおよびリダイレクト処理
    * `hyper=trace` / `hyper_util=trace` — 接続確立、プーリング、HTTP/1.1 と HTTP/2 のフレーミング
    * `rustls=trace` — TLS ハンドシェイクの詳細 (プロキシや証明書の問題の調査に有用)

    コマンド出力にログを混在させたくない場合は、`CHISEL_LOG_STDOUT=1` の代わりに `CHISEL_LOG_STDERR=1` を利用してください。 (インタラクティブ REPL と ACP モードでは、出力を壊さないよう stdout へのログ出力は自動的に抑制されます。)

    これらの環境変数に関係なく、ログは常に CLI のデータディレクトリ配下にある実行ごとのログファイルにも書き込まれます。

    * **macOS / Linux:** `~/.local/share/devin/cli/logs/devin_<timestamp>_<pid>.log`
    * **Windows:** `%APPDATA%\devin\cli\logs\devin_<timestamp>_<pid>.log`

    <Warning>
      トレースレベルのログには、`Authorization` ヘッダーやトークンなどの機密データが含まれる場合があります。共有前にログ出力を適切にマスクしてください。
    </Warning>
  </Accordion>

  <Accordion title="完全なリクエスト本文とレスポンス本文を調べる">
    `RUST_LOG` ではリクエストのライフサイクルは確認できますが、完全なpayloadは確認できません。完全なリクエスト本文とレスポンス本文を取得するには、CLI を [mitmproxy](https://mitmproxy.org/) のようなインターセプトプロキシ経由で利用します。

    ```bash theme={null}
    # Terminal 1 — インターセプトプロキシを起動:
    mitmproxy --listen-port 8080

    # Terminal 2 — CLI がそれを利用するよう設定:
    export HTTPS_PROXY=http://127.0.0.1:8080
    devin auth login
    ```

    CLI は OS の証明書ストアを信頼するため、まず mitmproxy の CA certificate (`~/.mitmproxy/mitmproxy-ca-cert.pem`) をシステムのトラストストアにインストールしてください。そうしないと、プロキシへの TLS 接続は失敗します。
  </Accordion>
</AccordionGroup>

***

<div id="runtime-issues">
  ## ランタイム関連の問題
</div>

<AccordionGroup>
  <Accordion title="モデルを利用できません">
    モデルを利用できないというエラーが表示される場合:

    1. [チーム設定](/ja/cli/enterprise/team-settings) で、お使いのEnterpriseが利用可能なモデルを制限していないか確認してください
    2. モデル名が正しいことを確認してください — 利用可能なオプションを確認するには `/model` を使用します
    3. 別のモデルを試してください: `devin --model sonnet -- your prompt`
  </Accordion>

  <Accordion title="レート制限または利用枠の超過">
    使用量の上限に達した場合:

    1. 数分待ってから再試行してください
    2. 利用枠の状況を組織の使用量ダッシュボードで確認してください
    3. より高い上限が必要な場合は、管理者に連絡してください
  </Accordion>

  <Accordion title="エージェントが停止している、または応答しないように見える">
    エージェントが応答しなくなった場合:

    1. `Ctrl+C` を押して現在の操作を中断してください
    2. `/clear` を試して新しいセッションを開始してください
    3. ネットワーク接続を確認してください
    4. Devin CLI を再起動してください
  </Accordion>
</AccordionGroup>

***

<div id="mcp-server-issues">
  ## MCP サーバーのトラブル
</div>

<AccordionGroup>
  <Accordion title="サーバーが起動しない">
    MCP サーバーが起動しない場合:

    1. Devin CLI の外でコマンドが動作することを確認します:
       ```bash theme={null}
       npx -y @modelcontextprotocol/server-github
       ```
    2. 必要な環境変数がすべて設定されていることを確認します
    3. サーバーの出力でエラーメッセージを確認します
  </Accordion>

  <Accordion title="ツールが表示されない">
    MCP ツールが表示されない場合:

    1. サーバーの初期化に少し時間がかかることがあります。数秒待ってください
    2. 設定ファイルでサーバーが正しく設定されていることを確認します
    3. [チーム設定](/ja/cli/enterprise/team-settings) で、Enterprise で MCP サーバーが許可されていることを確認します
  </Accordion>

  <Accordion title="MCP ツールで権限拒否エラーが出る">
    MCP ツールはデフォルトで承認を求めます。特定のツールを自動承認するには、権限設定に追加します:

    ```json theme={null}
    {
      "permissions": {
        "allow": ["mcp__github__list_issues"]
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

<div id="getting-help">
  ## サポートを受ける
</div>

まだ問題が解消しない場合:

* **サポートにメールする:** [support@cognition.ai](mailto:support@cognition.ai)
* **バグレポートを送信する:** 問題を Devin CLI の開発者に直接報告するには、Devin CLI 内で `/bug` コマンドを利用してください
* **更新を確認する:** `devin update` を実行して、最新バージョンを利用していることを確認してください