OpenCode: OpenCode Configuration File

最終更新：2026-08-31

--- title: OpenCode設定ファイル description: OpenCodeの設定ファイル構造、opencode.jsonの完全な設定項目とよく使う設定を学ぶ order: 4 lang: ja

OpenCodeはopencode.json設定ファイルで全設定を管理します。モデル、エージェント、ツール、テーマなどを含みます。

1. 学習内容

• 設定ファイルの場所と優先順位
• opencode.jsonの完全な構造
• よく使う設定項目の詳細
• 環境変数の設定

2. 設定ファイルの場所

OpenCodeは以下の優先順位で設定を読み込みます（後者が前者を上書き）：

3. 完全な設定構造

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "model": {},
  "agent": {},
  "tools": {},
  "permission": {},
  "theme": {},
  "tui": {}
}

(1) provider（プロバイダー設定）

カスタムモデルプロバイダーの設定：

{
  "provider": {
    "my-provider": {
      "name": "My Custom Provider",
      "baseURL": "https://api.example.com/v1",
      "apiKey": "sk-xxx"
    }
  }
}

(2) model（モデル設定）

デフォルトで使用するモデルの設定：

{
  "model": {
    "default": "anthropic/claude-sonnet-4-20250514"
  }
}

(3) agent（エージェント設定）

カスタムエージェントの設定（第13課で詳細解説）：

{
  "agent": {
    "build": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-4-20250514"
    }
  }
}

(4) tools（ツール設定）

グローバルツールのオン/オフ：

{
  "tools": {
    "write": true,
    "edit": true,
    "bash": true
  }
}

(5) permission（権限設定）

きめ細かい権限制御：

{
  "permission": {
    "edit": "ask",
    "bash": {
      "*": "ask",
      "git status *": "allow",
      "grep *": "allow"
    }
  }
}

権限値の説明：

(6) tui（TUI設定）

ターミナルインターフェース設定：

{
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

4. AGENTS.md（プロジェクトルール）

AGENTS.mdはOpenCodeのプロジェクトレベルのルールファイルで、プロジェクトルートに配置し、AIの動作制約を定義します。

(1) 作成方法

TUIで入力：

/init

または手動でAGENTS.mdファイルを作成。

(2) 内容例

# Project Rules

- Always use TypeScript for new files
- Follow ESLint configuration
- Write unit tests for all new functions
- Use conventional commits format

(3) スコープ

• AIは現在のプロジェクトで自動的にAGENTS.mdのルールを読み込み、従います
• 他のプロジェクトには影響しない
• opencode.jsonと組み合わせて使用可能

5. 環境変数

実験的環境変数

❓ FAQ

📖 まとめ

• 設定ファイルは優先順位で読み込み：グローバル < プロジェクト < 環境変数
• opencode.jsonがコア設定で、モデル、エージェント、ツール、権限をカバー
• AGENTS.mdは自然言語でプロジェクトルールを定義
• 環境変数は一時的な上書きやCI/CDシーンに適している

📝 練習問題

1. 基本問題：グローバルopencode.jsonを作成し、よく使うモデルプロバイダーを設定してください。

2. 応用問題：プロジェクト用に.opencode/opencode.jsonを作成し、プロジェクトレベルのツール権限を設定してください。

3. チャレンジ問題：AGENTS.mdを作成してプロジェクトのコーディング規約とAI動作制約を定義し、OpenCodeにルールに従ってタスクを実行させてください。

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて