設定の優先順位

Devin CLI は複数のソースから設定を読み込み、それらをまとめて適用します。優先順位を理解しておくと、チームや個人の好みに合った適切な設定を行いやすくなります。

設定レイヤー

優先度の高い順から低い順:

優先度	ソース	注記
1 (highest)	組織 / チーム設定	上書き不可
2	セッション (対話型承認)	メモリ上のみ
3	プロジェクトローカル (`.devin/config.local.json`)	個人用、gitignore 対象
4	プロジェクト (`.devin/config.json`)	チームで共有
5 (lowest)	ユーザー (`~/.config/devin/config.json`; Windows では `%APPDATA%\devin\config.json`)	デフォルト設定

同じ設定が複数のレベルで定義されている場合は、より優先度の高いソースが適用されます。

各レベルの使い分け

ユーザー設定

パス: ~/.config/devin/config.json (Windows では %APPDATA%\devin\config.json)どこでも適用される個人設定に利用します:

デフォルトのモデル設定
テーマ設定
個人用の MCP サーバー (例: 自分の APIキー)
グローバルな権限の許可設定

{
  "agent": { "model": "opus" },
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"]
  }
}

プロジェクト設定

パス: .devin/config.jsonリポジトリにコミットするチームの標準設定に利用します。このレベルで利用できるのは permissions、mcpServers、read_config_from、hooks のみです:

共有の MCP サーバー (シークレットを含まない設定)
チームの権限ポリシー
設定のインポート
ライフサイクルフック

{
  "permissions": {
    "allow": ["Exec(npm run)", "Read(src/**)"],
    "deny": ["Exec(sudo)"]
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

プロジェクトのローカル設定

パス: .devin/config.local.jsonコミットすべきでない個人用の上書き設定に利用します:

APIキーやシークレット
このプロジェクト向けの個人用ツール設定
権限の上書き

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_my_personal_token"
      }
    }
  }
}

ローカル設定ファイルは、.git/info/exclude によって自動的に git の対象外になります。

組織設定

チーム設定ダッシュボードから Enterprise 管理者が管理します。これらの設定は個々のユーザーが上書きできず、モデルの制限や MCP サーバーの許可リストなど、組織全体のポリシーを強制適用します。

各レベルで利用できる設定

プロジェクト設定 (.devin/config.json および .devin/config.local.json) でサポートされるのは一部の設定のみです。以下の表は、各レベルで利用できる設定を示しています。

設定	ユーザー設定	プロジェクト設定
`permissions`	✓	✓
`mcpServers`	✓	✓
`read_config_from`	✓	✓
`hooks`	✓	✓
`agent` (モデル)	✓	✗
`theme_mode`	✓	✗
`unicode_mode`	✓	✗
`show_path`	✓	✗
`show_hints`	✓	✗
`include_gitignored_files`	✓	✗
`sandbox`	✓	✗

ユーザー設定専用と記載された設定は、ユーザー設定 (~/.config/devin/config.json、Windows では %APPDATA%\devin\config.json) でのみ指定でき、上記の優先順位の階層には含まれません。

マージの仕組み

上記の優先順位表は、複数レベルに対応している設定 (permissions、mcpServers、read_config_from、hooks) にのみ適用されます。

権限

権限リストは、各レベルをまたいでマージ (結合) されます。上位レベルで拒否された権限は、下位レベルで許可しても上書きできません。たとえば、組織で Exec(sudo) が拒否されている場合、ユーザーの許可リストに Exec(sudo) を追加しても効果はありません。常に組織の拒否設定が優先されます。ただし、プロジェクトレベルでの Read(**) のような他の権限は、通常どおり適用されます。

MCP サーバー

MCP サーバーの設定は、名前ごとにマージされます。上位レベルで定義されたサーバーは、下位レベルの同名サーバーを上書きします。たとえば、ユーザー設定とプロジェクト設定の両方で “github” サーバーを定義している場合は、ユーザー設定より優先度が高いプロジェクト設定の内容が適用されます。

フック

フックはすべてのソースから収集され、すべて実行されます。ユーザー設定で定義されたフックは、プロジェクト設定で定義されたフックと並行して実行され、互いに上書きされることはありません。

プロジェクトルートの検出

Devin CLIは、現在の作業ディレクトリから上位に向かって.gitまたは.jjディレクトリをたどり、プロジェクトルートを特定します。プロジェクト設定 (.devin/) は、プロジェクトルートから読み込まれます。

ネストされた.devin/ディレクトリがある場合 (たとえばモノレポ内) 、サブディレクトリの設定が親ディレクトリの設定より優先されます。

ファイル検出の概要

ファイル	検出方法	共有されるか
`~/.config/devin/config.json`	XDG パス	いいえ
`.devin/config.json`	カレントワーキングディレクトリから親方向に探索	はい (コミット済み)
`.devin/config.local.json`	カレントワーキングディレクトリから親方向に探索	いいえ (gitignore 対象)
`.devin/skills/*/SKILL.md`	プロジェクトルート	はい (コミット済み)
`~/.config/devin/skills/*/SKILL.md`	XDG パス	いいえ
`AGENTS.md`	プロジェクトルート	はい (コミット済み)
`~/.config/devin/AGENTS.md`	XDG パス	いいえ

Windows: ~/.config/devin/ と表示されているパスは、Linux/macOS の XDG 規約に基づいています。Windows では、これらは %APPDATA%\devin\ (通常は C:\Users\<YourUser>\AppData\Roaming\devin\) に対応します。

​設定レイヤー

​各レベルの使い分け

​各レベルで利用できる設定

​マージの仕組み

​権限

​MCP サーバー

​フック

​プロジェクトルートの検出

​ファイル検出の概要

設定レイヤー

各レベルの使い分け

各レベルで利用できる設定

マージの仕組み

権限

MCP サーバー

フック

プロジェクトルートの検出

ファイル検出の概要