> ## 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 CLIの動作を構成する方法

Devin CLIは、ユーザーレベルおよびプロジェクトレベルのJSONファイル (コメント対応) で設定します。これらの設定ファイルでは、エージェントのモデル、権限、MCPサーバーなどを制御できます。

***

<div id="config-file-locations">
  ## 設定ファイルの保存場所
</div>

<Tabs>
  <Tab title="ユーザー設定">
    **Path:** `~/.config/devin/config.json`

    すべてのプロジェクトに適用される個人用のデフォルト設定です。ここで、好みのモデル、テーマ、グローバル権限を設定します。

    このディレクトリ (`~/.config/devin/AGENTS.md`) に `AGENTS.md` ファイルを配置して、すべてのプロジェクトに適用される[グローバルルール](/ja/cli/extensibility/rules#global-rules)を定義することもできます。

    <Note>
      Windows では、このパスは `%APPDATA%\devin\config.json` です (通常は `C:\Users\<you>\AppData\Roaming\devin\config.json`) 。
    </Note>

    ```json theme={null}
    {
      "agent": { "model": "claude-sonnet-4.5" },
      "permissions": {
        "allow": ["Read(**)", "Exec(git)"]
      }
    }
    ```
  </Tab>

  <Tab title="プロジェクト設定">
    **Path:** `.devin/config.json` (プロジェクトのルート)

    バージョン管理にコミットする、チームで共有する設定です。プロジェクト固有のMCPサーバー、権限ポリシー、インポート設定にはこれを利用します。

    ```json theme={null}
    {
      "permissions": {
        "allow": ["Exec(npm run)", "Read(src/**)"],
        "deny": ["Exec(sudo)"]
      },
      "mcpServers": {
        "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="ローカル上書き">
    **Path:** `.devin/config.local.json`

    `git` にコミットされない (自動的に gitignore される) 、このプロジェクト用の個人設定の上書きです。secret、APIキー、個人用設定の上書きにはこれを利用します。

    ```json theme={null}
    {
      "mcpServers": {
        "github": {
          "env": { "GITHUB_TOKEN": "ghp_your_token" }
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

<div id="what-you-can-configure">
  ## 設定できる項目
</div>

<CardGroup cols={2}>
  <Card title="モデル" icon="brain" href="/ja/cli/models">
    Claude Opus、GPT 5.2、Gemini 3 など、エージェントを動かす AI モデルを選択します。
  </Card>

  <Card title="権限" icon="shield" href="/ja/cli/reference/permissions">
    安全なアクションを事前に承認し、危険なものをブロックして、エージェントが確認なしで実行できる内容を制御します。
  </Card>

  <Card title="MCPサーバー" icon="server" href="/ja/cli/extensibility/mcp/configuration">
    GitHub、Linear、データベース、カスタム API などの外部ツールサーバーを接続します。
  </Card>

  <Card title="外部ツールのインポート" icon="arrow-right-to-bracket" href="/ja/cli/extensibility/rules">
    Cursor、Windsurf、Claude Code からルール、スキル、設定をインポートします。
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## クイックスタート
</div>

すぐに始めるには、プロジェクトのルートに `.devin/config.json` を作成します。

```json theme={null}
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Exec(git)",
      "Exec(npm run)"
    ]
  }
}
```

これにより、ファイルの読み取りと一般的なコマンドが事前承認されるため、エージェントは操作のたびに確認を求めなくなります。

<Tip>
  Devin CLI は対話形式で設定することもできます。エージェントが許可を求めたときに、その判断を次回以降のためにプロジェクト設定またはユーザー設定へ保存することもできます。
</Tip>

***

<div id="project-vs-user-settings">
  ## プロジェクト設定とユーザー設定
</div>

すべての設定がどのレベルでも利用できるわけではありません。プロジェクト設定ファイル (`.devin/config.json` と `.devin/config.local.json`) でサポートされているのは次の項目です。

* **`permissions`** — allow、deny、ask ルール
* **`mcpServers`** — MCPサーバー の定義
* **`read_config_from`** — Cursor、Windsurf、Claude から設定をインポート
* **`hooks`** — ライフサイクルフック ([Hooksを参照](/ja/cli/extensibility/hooks/overview))

これ以外のすべての設定 (`agent` (モデル) 、`theme_mode`、`unicode_mode`、`show_path`、`sandbox`、およびその他の表示・動作オプションを含む) は **ユーザー設定のみ** で利用でき、ユーザー設定ファイル (`~/.config/devin/config.json`、Windows では `%APPDATA%\devin\config.json`) でのみ設定できます。

***

<div id="configuration-precedence">
  ## 設定の優先順位
</div>

複数レベルに対応する設定では、優先度の高いソースが優先されます。

| 優先度    | ソース                                                                            | 共有対象?              |
| ------ | ------------------------------------------------------------------------------ | ------------------ |
| 1 (最高) | 組織 / チーム設定                                                                     | はい (Enterprise)    |
| 2      | セッション許可 (対話型承認)                                                                | いいえ (メモリ上のみ)       |
| 3      | プロジェクト ローカル (`.devin/config.local.json`)                                       | いいえ (gitignore 対象) |
| 4      | プロジェクト (`.devin/config.json`)                                                  | はい (コミット済み)        |
| 5 (最低) | ユーザー (`~/.config/devin/config.json`; Windows では `%APPDATA%\devin\config.json`) | いいえ (個人)           |

権限はレベルをまたいでマージされ、MCP サーバーは名前ごとにマージされます (同名のサーバーがある場合は、優先度の高いソースが適用されます) 。

<Note>
  組織レベル (Enterprise) の設定は、プロジェクトまたはユーザーの設定で**上書きされることはありません**。マージの仕組みの詳細については、[設定の優先順位](/ja/cli/reference/configuration/global-vs-local)を参照してください。
</Note>

***

<div id="limitations">
  ## 制限事項
</div>

<Warning>
  Devin CLI は `.codeiumignore` ファイルをサポートしていません。Codeium のオートコンプリートを利用していて、無視パターンを設定している場合でも、それらのパターンは Devin CLI には適用されません。
</Warning>

***

<div id="learn-more">
  ## さらに詳しく
</div>

<CardGroup cols={2}>
  <Card title="設定リファレンス（完全版）" icon="file-code" href="/ja/cli/reference/configuration/config-file">
    すべての設定オプションとその形式を網羅した一覧です。
  </Card>

  <Card title="設定の優先順位" icon="layer-group" href="/ja/cli/reference/configuration/global-vs-local">
    グローバル、プロジェクト、ローカルの各設定がどのように相互に作用し、組み合わされるかを説明します。
  </Card>
</CardGroup>