Skip to Content
ユーザーガイド設定信頼されたフォルダー

信頼済みフォルダー

Trusted Folders 機能は、どのプロジェクトが Qwen Code の全機能を使用できるかを制御するためのセキュリティ設定です。CLI がプロジェクト固有の設定をフォルダーから読み込む前に、ユーザーがそのフォルダーを承認するよう求めることで、悪意のあるコードの実行を防止します。

機能の有効化

Trusted Folders 機能は、デフォルトでは無効 になっています。使用するには、まず設定で有効にする必要があります。

ユーザーの settings.json ファイルに以下を追加します。

{
  "security": {
    "folderTrust": {
      "enabled": true
    }
  }
}

仕組み：信頼ダイアログ

機能を有効にすると、Qwen Code をフォルダーから初めて実行したときに、ダイアログが自動的に表示され、選択を求められます。

  • フォルダーを信頼する: 現在のフォルダー (例: my-project) に完全な信頼を付与します。
  • 親フォルダーを信頼する: 親ディレクトリ (例: safe-projects) に信頼を付与し、そのすべてのサブディレクトリも自動的に信頼します。これは安全なプロジェクトを 1 か所にまとめている場合に便利です。
  • 信頼しない: フォルダーを信頼しないものとしてマークします。CLI は制限付きの「セーフモード」で動作します。

選択内容は中央のファイル (~/.qwen/trustedFolders.json) に保存されるため、フォルダーごとに確認されるのは 1 回だけです。

この機能は fail closed（失敗時は拒否）で動作します。選択を行うまで、フォルダーは 信頼されていない とみなされます（デフォルトで信頼されるわけではありません）。そのファイルが存在しない場合（新しいマシン、ホームディレクトリの復元、dotfiles の同期セットアップなど）、より優先度の高いシグナルが決定しない限り（下記の「信頼チェックのプロセス（上級者向け）」を参照）、以前に信頼したフォルダーを含め、すべてのフォルダーは信頼されていない状態から始まります。信頼チェックがファイルのルールに到達したとき、読み取りできないファイル、無効な JSONC 構文、またはオブジェクト以外のドキュメントは重大な設定エラーとなります。キャッシュされたロードが失敗すると、CLI は “Please fix the configuration file and try again.” というメッセージで停止し、デーモンの v1 信頼チェックは 500 trusted_folders_invalid を返します。以前の IDE 信頼決定はこれらのファイルベースのチェックをバイパスできます。grant writer はルールを永続化する前にファイルを検証します。ファイルを手動で修復または削除してから、デーモンを再起動して失敗したロードをクリアしてください。コメントと末尾のカンマは許容されます。無効な信頼レベルの値は grant writer と v2 ポリシーリーダーによって検出されますが、レガシーの v1 リーダーでは検証されません。v2 はポリシーエラーを 200 と configured.state: "error" として報告します。キャッシュされたロード後にファイルが無効になった場合、grant 書き込み中に 500 internal_error で失敗するか、書き込み後のポリシー検証中に 409 trust_grant_ineffective で失敗する可能性があります。

信頼が重要な理由：信頼されていないワークスペースの影響

フォルダーが 信頼されていない 場合、Qwen Code は保護のために制限付きの「セーフモード」で実行されます。このモードでは、以下の機能が無効になります。

  1. ワークスペース設定が無視される: CLI はプロジェクトの .qwen/settings.json ファイルを 読み込みません。これにより、カスタムツールやその他の危険な可能性のある設定の読み込みを防ぎます。

  2. 環境変数が無視される: CLI はプロジェクト内の .env ファイルを 読み込みません。

  3. 拡張機能の管理が制限される: 拡張機能の インストール、更新、アンインストール ができなくなります。

  4. ツールの自動承認が無効になる: グローバルに自動承認を有効にしている場合でも、ツールを実行する前に常に確認が求められます。

  5. メモリの自動読み込みが無効になる: CLI はローカル設定で指定されたディレクトリからファイルをコンテキストに自動的に読み込みません。

フォルダーに信頼を付与すると、そのワークスペースで Qwen Code の全機能が解放されます。

信頼設定の管理

決定を変更したり、すべての設定を確認したりする必要がある場合は、いくつかの方法があります。

  • 現在のフォルダーの信頼を変更する: CLI 内で /permissions コマンドを実行します。これにより、同じ対話型ダイアログが表示され、現在のフォルダーの信頼レベルを変更できます。

  • Web シェルからワークスペースを信頼する: ワークスペースの概要を開き、信頼されていないワークスペースで 信頼 アクションを使用します。これにより、ターミナルを必要とせずに同じ決定が記録されます。これは、ルールが決定しなかったためにすべてのワークスペースが信頼されていない状態で始まった場合の復帰手段となります。このアクションは、接続されたデーモンが workspace_trust_grant をアドバタイズする場合にのみ表示されます。これは、信頼のホットリロードが実行中のランタイムに決定を適用する場合に限られます。ホットリロードなしに grant ルートを提供するデーモンは、このアクションを非表示にします。その場合、そのデーモン独自の API を通じて記録された grant は信頼ファイルと v1 信頼ステータスを即座に更新しますが、スタートアップにバインドされたランタイムゲートは再起動を必要とします。別のターミナルプロセスまたはファイル編集によって記録された決定は、デーモンのキャッシュされた v1 ステータスには即座には表示されません。読み込むにはデーモンを再起動してください。アクションが利用可能な場合、デーモンがランタイムを再構築するとワークスペースの信頼が完了します。これには少し時間がかかります。

  • すべての信頼ルールを表示する: 信頼済みおよび非信頼のフォルダールールの完全なリストを表示するには、ホームディレクトリにある ~/.qwen/trustedFolders.json ファイルの内容を確認します。

信頼チェックのプロセス (上級者向け)

上級者向けに、信頼がどのように決定されるかの正確な処理順序を説明します。

  1. IDE 信頼シグナル: IDE 統合 を使用している場合、CLI は最初に IDE にワークスペースが信頼されているかどうかを問い合わせます。IDE の応答が最も優先されます。

  2. ローカル信頼ファイル: IDE が接続されていない場合、CLI は中央の ~/.qwen/trustedFolders.json ファイルを確認します。

Last updated on
無視するファイルテーマ