トラブルシューティング

インストールに関する問題

インストールコマンドが失敗する（macOS / Linux / WSL）

インストールスクリプトのダウンロードに失敗する場合:

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

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

export https_proxy=http://your-proxy:port
curl -fsSL https://cli.devin.ai/install.sh | bash

インストールコマンドが失敗する（Windows）

PowerShell のインストールスクリプトが失敗する場合:

インターネット接続を確認します
PowerShell を通常ユーザーとして実行していることを確認します (必要な場合を除き、管理者として実行しないでください)

実行ポリシーエラーが表示される場合は、次を試します:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
irm https://static.devin.ai/cli/setup.ps1 | iex

企業プロキシ環境を利用している場合は、インストールコマンドを実行する前に PowerShell でプロキシ設定を行います

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

x86_64
ARM64

インストール中に permission denied が発生する

バイナリをインストールするには、インストーラーに書き込み権限が必要です。権限エラーが表示される場合:

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

インストール後にバイナリが見つからない

インストールは完了しているのに devin が見つからない場合:macOS / Linux / WSL:

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

Windows:

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

'irm' または 'iex' コマンドが見つからない（Windows）

irm と iex は PowerShell のエイリアスです。このエラーが表示される場合、インストールコマンドを PowerShell ではなく Git Bash または CMD で実行しています。対処法: PowerShell を開き、そこでインストールコマンドを実行します:

irm https://static.devin.ai/cli/setup.ps1 | iex

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

powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"

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

認証に関する問題

ログインに失敗する、またはタイムアウトする

ブラウザベースのログインがうまくいかない場合:

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

'Not authorized' または権限エラー

ログイン後に認可エラーが表示される場合:

アカウントに、Devin CLIへのアクセスに必要な適切な権限が付与されていることを確認してください。管理者に問い合わせる必要がある場合があります。Enterpriseの場合、アクセスの設定方法については Devin Auth または Windsurf Auth を参照してください。
一度ログアウトしてから、再度ログインしてみてください: devin auth logout && devin auth login
認証の状態を確認してください: devin auth status

トークンの有効期限切れ

ネットワークとプロキシに関する問題

企業のプロキシ環境下で接続に失敗する

プロキシが設定されている場合、CLI は自身の外向き HTTPS トラフィック (認証、更新、モデル APIコール、MCPサーバー) をプロキシ経由で送信します。設定方法は 2 つあります。環境変数 — デフォルトの system プロキシモードでは、これらの設定が使用されます。

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 — 環境に関係なく適用されます。

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

利用可能なすべてのオプションについては、proxy 設定リファレンスを参照してください。macOS と Windows では、system モードはプラットフォーム標準の PAC (プロキシ自動設定) も使用します。プロキシが TLS インスペクションを行う場合、CLI はオペレーティングシステムの証明書ストアを利用するため、プロキシのルート CA を OS レベルでインストールしてください (macOS では Keychain、Windows では証明書ストア、Linux ではディストリビューションの CA バンドル) 。

デバッグのために HTTP リクエストの完全なログを取得する

リクエストのライフサイクル全体 (DNS、接続プーリング、TLS ハンドシェイク、ヘッダー、リダイレクト、リトライ) を詳しく確認するには、RUST_LOG でログレベルを上げ、CHISEL_LOG_STDOUT でログをターミナルにミラー出力します。

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

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

完全なリクエスト本文とレスポンス本文を調べる

RUST_LOG ではリクエストのライフサイクルは確認できますが、完全なpayloadは確認できません。完全なリクエスト本文とレスポンス本文を取得するには、CLI を mitmproxy のようなインターセプトプロキシ経由で利用します。

# 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 接続は失敗します。

ランタイム関連の問題

モデルを利用できません

モデルを利用できないというエラーが表示される場合:

チーム設定で、お使いのEnterpriseが利用可能なモデルを制限していないか確認してください
モデル名が正しいことを確認してください — 利用可能なオプションを確認するには /model を使用します
別のモデルを試してください: devin --model sonnet -- your prompt

レート制限または利用枠の超過

使用量の上限に達した場合:

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

エージェントが停止している、または応答しないように見える

エージェントが応答しなくなった場合:

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

MCP サーバーのトラブル

サーバーが起動しない

MCP サーバーが起動しない場合:

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

ツールが表示されない

MCP ツールが表示されない場合:

サーバーの初期化に少し時間がかかることがあります。数秒待ってください
設定ファイルでサーバーが正しく設定されていることを確認します
チーム設定で、Enterprise で MCP サーバーが許可されていることを確認します

MCP ツールで権限拒否エラーが出る

MCP ツールはデフォルトで承認を求めます。特定のツールを自動承認するには、権限設定に追加します:

{
  "permissions": {
    "allow": ["mcp__github__list_issues"]
  }
}

サポートを受ける

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

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

​インストールに関する問題

​認証に関する問題

​ネットワークとプロキシに関する問題

​ランタイム関連の問題

​MCP サーバーのトラブル

​サポートを受ける

インストールに関する問題

認証に関する問題

ネットワークとプロキシに関する問題

ランタイム関連の問題

MCP サーバーのトラブル

サポートを受ける