> ## 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.

# エアギャップ化された Devin のエラーコードリファレンス

> エアギャップ化された Devin CLI および Desktop が出力する LIC、MDL、IDP、NET、CFG エラーコードの完全なカタログです。各コードの意味と管理者が取るべき対応を記載しています。

> [!NOTE]
>
> このドキュメントは Devin の連邦政府向け導入環境を対象としています。[Devin ドキュメントに戻る](/ja/get-started/devin-intro)

エアギャップ化された CLI および Desktop が診断できる障害は、すべて `XXXnnn` 形式の固定コードで報告されます。コードは、ターミナルに表示されるエラーメッセージの先頭、`devin airgap doctor` の出力、Desktop の診断情報、および `auth` [監査イベント](/ja/federal/air-gapped/on-disk-formats#auth)の `error_code` フィールドに表示されます。番号はメッセージの文言ではなく発生した状態を表すため、サポート用のランブックや SIEM のアラートでキーとして利用できます。

| 名前空間 | 対象 | 詳細ページ |
| - | - | - |
| `LIC` | ライセンスファイルの検証 | [ライセンス](/ja/federal/air-gapped/license) |
| `MDL` | モデルファイルの検証 | [モデルファイル](/ja/federal/air-gapped/models-file) |
| `IDP` | SSO (シングルサインオン) とアイデンティティプロバイダー | [SSO](/ja/federal/air-gapped/sso) |
| `NET` | エンドポイントへの到達性、TLS、HTTP プローブ | [ネットワークと証明書](/ja/federal/air-gapped/network-and-certificates) |
| `CFG` | ローカルパス、設定、環境 | [ネットワークと証明書](/ja/federal/air-gapped/network-and-certificates)、[モデルファイル](/ja/federal/air-gapped/models-file) |

## `LIC` ライセンス

`LIC00n: <message>` の形式で出力され、その後にチェック対象のパスと、パスの上書き方法 (`DEVIN_LICENSE_FILE`) が表示されます。

| コード | 意味 | 対処方法 |
| - | - | - |
| `LIC001` | `/etc/devin/license.devin-onprem-license` (Windows では `C:\ProgramData\Devin\license.devin-onprem-license`) 、または `DEVIN_LICENSE_FILE` で指定したパスにライセンスファイルが存在しないか、読み取れません。Windows では、標準ユーザーが Desktop から管理者所有のライセンスを置き換えようとした場合にも返されます。 | デフォルトのパスにファイルを配置するか、`DEVIN_LICENSE_FILE` を設定してください。また、Devin を実行するユーザーに読み取り権限があることを確認してください。 |
| `LIC002` | ファイルの形式が不正です。有効な EdDSA JWT ではないか、ヘッダーに `kid` がありません。 | ポータルからライセンスを再ダウンロードし、内容を一切変更せずにそのまま転送してください (改行の追加、折り返し、エンコーディングの変更は行わないでください) 。 |
| `LIC003` | 署名の検証に失敗しました。 | 署名後にペイロードが改変されています。ライセンスを再ダウンロードしてください。 |
| `LIC004` | 不明な `kid` です。この build には一致する公開キーが埋め込まれていません。 | [`kid` チェック](/ja/federal/air-gapped/license#check-the-key-id)を実行してください。ライセンスが別の環境で発行されたか、使用中の build がキーのローテーション以前のものです。現在のリリースをインストールしてください。 |
| `LIC005` | 有効期限が切れ、24 時間の猶予期間も過ぎています。 | ポータルからライセンスを更新してください。 |
| `LIC006` | まだ有効になっていません。発行日時が現在より 24 時間以上先になっています。 | ホストの時刻を確認してください。時刻が正しい場合は、サポートチームにお問い合わせください。 |
| `LIC007` | `product` クレームが正しくありません (`devin-onprem` ではありません) 。 | このファイルはエアギャップ化された Devin のライセンスではありません。ポータルから再ダウンロードしてください。 |

## `MDL` モデルファイル

`devin models validate`、`devin airgap doctor`、Desktop のモデル設定、およびエージェントの起動時に報告されます。各診断には、対象となるモデル項目の名前が示されます。

| コード | 意味 | 対処法 |
| - | - | - |
| `MDL001` | ファイルがスキーマ v0 に準拠した有効な JSON ではありません(不明なフィールドを含む場合も該当)。 | JSON を修正し、[スキーマ](/ja/federal/air-gapped/models-file#schema-reference-version-0)にないフィールドを削除してください。 |
| `MDL002` | サポートされていない `schema_version` です。 | `"schema_version": 0` を設定してください。 |
| `MDL003` | `models` が空です。 | モデル項目を少なくとも 1 つ追加してください。 |
| `MDL004` | モデルの `name` が空です。 | すべての項目に一意の `name` を指定してください。 |
| `MDL005` | モデルの `name` が重複しています。 | いずれかの項目の名前を変更してください。 |
| `MDL006` | `base_url` が空です。 | エンドポイントの URL を設定してください。 |
| `MDL007` | `api_key.env` が空です。 | キーを格納する環境変数の名前を指定してください。 |
| `MDL008` | `max_context_tokens` がゼロです。 | モデルの前提情報ウィンドウを設定してください。 |
| `MDL009` | 複数のモデルが `default` に指定されています。 | `default: true` は 1 つの項目にのみ指定してください。 |
| `MDL010` | `base_url` がホストを含む `https://` URL ではありません(`http://` はループバックアドレスの場合のみ許可されます)。 | `https://` を使用するか、同一ホスト上のサーバーの場合はループバックアドレスを使用してください。 |
| `MDL011` | `max_output_tokens` が `max_context_tokens` を超えています。 | `max_output_tokens` の値を下げてください。 |
| `MDL012` | ファイルは存在しますが、読み取れませんでした(権限の問題、または無効な UTF-8)。 | Devin を実行するユーザーに読み取り権限を付与し、ファイルを UTF-8 で保存してください。 |
| `MDL013` | `max_output_tokens` がゼロです。 | フィールドを削除するか、正の値を設定してください。 |
| `MDL014` | ファイルが別のユーザーの所有であるため、Desktop はファイルを置き換えられません。 | ファイルの所有者としてディスク上のファイルを直接編集するか、`DEVIN_MODELS_FILE` で自分が所有するファイルを指定してください。 |

## `IDP` SSO とアイデンティティプロバイダー

`devin auth login`、`devin auth status`、エージェント起動時、および Desktop のサインインフローで報告されます。`IDP004` と `IDP005` は `sso_login_denied` イベントの発生時に監査ログにも書き込まれます。また、`sso_revalidation_failed` にはどの `IDP` コードも記録される可能性があります。

| コード | 意味 | 対処法 |
| - | - | - |
| `IDP001` | 認証ファイルが読み取れないか、無効です。 | `/etc/devin/auth.json` (Windows では `C:\ProgramData\Devin\auth.json`) 、または `DEVIN_AUTH_FILE` で指定したパスにあるファイルを修正してください。問題のあるフィールドはメッセージに示されます。 |
| `IDP002` | 設定済みの発行者に対するキャッシュ済みのログイン情報がありません。 | `devin auth login` を実行してください。 |
| `IDP003` | ログインが無効または期限切れで、バックグラウンドでの更新にも失敗しました (IdP から `invalid_grant` レスポンスが返された場合を含む) 。 | `devin auth login` を再度実行してください。 |
| `IDP004` | ログイン済みですが、ユーザーが `required_group` のメンバーではありません。 | IdP 側でユーザーをグループに追加するか、認証ファイルの `required_group` / `groups_claim` を修正してください。 |
| `IDP005` | IdP に到達できないか、IdP がエラーを返したか、返された ID トークンの検証に失敗しました。 | ネットワークの到達性、TLS の信頼設定 (`DEVIN_CA_BUNDLE`) 、`issuer` の値、および IdP 側のログを確認してください。 |
| `IDP006` | ローカルの SSO トークンキャッシュが読み取れないか、形式が不正か、現在のユーザー専用になっていません。 | `devin auth login` を実行してください。再ログインすると、所有者のみがアクセスできる権限でキャッシュが書き直されます。 |

## `NET` ネットワーク

`devin airgap doctor` のエンドポイントプローブ、および推論リクエストと IdP リクエストで報告されます。各 `NET` エラーには、元となったエラーチェーンが含まれます。

| コード | 意味 | 対処法 |
| - | - | - |
| `NET001` | エンドポイントホストの DNS 名前解決に失敗しました。 | モデルファイルまたは認証ファイルに記載されたホスト名と、ワークステーションの DNS 設定を確認してください。 |
| `NET002` | TCP 接続を確立できませんでした (拒否、リセット、またはルーティング不可) 。 | エンドポイントが該当ポートで待ち受けていること、およびファイアウォールやプロキシのルールでワークステーションからのアクセスが許可されていることを確認してください。 |
| `NET003` | TLS ハンドシェイクに失敗しました。証明書が信頼されていない、有効期限が切れている、または名前が一致していません。`devin airgap doctor` は、取得できた場合はサーバーが提示した証明書 (サブジェクト、発行者、有効期限) と、`DEVIN_CA_BUNDLE` が適用されていたかどうかを出力します。 | [`DEVIN_CA_BUNDLE`](/ja/federal/air-gapped/network-and-certificates#trust-a-private-ca-with-devin_ca_bundle) でプライベート CA を信頼するか、サーバー証明書 (名前、チェーン、有効期限) を修正してください。 |
| `NET004` | エンドポイントが 401/403 以外のエラー HTTP ステータスを返しました。一部の OpenAI 互換サーバーは `/models` を実装していないため、`GET {base_url}/models` に対する `404` は警告として報告されます。 | エンドポイント側のログと `base_url` のパス (例えば `/v1` が抜けていないか) を確認してください。 |
| `NET005` | リクエストがタイムアウトしました (doctor のプローブは 10 秒、IdP リクエストは 30 秒、推論は接続 30 秒 / 読み取り 300 秒) 。 | エンドポイントおよび経由するプロキシの負荷を確認してください。詳しくは[タイムアウト](/ja/federal/air-gapped/network-and-certificates#timeouts)を参照してください。 |
| `NET006` | エンドポイントが設定済みの認証情報を拒否しました (HTTP 401/403) 。 | `api_key.env` で指定した変数の値と、そのキーがエンドポイントで有効かどうかを確認してください。 |

## `CFG` 設定

`devin airgap doctor` の実行時および起動時に報告されます。

| コード | 意味 | 対処方法 |
| - | - | - |
| `CFG001` | 必須の設定ディレクトリまたは状態ディレクトリが存在しないか、書き込みできません (`~/.config/devin`、`~/.local/share/devin`、または `cli-federal` 製品ディレクトリ。Windows では `%APPDATA%\devin` またはその `cli-federal` サブディレクトリ) 。 | ディレクトリを作成するか、Devin を実行するユーザーに合わせて所有者と権限を修正してください。 |
| `CFG002` | 設定で参照されている環境変数 (モデルの `api_key.env`) が、エージェントの環境に設定されていません。 | 変数をエクスポートするか、Desktop の `devin.acp.agentEnv` 設定で指定してください。詳しくは [APIキーの環境変数](/ja/federal/air-gapped/models-file#api-key-environment-variables) を参照してください。 |
| `CFG003` | `/etc/devin/models.json` (Windows では `C:\ProgramData\Devin\models.json`) にも、`DEVIN_MODELS_FILE` で上書き指定したパスにも、モデルファイルが見つかりません。 | モデルファイルをインストールしてください。詳しくは [モデルファイル](/ja/federal/air-gapped/models-file) を参照してください。 |
| `CFG004` | `DEVIN_CA_BUNDLE` ファイルが存在しない、読み取れない、または有効な PEM 証明書が含まれていません。 | パスまたはファイルの内容を修正してください。詳しくは [ネットワークと証明書](/ja/federal/air-gapped/network-and-certificates) を参照してください。 |
| `CFG005` | カスタムサブエージェントの定義 (`agents/**/AGENT.md`、またはフラットな `agents/<name>.md`) を解析できませんでした。主な原因は不正な YAML フロントマターで、該当するプロフィールはスキップされます。また、Devin が読み取らないフロントマターのキーが定義に含まれている場合 (たとえば `allowed-tools` ではなく `allowed_tools` と記述した場合) にも警告として報告されますが、この場合プロフィールは読み込まれます。 | 示されたファイルを、`devin doctor` が出力する解析エラーに従って修正してください。 |
| `CFG006` | OTLP エクスポートで無視される `OTEL_EXPORTER_OTLP_*` 環境変数が設定されています (`ENDPOINT`、`HEADERS`、`TIMEOUT`、`PROTOCOL` 以外のフィールド、すべての `TRACES_` 変数、またはサポートされていない `PROTOCOL`) 。これは警告で、出力されるのは変数名のみで、値は出力されません。 | 変数を削除するか、正しく修正してください。 |

`CFG005` と `CFG006` は標準的な `devin doctor` のチェックで報告されるもので、エアギャップ化された build に固有のものではありません。

## 失敗内容の読み方

検証失敗の典型的な例は次のとおりです。

```sh theme={null}
devin models validate
```

```text theme={null}
/etc/devin/models.json: 1 problem(s) found
  MDL010 [model 'qwen3-vl-32b']: model 'qwen3-vl-32b': `base_url` must be an https:// URL (plain http:// is only allowed for loopback addresses: localhost, 127.0.0.0/8, or [::1])
```

上の表で該当するコードを探して記載の対処を行い、すべてのチェックに合格するまで `devin airgap doctor` を再実行してください。ここに記載されていないコードが表示された場合は、お使いのbuildがこのページより新しいバージョンです。`devin --version` を実行し、[トラブルシューティング](/ja/federal/air-gapped/troubleshooting)の説明に従って、メッセージ全文をサポートリクエストに添えてください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.