Qwen Code 設定

Qwen Code では、動作を設定する方法がいくつか用意されています。環境変数、コマンドライン引数、設定ファイルなどがあります。このドキュメントでは、それぞれの設定方法と利用可能な設定項目について説明します。

設定の優先順位

設定は以下の優先順位に従って適用されます（数字が小さいほど優先度が低く、大きいほど上書きされます）：

1. デフォルト値： アプリケーション内にハードコードされたデフォルト設定。
2. システムデフォルトファイル： 他の設定ファイルで上書き可能な、システム全体のデフォルト設定。
3. ユーザ設定ファイル： 現在のユーザー向けのグローバル設定。
4. プロジェクト設定ファイル： プロジェクト固有の設定。
5. システム設定ファイル： すべての他の設定ファイルを上書きする、システム全体の設定。
6. 環境変数： システム全体またはセッション固有の変数。.env ファイルから読み込まれる場合もあります。
7. コマンドライン引数： CLI 起動時に渡される値。

設定ファイル

Qwen Code は永続的な設定のために JSON 形式の設定ファイルを使用します。これらのファイルは以下の4つの場所に配置できます：

• システムデフォルトファイル：

  • 場所： /etc/qwen-code/system-defaults.json（Linux）、C:\ProgramData\qwen-code\system-defaults.json（Windows）または /Library/Application Support/QwenCode/system-defaults.json（macOS）。このパスは環境変数 QWEN_CODE_SYSTEM_DEFAULTS_PATH を使用して上書き可能です。
  • スコープ： システム全体での基本的なデフォルト設定を提供します。これらの設定は最も低い優先度を持ち、ユーザー設定やプロジェクト設定、システムオーバーライド設定によって上書きされることを想定しています。

• ユーザーセッティングファイル：

  • 場所： ~/.qwen/settings.json（ここで ~ はホームディレクトリです）。
  • スコープ： 現在のユーザーに対するすべての Qwen Code セッションに適用されます。

• プロジェクトセッティングファイル：

  • 場所： プロジェクトのルートディレクトリ内の .qwen/settings.json。
  • スコープ： 特定のプロジェクトから Qwen Code を実行するときのみ適用されます。プロジェクト設定はユーザーセッティングを上書きします。

• システムセッティングファイル：

  • 場所： /etc/qwen-code/settings.json（Linux）、C:\ProgramData\qwen-code\settings.json（Windows）または /Library/Application Support/QwenCode/settings.json（macOS）。このパスは環境変数 QWEN_CODE_SYSTEM_SETTINGS_PATH を使用して上書き可能です。
  • スコープ： システム上のすべてのユーザーに対して、すべての Qwen Code セッションに適用されます。システム設定はユーザーおよびプロジェクト設定よりも優先されます。エンタープライズ環境でシステム管理者がユーザーの Qwen Code のセットアップを制御したい場合に便利です。

設定における環境変数についての注意点： settings.json ファイル内の文字列値では、$VAR_NAME または ${VAR_NAME} 構文を使って環境変数を参照できます。これらの変数は設定読み込み時に自動的に解決されます。例えば、環境変数 MY_API_TOKEN がある場合、次のように settings.json 内で使用できます：

"apiKey": "$MY_API_TOKEN"

プロジェクト内の .qwen ディレクトリ

プロジェクト設定ファイルに加えて、プロジェクトの .qwen ディレクトリには Qwen Code の動作に関連するその他のプロジェクト固有のファイルを含めることができます。例:

• カスタムサンドボックスプロファイル (例: .qwen/sandbox-macos-custom.sb、.qwen/sandbox.Dockerfile)。

settings.json で利用可能な設定:

• contextFileName (文字列または文字列の配列):

  • 説明: コンテキストファイルのファイル名を指定します（例: QWEN.md, AGENTS.md）。単一のファイル名、または許可するファイル名のリストを指定できます。
  • デフォルト: QWEN.md
  • 例: "contextFileName": "AGENTS.md"

• bugCommand (オブジェクト):

  • 説明: /bug コマンドで使用されるデフォルトの URL を上書きします。
  • デフォルト: "urlTemplate": "https://github.com/QwenLM/qwen-code/issues/new?template=bug_report.yml&title={title}&info={info}"
  • プロパティ:
    • urlTemplate (文字列): {title} および {info} プレースホルダーを含むことができる URL。
  • 例:

    "bugCommand": {
      "urlTemplate": "https://bug.example.com/new?title={title}&info={info}"
    }

• fileFiltering (オブジェクト):

  • 説明: @ コマンドやファイル検出ツールにおける git を意識したファイルフィルタリングの動作を制御します。
  • デフォルト: "respectGitIgnore": true, "enableRecursiveFileSearch": true
  • プロパティ:
    • respectGitIgnore (boolean): ファイル検出時に .gitignore のパターンを尊重するかどうか。true に設定すると、git で無視されたファイル（例: node_modules/, dist/, .env）は @ コマンドやファイル一覧操作から自動的に除外されます。
    • enableRecursiveFileSearch (boolean): プロンプトで @ プレフィックスの補完中に、現在のディレクトリツリー以下を再帰的に検索するかどうか。
    • disableFuzzySearch (boolean): true に設定すると、ファイル検索時のファジー検索機能を無効にします。これにより、ファイル数の多いプロジェクトでのパフォーマンスが向上する可能性があります。
  • 例:

    "fileFiltering": {
      "respectGitIgnore": true,
      "enableRecursiveFileSearch": false,
      "disableFuzzySearch": true
    }

ファイル検索パフォーマンスのトラブルシューティング

ファイル検索（例：@ での補完）でパフォーマンスの問題が発生している場合、特に非常に多くのファイルを持つプロジェクトで問題が起きやすいです。以下に、推奨順にいくつかの対処法を示します：

1. .qwenignore を使用する： プロジェクトのルートに .qwenignore ファイルを作成し、参照する必要がない大量のファイルを含むディレクトリ（例：ビルド成果物、ログ、node_modules）を除外します。クロール対象のファイル数を減らすことが、パフォーマンス向上の最も効果的な方法です。

2. Fuzzy Search を無効にする： ファイルを無視するだけでは不十分な場合、settings.json ファイルで disableFuzzySearch を true に設定して、fuzzy search を無効にできます。これにより、よりシンプルな非fuzzyマッチングアルゴリズムが使用され、高速化される場合があります。

3. 再帰的なファイル検索を無効にする： 最後の手段として、enableRecursiveFileSearch を false に設定して、再帰的なファイル検索を完全に無効にできます。これにより、プロジェクト全体の再帰的なクロールを回避するため、最も高速なオプションになります。ただし、@ での補完を使用する際には、ファイルへのフルパスを入力する必要があるためご注意ください。

• coreTools (文字列の配列):

  • 説明: モデルで使用可能にするコアツール名のリストを指定できます。これにより、組み込みツールのセットを制限できます。コアツールの一覧については Built-in Tools を参照してください。また、ShellTool のように対応しているツールについては、コマンド単位での制限を指定できます。例："coreTools": ["ShellTool(ls -l)"] とすると、ls -l コマンドのみが実行可能になります。
  • デフォルト: モデルで使用可能なすべてのツール。
  • 例: "coreTools": ["ReadFileTool", "GlobTool", "ShellTool(ls)"].

• allowedTools (文字列の配列):

  • デフォルト: undefined
  • 説明: 確認ダイアログをバイパスするツール名のリストです。信頼しており頻繁に使用するツールに便利です。マッチングの仕組みは coreTools と同じです。
  • 例: "allowedTools": ["ShellTool(git status)"].

• excludeTools (文字列の配列):

  • 説明: モデルから除外するコアツール名のリストを指定できます。excludeTools と coreTools の両方に記載されているツールは除外されます。また、ShellTool のように対応しているツールについては、コマンド単位での制限を指定できます。例："excludeTools": ["ShellTool(rm -rf)"] とすると、rm -rf コマンドをブロックします。
  • デフォルト: 除外されるツールはありません。
  • 例: "excludeTools": ["run_shell_command", "findFiles"].
  • セキュリティに関する注意: run_shell_command に対する excludeTools のコマンド単位の制限は、単純な文字列マッチングに基づいているため、簡単に回避可能です。この機能はセキュリティメカニズムではありません。信頼できないコードを安全に実行するために使用すべきではありません。実行可能なコマンドを明示的に選択するには、coreTools を使用することを推奨します。

• allowMCPServers (文字列の配列):

  • 説明: モデルで使用可能にする MCP サーバー名のリストを指定できます。これにより、接続する MCP サーバーのセットを制限できます。--allowed-mcp-server-names が設定されている場合、この設定は無視されます。
  • デフォルト: モデルで使用可能なすべての MCP サーバー。
  • 例: "allowMCPServers": ["myPythonServer"].
  • セキュリティに関する注意: MCP サーバー名に対して単純な文字列マッチングを使用しており、変更可能です。ユーザーによるバイパスを防ぎたいシステム管理者は、システム設定レベルで mcpServers を構成し、ユーザーが独自の MCP サーバーを設定できないようにすることを検討してください。これは堅牢なセキュリティメカニズムとして使用すべきではありません。

• excludeMCPServers (文字列の配列):

  • 説明: モデルから除外する MCP サーバー名のリストを指定できます。excludeMCPServers と allowMCPServers の両方に記載されているサーバーは除外されます。--allowed-mcp-server-names が設定されている場合、この設定は無視されます。
  • デフォルト: 除外される MCP サーバーはありません。
  • 例: "excludeMCPServers": ["myNodeServer"].
  • セキュリティに関する注意: MCP サーバー名に対して単純な文字列マッチングを使用しており、変更可能です。ユーザーによるバイパスを防ぎたいシステム管理者は、システム設定レベルで mcpServers を構成し、ユーザーが独自の MCP サーバーを設定できないようにすることを検討してください。これは堅牢なセキュリティメカニズムとして使用すべきではありません。

• autoAccept (boolean):

  • 説明: CLI が安全と判断されるツール呼び出し（例：読み取り専用操作）を、明示的なユーザー確認なしに自動的に受け入れて実行するかどうかを制御します。true に設定すると、CLI は安全と判断されたツールに対して確認プロンプトをバイパスします。
  • デフォルト: false
  • 例: "autoAccept": true

• theme (string):

  • 説明: Qwen Code の視覚的な テーマ を設定します。
  • デフォルト: "Default"
  • 例: "theme": "GitHub"

• vimMode (boolean):

  • 説明: 入力編集用の vim モードを有効または無効にします。有効にすると、入力エリアで vim スタイルのナビゲーションおよび編集コマンド（NORMAL モードと INSERT モード）がサポートされます。vim モードの状態はフッターに表示され、セッション間で保持されます。
  • デフォルト: false
  • 例: "vimMode": true

• sandbox (boolean または string):

  • 説明: ツール実行時のサンドボックスの使用方法を制御します。true に設定すると、Qwen Code は事前にビルドされた qwen-code-sandbox Docker イメージを使用します。詳細については Sandboxing を参照してください。
  • デフォルト: false
  • 例: "sandbox": "docker"

• toolDiscoveryCommand (string):

  • 説明: Gemini CLI と連携。 プロジェクトからツールを検出するためのカスタムシェルコマンドを定義します。シェルコマンドは stdout に function declarations  の JSON 配列を返す必要があります。ツールラッパーはオプションです。
  • デフォルト: 空
  • 例: "toolDiscoveryCommand": "bin/get_tools"

• toolCallCommand (string):

  • 説明: Gemini CLI と連携。 toolDiscoveryCommand で検出した特定のツールを呼び出すためのカスタムシェルコマンドを定義します。シェルコマンドは以下の条件を満たす必要があります：
    • 最初のコマンドライン引数として関数 name（function declaration  と完全に一致）を受け取る必要があります。
    • stdin から JSON 形式の関数引数を読み取る必要があります。これは functionCall.args に類似しています。
    • stdout に JSON 形式の関数出力を返す必要があります。これは functionResponse.response.content に類似しています。
  • デフォルト: 空
  • 例: "toolCallCommand": "bin/call_tool"

• mcpServers (object):

  • 説明: カスタムツールを検出・使用するための 1 つ以上の Model-Context Protocol (MCP) サーバーへの接続を構成します。Qwen Code は構成された各 MCP サーバーに接続し、利用可能なツールを検出しようとします。複数の MCP サーバーが同じ名前のツールを公開している場合、ツール名には構成で定義したサーバーエイリアスが接頭辞として付加され（例：serverAlias__actualToolName）、競合を回避します。システムは互換性のために MCP ツール定義から特定のスキーマプロパティを削除する場合があります。command、url、httpUrl のうち少なくとも 1 つを指定する必要があります。複数が指定された場合、優先順位は httpUrl、url、command の順になります。
  • デフォルト: 空
  • プロパティ:
    • <SERVER_NAME> (object): 名前付きサーバーのサーバーパラメータ。
      • command (string, optional): 標準 I/O 経由で MCP サーバーを起動するためのコマンド。
      • args (array of strings, optional): コマンドに渡す引数。
      • env (object, optional): サーバープロセスに設定する環境変数。
      • cwd (string, optional): サーバーを起動する作業ディレクトリ。
      • url (string, optional): Server-Sent Events (SSE) を使用して通信する MCP サーバーの URL。
      • httpUrl (string, optional): ストリーム可能な HTTP を使用して通信する MCP サーバーの URL。
      • headers (object, optional): url または httpUrl へのリクエストで送信する HTTP ヘッダーのマップ。
      • timeout (number, optional): この MCP サーバーへのリクエストのタイムアウト（ミリ秒）。
      • trust (boolean, optional): このサーバーを信頼し、すべてのツール呼び出し確認をバイパスします。
      • description (string, optional): 表示目的で使用されるサーバーの簡単な説明。
      • includeTools (array of strings, optional): この MCP サーバーから含めるツール名のリスト。指定された場合、ここにリストされたツールのみがこのサーバーから利用可能になります（ホワイトリスト動作）。指定されていない場合、デフォルトではサーバーからのすべてのツールが有効になります。
      • excludeTools (array of strings, optional): この MCP サーバーから除外するツール名のリスト。ここにリストされたツールは、サーバーが公開していてもモデルでは利用できません。注意: excludeTools は includeTools よりも優先されます。両方のリストにツールが含まれている場合、除外されます。
  • 例:

    "mcpServers": {
      "myPythonServer": {
        "command": "python",
        "args": ["mcp_server.py", "--port", "8080"],
        "cwd": "./mcp_tools/python",
        "timeout": 5000,
        "includeTools": ["safe_tool", "file_reader"],
      },
      "myNodeServer": {
        "command": "node",
        "args": ["mcp_server.js"],
        "cwd": "./mcp_tools/node",
        "excludeTools": ["dangerous_tool", "file_deleter"]
      },
      "myDockerServer": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "-e", "API_KEY", "ghcr.io/foo/bar"],
        "env": {
          "API_KEY": "$MY_API_TOKEN"
        }
      },
      "mySseServer": {
        "url": "http://localhost:8081/events",
        "headers": {
          "Authorization": "Bearer $MY_SSE_TOKEN"
        },
        "description": "An example SSE-based MCP server."
      },
      "myStreamableHttpServer": {
        "httpUrl": "http://localhost:8082/stream",
        "headers": {
          "X-API-Key": "$MY_HTTP_API_KEY"
        },
        "description": "An example Streamable HTTP-based MCP server."
      }
    }

• checkpointing (object):

  • 説明: 会話およびファイル状態の保存・復元を可能にするチェックポイント機能を構成します。詳細については Checkpointing documentation を参照してください。
  • デフォルト: {"enabled": false}
  • プロパティ:
    • enabled (boolean): true の場合、/restore コマンドが利用可能になります。

• preferredEditor (string):

  • 説明: diff 表示に使用するエディタを指定します。
  • デフォルト: vscode
  • 例: "preferredEditor": "vscode"

• telemetry (object)

  • 説明: Qwen Code のログおよびメトリクス収集を構成します。詳細については Telemetry を参照してください。
  • デフォルト: {"enabled": false, "target": "local", "otlpEndpoint": "http://localhost:4317", "logPrompts": true}
  • プロパティ:
    • enabled (boolean): テレメトリが有効かどうか。
    • target (string): 収集されたテレメトリの送信先。サポートされる値は local および gcp。
    • otlpEndpoint (string): OTLP Exporter のエンドポイント。
    • logPrompts (boolean): ユーザープロンプトの内容をログに含めるかどうか。
  • 例:

    "telemetry": {
      "enabled": true,
      "target": "local",
      "otlpEndpoint": "http://localhost:16686",
      "logPrompts": false
    }

• usageStatisticsEnabled (boolean):

  • 説明: 使用統計情報の収集を有効または無効にします。詳細については Usage Statistics を参照してください。
  • デフォルト: true
  • 例:

    "usageStatisticsEnabled": false

• hideTips (boolean):

  • 説明: CLI インターフェースでの役立つヒントの表示を有効または無効にします。

  • デフォルト: false

  • 例:

    "hideTips": true

• hideBanner (boolean):

  • 説明: CLI インターフェースでの起動バナー（ASCII アートロゴ）の表示を有効または無効にします。

  • デフォルト: false

  • 例:

    "hideBanner": true

• maxSessionTurns (number):

  • 説明: セッションの最大ターン数を設定します。セッションがこの制限を超えると、CLI は処理を停止し、新しいチャットを開始します。
  • デフォルト: -1 (無制

settings.json の例:

{
  "theme": "GitHub",
  "sandbox": "docker",
  "toolDiscoveryCommand": "bin/get_tools",
  "toolCallCommand": "bin/call_tool",
  "tavilyApiKey": "$TAVILY_API_KEY",
  "mcpServers": {
    "mainServer": {
      "command": "bin/mcp_server.py"
    },
    "anotherServer": {
      "command": "node",
      "args": ["mcp_server.js", "--verbose"]
    }
  },
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "http://localhost:4317",
    "logPrompts": true
  },
  "usageStatisticsEnabled": true,
  "hideTips": false,
  "hideBanner": false,
  "skipNextSpeakerCheck": false,
  "skipLoopDetection": false,
  "maxSessionTurns": 10,
  "summarizeToolOutput": {
    "run_shell_command": {
      "tokenBudget": 100
    }
  },
  "excludedProjectEnvVars": ["DEBUG", "DEBUG_MODE", "NODE_ENV"],
  "includeDirectories": ["path/to/dir1", "~/path/to/dir2", "../path/to/dir3"],
  "loadMemoryFromIncludeDirectories": true
}

Shell 履歴

CLI は実行した shell コマンドの履歴を保持します。異なるプロジェクト間での競合を避けるため、この履歴はユーザーのホームフォルダ内のプロジェクト固有のディレクトリに保存されます。

• 場所: ~/.qwen/tmp/<project_hash>/shell_history
  • <project_hash> はプロジェクトのルートパスから生成された一意の識別子です。
  • 履歴は shell_history という名前のファイルに保存されます。

## 環境変数と `.env` ファイル
 
環境変数は、アプリケーションを設定する一般的な方法です。特に API キーのような機密情報や、環境によって変わる設定に使われます。認証の設定については、[認証ドキュメント](./authentication.md) を参照してください。利用可能なすべての認証方法が記載されています。
 
CLI は `.env` ファイルから自動的に環境変数を読み込みます。読み込み順序は以下の通りです：
 
1.  カレントディレクトリにある `.env` ファイル。
2.  見つからない場合、親ディレクトリを上に向かって探索し、`.env` ファイルが見つかるか、プロジェクトルート（`.git` フォルダで識別）またはホームディレクトリに到達するまで続けます。
3.  それでも見つからない場合、`~/.env`（ユーザーのホームディレクトリ内）を探します。
 
**環境変数の除外：** 一部の環境変数（例：`DEBUG` や `DEBUG_MODE`）は、CLI の動作に干渉するのを防ぐため、プロジェクトの `.env` ファイルからはデフォルトで除外されます。`.qwen/.env` ファイルからの変数は除外されません。この動作は、`settings.json` ファイルの `excludedProjectEnvVars` 設定でカスタマイズできます。
 
- **`OPENAI_API_KEY`**:
  - 利用可能な複数の[認証方法](./authentication.md)の一つ。
  - シェルプロファイル（例：`~/.bashrc`、`~/.zshrc`）または `.env` ファイルで設定します。
- **`OPENAI_BASE_URL`**:
  - 利用可能な複数の[認証方法](./authentication.md)の一つ。
  - シェルプロファイル（例：`~/.bashrc`、`~/.zshrc`）または `.env` ファイルで設定します。
- **`OPENAI_MODEL`**:
  - 使用するデフォルトの OPENAI モデルを指定します。
  - ハードコードされたデフォルト値を上書きします。
  - 例: `export OPENAI_MODEL="qwen3-coder-plus"`
- **`GEMINI_SANDBOX`**:
  - `settings.json` の `sandbox` 設定の代替。
  - `true`、`false`、`docker`、`podman`、またはカスタムコマンド文字列を受け取ります。
- **`SEATBELT_PROFILE`**（macOS 固有）:
  - macOS 上で Seatbelt（`sandbox-exec`）プロファイルを切り替えます。
  - `permissive-open`: （デフォルト）プロジェクトフォルダ（およびいくつかの他のフォルダ）への書き込みを制限しますが、その他の操作は許可されます（詳細は `packages/cli/src/utils/sandbox-macos-permissive-open.sb` を参照）。
  - `strict`: デフォルトで操作を拒否する厳格なプロファイルを使用します。
  - `<profile_name>`: カスタムプロファイルを使用します。カスタムプロファイルを定義するには、プロジェクトの `.qwen/` ディレクトリに `sandbox-macos-<profile_name>.sb` という名前のファイルを作成します（例：`my-project/.qwen/sandbox-macos-custom.sb`）。
- **`DEBUG` または `DEBUG_MODE`**（CLI 自体や内部ライブラリでよく使われる）:
  - `true` または `1` に設定すると、詳細なデバッグログを有効にします。トラブルシューティングに役立ちます。
  - **注意：** これらの変数は、CLI の動作に干渉するのを防ぐため、プロジェクトの `.env` ファイルからはデフォルトで除外されます。Qwen Code でこれらの変数を使用する必要がある場合は、`.qwen/.env` ファイルを使用してください。
- **`NO_COLOR`**:
  - 任意の値を設定すると、CLI のすべてのカラー出力を無効にします。
- **`CLI_TITLE`**:
  - 文字列を設定して、CLI のタイトルをカスタマイズします。
- **`CODE_ASSIST_ENDPOINT`**:
  - コードアシストサーバーのエンドポイントを指定します。
  - 開発やテストに便利です。
- **`TAVILY_API_KEY`**:
  - Tavily ウェブ検索サービスの API キー。
  - `web_search` ツール機能を有効にするために必要です。
  - 設定されていない場合、ウェブ検索ツールは無効化されスキップされます。
  - 例: `export TAVILY_API_KEY="tvly-your-api-key-here"`

コマンドライン引数

CLI 実行時に直接渡された引数は、そのセッションにおいて他の設定を上書きできます。

• --model <model_name> (-m <model_name>):
  • このセッションで使用する Qwen モデルを指定します。
  • 例: npm start -- --model qwen3-coder-plus
• --prompt <your_prompt> (-p <your_prompt>):
  • プロンプトを直接コマンドに渡すために使用します。これにより、Qwen Code が非インタラクティブモードで起動します。
• --prompt-interactive <your_prompt> (-i <your_prompt>):
  • 指定したプロンプトを初期入力としてインタラクティブセッションを開始します。
  • プロンプトはセッション開始前に処理されるのではなく、セッション内で処理されます。
  • stdin からのパイプ入力がある場合は使用できません。
  • 例: qwen -i "explain this code"
• --sandbox (-s):
  • このセッションでサンドボックスモードを有効にします。
• --sandbox-image:
  • サンドボックスイメージの URI を設定します。
• --debug (-d):
  • このセッションでデバッグモードを有効にし、より詳細な出力を提供します。
• --all-files (-a):
  • 設定すると、現在のディレクトリ内のすべてのファイルを再帰的にプロンプトのコンテキストに含めます。
• --help (または -h):
  • コマンドライン引数に関するヘルプ情報を表示します。
• --show-memory-usage:
  • 現在のメモリ使用量を表示します。
• --yolo:
  • YOLO モードを有効にし、すべてのツール呼び出しを自動的に承認します。
• --approval-mode <mode>:
  • ツール呼び出しの承認モードを設定します。サポートされるモード:
    • plan: 分析のみ—ファイルの変更やコマンドの実行は行いません。
    • default: ファイル編集やシェルコマンドには承認が必要（デフォルトの動作）。
    • auto-edit: 編集系ツール（edit、write_file）は自動承認し、それ以外は確認を求めます。
    • yolo: すべてのツール呼び出しを自動承認（--yolo と同等）。
  • --yolo と同時に使用することはできません。新しい統一アプローチでは、--yolo の代わりに --approval-mode=yolo を使用してください。
  • 例: qwen --approval-mode auto-edit
• --allowed-tools <tool1,tool2,...>:
  • 確認ダイアログをスキップするツール名のカンマ区切りリスト。
  • 例: qwen --allowed-tools "ShellTool(git status)"
• --telemetry:
  • telemetry を有効にします。
• --telemetry-target:
  • テレメトリーターゲットを設定します。詳細は telemetry を参照してください。
• --telemetry-otlp-endpoint:
  • テレメトリー用の OTLP エンドポイントを設定します。詳細は telemetry を参照してください。
• --telemetry-otlp-protocol:
  • テレメトリー用の OTLP プロトコルを設定します（grpc または http）。デフォルトは grpc です。詳細は telemetry を参照してください。
• --telemetry-log-prompts:
  • テレメトリー用にプロンプトのログを有効にします。詳細は telemetry を参照してください。
• --checkpointing:
  • checkpointing を有効にします。
• --extensions <extension_name ...> (-e <extension_name ...>):
  • セッションで使用する拡張機能のリストを指定します。指定しない場合、利用可能なすべての拡張機能が使用されます。
  • 特殊なキーワード qwen -e none を使用して、すべての拡張機能を無効にできます。
  • 例: qwen -e my-extension -e my-other-extension
• --list-extensions (-l):
  • 利用可能なすべての拡張機能をリスト表示して終了します。
• --proxy:
  • CLI で使用するプロキシを設定します。
  • 例: --proxy http://localhost:7890
• --include-directories <dir1,dir2,...>:
  • マルチディレクトリ対応のためにワークスペースに追加のディレクトリを含めます。
  • 複数回指定するか、カンマ区切りで指定できます。
  • 最大で 5 つのディレクトリを追加できます。
  • 例: --include-directories /path/to/project1,/path/to/project2 または --include-directories /path/to/project1 --include-directories /path/to/project2
• --screen-reader:
  • アクセシビリティのためのスクリーンリーダーモードを有効にします。
• --version:
  • CLI のバージョンを表示します。
• --openai-logging:
  • デバッグおよび分析のために OpenAI API 呼び出しのログを有効にします。このフラグは settings.json の enableOpenAILogging 設定を上書きします。
• --tavily-api-key <api_key>:
  • このセッションでウェブ検索機能を使用するための Tavily API キーを設定します。
  • 例: qwen --tavily-api-key tvly-your-api-key-here

Context ファイル (階層型の指示コンテキスト)

CLI の動作設定そのものではないものの、Context ファイル（デフォルトでは QWEN.md、contextFileName 設定で変更可）は、指示コンテキスト（「メモリ」とも呼ばれます）の設定において非常に重要です。この強力な機能により、プロジェクト固有の指示、コーディングスタイルガイド、その他の関連する背景情報を AI に提供でき、あなたのニーズにより適した正確な応答が得られるようになります。CLI には、フッターにロードされた Context ファイル数を表示する UI 要素などがあり、現在のコンテキスト状態を確認できます。

• 目的: これらの Markdown ファイルには、Qwen モデルとのやり取り中に参照してほしい指示、ガイドライン、またはコンテキスト情報を記述します。システムは、この指示コンテキストを階層的に管理するように設計されています。

コンテキストファイルの例（例：QWEN.md）

以下は、TypeScriptプロジェクトのルートにあるコンテキストファイルが含むかもしれない内容の概念的な例です：

 
# Project: My Awesome TypeScript Library
 
## 一般的な指示:
 
- 新しいTypeScriptコードを生成する際は、既存のコーディングスタイルに従ってください。
- すべての新しい関数とクラスには、JSDocコメントを必ず付与してください。
- 適切な場所では、関数型プログラミングのパラダイムを優先してください。
- すべてのコードは、TypeScript 5.0およびNode.js 20+との互換性を保つ必要があります。
 
## コーディングスタイル:
 
- インデントにはスペース2つを使用してください。
- インターフェース名の先頭には`I`を付けてください（例：`IUserService`）。
- privateなクラスメンバの先頭にはアンダースコア（`_`）を付けてください。
- 常に厳密等価演算子（`===`および`!==`）を使用してください。
 
## 特定のコンポーネント: `src/api/client.ts`
 
- このファイルは、すべての外部APIリクエストを処理します。
- 新しいAPI呼び出し関数を追加する際は、堅牢なエラーハンドリングとロギングを必ず含めてください。
- すべてのGETリクエストには、既存の`fetchWithRetry`ユーティリティを使用してください。
 
```markdown
## 依存関係について:
 
- 新しい外部依存関係の導入は、どうしても必要な場合を除き避けてください。
- 新しい依存関係が必要な場合は、その理由を明記してください。
 
この例では、プロジェクト全体のコンテキスト情報や特定のコーディング規約、そして特定のファイルやコンポーネントに関する注意書きなどをどのように提供できるかを示しています。あなたの提供するコンテキストファイルがどれだけ関連性があり、正確であるかによって、AIがあなたをどの程度効果的に支援できるかが決まります。プロジェクト固有のコンテキストファイルを作成し、積極的に活用することを強く推奨します。
 
- **階層的な読み込みと優先順位:** CLIは、複数の場所からコンテキストファイル（例：`QWEN.md`）を読み込むことで、洗練された階層型メモリシステムを実現しています。このリストで下位にあるファイル（より具体的なもの）の内容は、通常、上位にあるファイル（より一般的なもの）の内容をオーバーライドまたは補完します。結合順序および最終的なコンテキストの詳細は、`/memory show` コマンドを使用して確認できます。典型的な読み込み順序は以下の通りです：
  1.  **グローバル・コンテキストファイル:**
      - 場所: `~/.qwen/<contextFileName>` （例：ユーザーのホームディレクトリにある `~/.qwen/QWEN.md`）
      - 範囲: 全てのプロジェクトに対してデフォルトの指示を与えます。
  2.  **プロジェクトルートおよび祖先ディレクトリのコンテキストファイル:**
      - 場所: CLIは現在の作業ディレクトリから開始し、各親ディレクトリを探索して設定されたコンテキストファイルを探します。探索はプロジェクトルート（`.git` フォルダで識別される）またはホームディレクトリまで続きます。
      - 範囲: プロジェクト全体またはその主要部分に関連するコンテキスト情報を提供します。
  3.  **サブディレクトリのコンテキストファイル（局所的／文脈依存）:**
      - 場所: CLIは現在の作業ディレクトリ以下のサブディレクトリにも設定されたコンテキストファイルがあるかスキャンします（ただし、`node_modules` や `.git` のような一般的な無視パターンは尊重されます）。この検索範囲はデフォルトでは最大200ディレクトリに制限されていますが、`settings.json` ファイル内の `memoryDiscoveryMaxDirs` フィールドで変更可能です。
      - 範囲: 特定のコンポーネント、モジュール、またはプロジェクトの一部に対する非常に具体的な指示を可能にします。
- **連結とUI表示:** 見つかったすべてのコンテキストファイルの内容は、それぞれの出所とパスを示す区切り文字とともに連結され、システムプロンプトの一部として提供されます。CLIのフッターには読み込まれたコンテキストファイル数が表示され、アクティブな指示コンテキストについて視覚的に把握できます。
- **コンテンツのインポート:** `@path/to/file.md` 構文を使って他のMarkdownファイルをインポートすることで、コンテキストファイルをモジュール化できます。詳しくは[Memory Import Processor documentation](../core/memport.md)をご参照ください。
- **メモリ管理コマンド:**
  - `/memory refresh` を使用すると、すべての設定された場所からコンテキストファイルを強制的に再スキャン・再読み込みできます。これによりAIへの指示コンテキストが更新されます。
  - `/memory show` を使うと、現在読み込まれている統合された指示コンテキストを表示でき、AIが利用している階層構造と内容を確認できます。
  - `/memory` コマンドとそのサブコマンド（`show` および `refresh`）の詳細については、[Commands documentation](./commands.md#memory)をご覧ください。
 
これらの設定レイヤーとコンテキストファイルの階層構造を理解し活用することで、AIのメモリを効果的に管理し、Qwen Codeの応答をあなたの特定のニーズやプロジェクトに合わせて調整することが可能になります。

サンドボックス

Qwen Code は、システムを保護するために、潜在的に安全でない操作（シェルコマンドやファイルの変更など）をサンドボックス環境内で実行できます。

サンドボックスはデフォルトでは無効になっていますが、以下の方法で有効にできます：

• --sandbox または -s フラグを使用する
• GEMINI_SANDBOX 環境変数を設定する
• --yolo または --approval-mode=yolo を使用している場合、デフォルトでサンドボックスが有効になります

デフォルトでは、事前にビルドされた qwen-code-sandbox Docker イメージを使用します。

プロジェクト固有のサンドボックス要件がある場合は、プロジェクトのルートディレクトリに .qwen/sandbox.Dockerfile というカスタム Dockerfile を作成できます。この Dockerfile はベースとなるサンドボックスイメージを元に作成できます：

FROM qwen-code-sandbox
 
# ここにカスタムの依存関係や設定を追加してください
 
# 例：
 
# RUN apt-get update && apt-get install -y some-package

COPY ./my-config /app/my-config

`.qwen/sandbox.Dockerfile` が存在する場合、Qwen Code を実行する際に `BUILD_SANDBOX` 環境変数を使用して、カスタム sandbox イメージを自動ビルドできます：

```bash
BUILD_SANDBOX=1 qwen -s

使用統計情報

Qwen Code の改善のため、匿名化された使用統計情報を収集しています。このデータは、CLI がどのように使われているかを理解し、一般的な問題を特定し、新機能の優先順位を決定するために役立ちます。

収集する情報:

• ツール呼び出し: 実行されたツール名、成功または失敗の結果、実行時間などをログに記録します。ただし、ツールに渡される引数やツールから返されるデータそのものは収集しません。
• API リクエスト: 各リクエストで使用されたモデル、リクエストの所要時間、成功したかどうかをログに記録します。プロンプトやレスポンスの内容は収集しません。
• セッション情報: 有効になっているツールや承認モードなど、CLI の設定に関する情報を収集します。

収集しない情報:

• 個人を特定できる情報（PII）: 氏名、メールアドレス、API キーなど、個人を特定できる情報は一切収集しません。
• プロンプトおよびレスポンスの内容: ユーザーが入力したプロンプトやモデルからのレスポンスの内容はログに記録しません。
• ファイルの内容: CLI によって読み書きされたファイルの中身はログに残しません。

オプトアウト方法:

以下の手順で、いつでも使用統計情報の収集を無効にできます。settings.json ファイル内の usageStatisticsEnabled プロパティを false に設定してください：

{
  "usageStatisticsEnabled": false
}

注意：使用統計情報が有効になっている場合、イベントは Alibaba Cloud RUM コレクションエンドポイントに送信されます。

• enableWelcomeBack （boolean）:
  • 説明: 会話履歴のあるプロジェクトに戻ってきたときに「お帰り」ダイアログを表示します。
  • デフォルト値: true
  • カテゴリ: UI
  • 再起動が必要か: いいえ
  • 例: "enableWelcomeBack": false
  • 詳細: 有効にすると、Qwen Code は以前に生成されたプロジェクトサマリー（.qwen/PROJECT_SUMMARY.md）があるプロジェクトに戻ってきたことを自動的に検出し、「前回の会話を続ける」または「新しく始める」選択肢を含むダイアログを表示します。この機能は /chat summary コマンドおよび終了確認ダイアログと連携しています。詳しくは Welcome Back ドキュメント を参照してください。