コンテンツにスキップ
Documentation

AIエージェントの権限と安全性

エージェントはアクションを提案するのみです。ファイルの編集やコマンドの実行はすべて、 何かが行われる前に、お使いのマシン上で権限チェックが行われ、このチェックを 無効にすることはできません。

確認なしに常に実行される動作

Section titled “確認なしに常に実行される動作”

読み取り専用ツールは、ワークスペース内で自由に実行できます。ファイルの読み取り、ディレクトリの 一覧表示、検索、および読み取り専用操作が可能です。 git 次のようなコマンド status, diff、 および log。ワークスペースとは、エージェントを起動したディレクトリと、 で追加されたディレクトリのすべてを指します。 --add-dir または /add-dir。それ以外のパスについては、 .. エスケープ文字や、外部へ誘導するリンクは拒否されます。

を押してください Shift+Tab を押すとモードを切り替えることができます。現在のモードはステータス 行に表示されます。

モードファイルの編集コマンド
ask (デフォルト)毎回確認する毎回確認する
accept-editsワークスペース内では確認なしで実行します引き続き確認する
plan拒否拒否

In plan モードでは、エージェントは変更を実行する代わりに、 変更内容を調査して説明します。 /plan 計画リクエストの場合は、プランモードに切り替わります。

開始モードは、 --permission-mode、または /permissions mode MODE、 または defaultMode 設定ファイルで指定します。すべての 権限チェックをスキップするモードはありません。

プロンプトには、具体的に何が実行されるかが表示されます。編集の場合は差分、 コマンドの場合は完全なコマンドラインと作業ディレクトリ、MCPツールの場合は サーバーと引数です。以下の選択肢から選ぶことができます:

  • 「はい」 を選択すると、1回実行されます。
  • はい、かつ「再度尋ねない」 このプロジェクト内のそのコマンドプレフィックスまたはファイルパターンに対して 適用されます。このルールは、このプロジェクトのあなた自身の設定に、以下に保存されます。 $CONFIG/ai/projects/、リポジトリ内には決して含まれません。
  • いいえ、その理由をAIに伝えてください、これによりエージェントが調整できるようになります。

一部の呼び出しは常に確認が必要であり、いかなるルールでも許可することはできません。具体的には、 秘密ファイルや認証情報ストアを参照するコマンド、および .champrep/ または .git/ 内部処理、および安全に解析するには複雑すぎるコマンド。

ルールの形式は次の通りです Tool または Tool(pattern):

{
"permissions": {
"allow": ["local_bash(npm test*)", "local_bash(go test ./...)", "local_edit_file(src/**)"],
"deny": ["local_bash(git push*)", "local_bash(rm -rf*)", "local_read_file(secrets/**)"],
"defaultMode": "ask"
}
}
  • コマンドルール 例えば local_bash(npm test*) コマンドラインと一致します。 で連結されたコマンド ;, &&, ||, |、または置換が分割され、 すべて この部分は許可されている必要があります。
  • パスルール 例えば local_edit_file(src/**) ワークスペース相対 パスに一致します。 * は1つのフォルダ内に収まります; ** フォルダをまたぎます。
  • ツール名 は、以下をご利用いただけます *、例えば local_mcp__github__* すべてのツールに対して 1つのローカルMCPサーバー上の。
  • A local_read_file(...) 拒否ルール、または deny_read リストに追加されると、それらの ファイルはすべての閲覧・検索ツールから隠されます。

ファイルを編集せずにルールを管理するには:

/permissions
/permissions allow local_bash(npm run lint*)
/permissions deny local_bash(git push*)
/permissions remove local_bash(npm run lint*)
/permissions mode accept-edits

/permissions allow, deny、および remove このプロジェクトの保存済み回答を 編集する(以下 $CONFIG/ai/projects/)。その他のファイルは直接編集してください。

ファイルスコープ
--allowed-tools フラグ今回の実行のみ
$CONFIG/ai/projects/<id>.jsonこのプロジェクトの保存済み回答(「再度尋ねない」、 /permissions)
.champrep/settings.local.jsonこのプロジェクト内のあなた(以下に追加されます) .gitignore 自動的に)
.champrep/settings.jsonこのプロジェクトの全メンバー(共有するにはコミットしてください)
$CONFIG/ai/settings.jsonすべてのプロジェクトにおいて、あなた

先に設定された項目が優先されます。 どのファイルからの拒否ルールも常に優先されます。 保存された 回答はリポジトリの外に存在するため、即座に適用されます。許可 ルールおよび defaultMode の2つにおいて .champrep/ ファイルは、あなたが そのプロジェクトを信頼した後にのみ有効になります。 .champrep/ 設定(参照: リポジトリの信頼性); それらに含まれる「deny」ルールは常に適用されます。 「allow」ルールは、ユーザー設定の任意の場所に設定してください。ご利用のプランの制限は すべてのファイルに適用され、ローカル環境では制限を緩和することはできません。

実行 champrep ai paths 確認するには $CONFIG がご自身のマシン上にあります。

これらはモデルではなく、 自体CLIによって強制されます:

  • ブロックされたファイル。 エージェントは、決して読み取ったり、内容を一覧表示したり、送信したりすることはありません .env ファイル(ただし .env.example)、秘密鍵や証明書など *.pem, *.key, *.p12、および id_rsa*, .npmrc, .pypirc, .netrc, あなたの ~/.aws, ~/.ssh、および ~/.gnupg フォルダ、オペレーティングシステムの キーチェーン、および本CLI体の設定です。モデルには、そのファイルが ブロックされていることが通知されますが、その内容は一切確認されません。
  • 情報マスキング。 ツールの出力は、お使いのマシンから送信される前にスキャンされます。 クラウドアクセスキー、ソースコントロールトークン、 決済プロバイダーのキー、AIプロバイダーのキー、秘密鍵のブロック、ベアラー トークンなどの信頼度の高い機密情報は、 [REDACTED:<kind>].
  • 貼り付けられたキー。 プロンプトに秘密情報のように見えるものが含まれている場合、 それは送信されません。モデルキーを /model register およびMCP の認証情報を /mcp 代わりに。
  • 認証情報の継承はありません。 エージェントが実行するコマンド、フック、およびローカルの MCP サーバーは、お客様の認証CHAMPREP情報や CHAMPREP_* 変数。

独自のブロック対象パスを deny_read または local_read_file(...) deny ルール。組み込みのリストは拡張できますが、緩和することはできません。

リポジトリは、以下の場所にエージェントの設定を含めることができます: .champrep/:カスタムコマンド、 スキル、エージェント、フック、MCPサーバー、およびプロジェクト設定。 未知のリポジトリを開いた場合、これらのコンテンツは一切実行されてはなりません。そのため、これらのコンテンツは、 承認されるまで非アクティブのままとなります。

  • プロジェクトにそのようなコンテンツが含まれている場合、エージェントはそれを信頼するかどうかを一度確認し、 その内容が表示されます。
  • 後でコンテンツが変更された場合、再度承認を求められます。
  • /trust は現在の状態を表示します; /trust approve および /trust revoke 変更できるかどうか。

承認は $CONFIG/ai/trusted-projects.json.

編集を行うたびに、エージェントはファイルの以前の状態をユーザーのマシンに保存します。

コマンド適用
/diffこのセッションで行われたすべてのファイルの変更を表示します。
/undo直前に設定した変更を元に戻します。
/rewind以前のメッセージを選択し、ファイルをその時点の状態に復元します。 Esc twice を実行しても開きます。

/rewind はファイルのみを復元します。会話そのものは変更されません。 セッション終了時にチェックポイントは削除されますが、 --keep-checkpoints. シェルコマンドによる変更(例: コードジェネレーターを介して実行された local_bash、はチェックポイントの対象外です。 git それらに対する制限です。

サービスCHAMPREP内でのアクション

Section titled “サービスCHAMPREP内でのアクション”

メールの送信など、サービスCHAMPREP内のデータを変更する操作は、 Webアプリと同じ承認フローが適用されます。エージェントに承認カードが表示され、 そこで選択を行います。 承認, 拒否、または 後で決定する。これらの操作は、 ローカルの権限モードにかかわらず、自動的に承認されることはありません。ヘッドレス 実行の場合、WebCHAMPREP アプリでの承認を待つ状態のままとなります。

/services では、AI が使用できるサービスCHAMPREPが表示されます。そのリストは、 ウェブ上の設定CHAMPREP AIで変更できます。