settings-management

Name: settings-management
Author: codealive-ai

github.com/codealive-aiエージェントワークフロー16744 回インストール今日更新

リポジトリ

settings-management について

Claude Code、Codex CLI、OpenCode、Devin の設定管理を支援するリファレンススキルです。設定範囲や主な項目、安全な編集手順、再起動の注意点を扱います。

主な機能

01設定範囲と優先順位
02モデル、権限、環境設定
03サンドボックス、フック、帰属情報の設定
04Codex、OpenCode、Devin のリファレンス

活用シーン

01設定の適用先を選ぶ場面
02既存値を保ってエージェント設定を更新する場面
03エージェント間の設定形式を比較する場面

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/codealive-ai/ai-driven-development --skill settings-management

インストール後、Claude Code で/settings-managementを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

claude-settings.md

codex-settings.md

devin-settings.md

opencode-settings.md

詳細

設定管理

コーディングエージェントの設定を管理します。

重要：設定を変更した後は、必ず変更を反映するためにエージェントを再起動する必要があることをユーザーに伝えてください。ほとんどの設定は起動時にのみ読み込まれます。

設定ファイルの場所

スコープ	場所	チームと共有されますか？
ユーザー	`~/.claude/settings.json`	いいえ
プロジェクト	`.claude/settings.json`	はい（コミット対象）
ローカル	`.claude/settings.local.json`	いいえ（gitignore 対象）
管理対象	システムレベルの `managed-settings.json`	IT 部門による配布

優先順位（高い順）：管理対象 → コマンドライン → ローカル → プロジェクト → ユーザー

クイックアクション

現在の設定を表示

cat ~/.claude/settings.json 2>/dev/null || echo "No user settings"
cat .claude/settings.json 2>/dev/null || echo "No project settings"
cat .claude/settings.local.json 2>/dev/null || echo "No local settings"

設定を作成・編集

Edit または Write ツールを使用して、設定ファイルを変更します。変更をマージするため、必ず最初に既存の内容を読み込んでください。

よくある設定作業

デフォルトモデルを設定

{
  "model": "claude-opus-4-7",
  "effort": "high"
}

推論レベル：low、medium、high、xhigh（Opus 4.7 のみ）、max。2026 年現在、API キー、Bedrock／Vertex／Foundry、Team、Enterprise のユーザーでは、デフォルトの推論レベルは high です。

権限を設定

{
  "permissions": {
    "allow": ["Bash(npm run:*)", "Bash(git:*)"],
    "deny": ["Read(.env)", "Read(.env.*)", "WebFetch"],
    "defaultMode": "acceptEdits"
  }
}

defaultMode で指定できる値：default、acceptEdits、plan、auto、dontAsk、bypassPermissions。新しい auto モード（2026 年 3 月）は LLM ベースの分類器を使用し、拒否時に PermissionDenied フックを実行します。

環境変数を追加

{
  "env": {
    "MY_VAR": "value",
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  }
}

拡張思考を有効化

{
  "alwaysThinkingEnabled": true
}

帰属表示を設定

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <[email protected]>",
    "pr": ""
  }
}

サンドボックスを設定

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker", "git"]
  }
}

フックを設定

{
  "hooks": {
    "PreToolUse": {
      "Bash": "echo 'Running command...'"
    }
  }
}

スコープの選択ガイド

ユーザー設定（~/.claude/settings.json）：すべてのプロジェクトで使用する個人設定
プロジェクト設定（.claude/settings.json）：チームで共有する設定。Git にコミットします
ローカル設定（.claude/settings.local.json）：個人用のプロジェクト設定の上書き。コミットしません

ワークフロー

スコープを決定：指定されていない場合は、ユーザーにスコープ（ユーザー／プロジェクト／ローカル）を尋ねます
既存の設定を読み込む：変更前に、必ず現在のファイルを読み込みます
変更をマージ：既存の設定を保持し、要求されたキーのみを変更します
JSON を検証：書き込む前に、有効な JSON であることを確認します
変更を確認：最終的な設定をユーザーに提示します
再起動を通知：変更を反映するには Claude Code の再起動が必要であることをユーザーに伝えます

Codex CLI の設定

Codex は ~/.codex/config.toml（ユーザー用）および .codex/config.toml（プロジェクト用。信頼済みプロジェクトのみ）で TOML 形式を使用します。

model = "gpt-5.5"                  # As of April 2026; gpt-5.4 is a valid fallback
approval_policy = "on-request"     # untrusted | on-request | never (or { granular = { ... } })
                                    # NOTE: "on-failure" is DEPRECATED — migrate to on-request or never
sandbox_mode = "workspace-write"   # read-only | workspace-write | danger-full-access

[features]
codex_hooks = true                 # Lifecycle hooks (stable in v0.124, April 2026)
multi_agent = true                 # Subagent orchestration (GA March 2026)

Claude Code との主な違い：

JSON ではなく TOML 形式を使用します。プロジェクト設定には明示的な信頼が必要です
.codex/rules/ のコマンドポリシーには Starlark ルールを使用します
ワークフローごとに名前付きプロファイル（[profiles.NAME]）を使用できます
機能フラグシステム（codex features list、codex --enable feature）があります
ライフサイクルフックは config.toml 内の [[hooks.PreToolUse]] などのブロックに記述します
サブエージェントのオーケストレーション用に [agents] ブロック（max_threads、max_depth）があります
スキルごとの有効化／無効化の上書きには [[skills.config]] を使用します
v0.123 以降、amazon-bedrock を含むカスタムモデルプロバイダーを [model_providers.NAME] で設定できます

Codex の設定に関する詳細は、references/codex-settings.md を参照してください（承認／サンドボックス／プロファイル／機能／エージェント／スキル／フック／ルール／プロバイダー／管理者による適用を網羅しています）。

OpenCode の設定

OpenCode（anomalyco/opencode v1.14.x）では、~/.config/opencode/opencode.json（ユーザー用）および opencode.json（プロジェクトのルート、または .opencode/ 内）で JSON/JSONC を使用します。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "permission": {
    "edit": "ask",
    "bash": { "*": "ask", "git status *": "allow" }
  },
  "instructions": ["AGENTS.md", "docs/style.md"]
}

Claude Code との主な違い：

プレーンな JSON ではなく、スキーマ検証に対応した JSON/JSONC を使用します
設定はディープマージされます（後の設定が優先されます。instructions などの配列は置き換えではなく連結されます）
権限はツールごとに allow／ask／deny を指定するオブジェクトであり、個別の allow／deny／ask 配列とグロブパターンを使用する方式ではありません
テーマとキーバインドは、別の tui.json ファイルに保存されます
model: "<provider>/<model-id>" とトップレベルの provider ブロックを使用して、複数のプロバイダーに対応します
変数の置換には {env:VAR} と {file:path} を使用します

OpenCode の設定に関する詳しいリファレンスは、references/opencode-settings.md を参照してください。

Devin CLI／デスクトップの設定

Devin では、~/.config/devin/config.json（ユーザー用。Windows では %APPDATA%\devin\config.json）、.devin/config.json（プロジェクト用）、.devin/config.local.json（プロジェクトローカル用。gitignore 対象）で JSON を使用します。MCP サーバーは、同じ階層にある専用の mcp_config.json ファイルに保存されます。

{
  "agent": { "model": "swe-2-high" },
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"],
    "ask": ["Write(**/.env*)"]
  },
  "read_config_from": { "claude": true, "cursor": true, "windsurf": true }
}

主な違い：

プロジェクト設定で指定できるのは permissions、read_config_from、hooks のみです
read_config_from は、デフォルトで .claude/、.cursor/、.windsurf/ からルール／フック／サブエージェントをインポートします
スキル：.devin/skills/（プロジェクト用）、~/.config/devin/skills/（ユーザー用）
プラグイン：.devin-plugin/plugin.json マニフェスト、devin plugins CLI

Devin の設定に関する詳しいリファレンスは、references/devin-settings.md を参照してください。

リファレンス

Claude Code の設定：references/claude-settings.md
Codex CLI の設定：references/codex-settings.md
OpenCode の設定：references/opencode-settings.md
Devin CLI／デスクトップの設定：references/devin-settings.md

Markdown 対応

ログインしてコメント

基本情報

作者: codealive-ai
リポジトリ: codealive-ai/ai-driven-development
カテゴリ: エージェントワークフロー
インストール数: 44
GitHub スター: 167

問題を報告