メインコンテンツへスキップ
Qoder CLI は、ローカルワークスペースと外部情報源を扱うためにツールを使用します。ツールは、プロジェクト内容の検索と読み取り、ファイル変更、コマンド実行、Web コンテンツ取得、コンテキスト管理、MCP による外部サービス連携に使われます。 ツールは対話型 TUI セッションと非対話型の Print Mode の両方で利用できます。実際に利用できるツールは、現在のセッション、有効な機能、MCP 設定、権限設定によって変わります。 TUI では /tools を使うと、現在のセッションで利用可能なツールを確認できます。

検索と探索

Qoder CLI は、次の操作を行う前に検索と探索ツールで現在のタスクを理解します。
範囲説明
ファイル現在のワークスペース内でファイルを探します。
コードコード、テキスト、設定ファイルを検索します。
ディレクトリプロジェクト構造を確認し、関連パスを特定します。
Web現在の情報や公開情報が必要な場合に Web を検索します。
Web コンテンツ指定した Web ページの内容を取得します。

プロジェクトコンテキストの読み取り

Qoder CLI は、現在のリクエストに必要なコンテキストを集めるためにファイルやプロジェクト資産を読み取れます。
機能説明
ファイル表示ソースファイル、ドキュメント、設定、その他のテキスト資産を読み取ります。
大きなファイルの読み取りファイル全体が大きい場合、関連する部分だけを読み取ります。
ドキュメント形式の読み取り利用可能な場合、PDF などのドキュメント形式を確認します。

ファイル編集

タスクに変更が必要な場合、Qoder CLI はワークスペース内でファイルを作成または変更できます。
機能説明
ファイル変更既存ファイルを対象に絞って変更します。
ファイル作成ソースファイル、テスト、ドキュメント、設定などを追加します。
Notebook 編集Notebook サポートがある場合、Notebook 内容を変更します。
ファイル編集は権限システムを通過します。権限モードとルールに応じて、Qoder CLI は変更を直接適用する、確認を求める、または操作をブロックします。

コマンド実行

ローカル実行が必要な場合、Qoder CLI は shell コマンドを実行できます。
機能説明
コマンド実行ビルド、テスト、パッケージ、Git 確認、調査、カスタム shell コマンドを実行します。
長いタスクの実行テストスイートや開発スクリプトなど、時間のかかるコマンドを追跡します。
shell コマンドは通常、読み取り専用操作よりリスクが高くなります。日常的なコマンドは許可し、機密性の高いコマンドは確認または拒否するように権限ルールを設定してください。

コンテキスト管理

一部のツールは、Qoder CLI が現在のタスクと会話状態を管理するために使われます。
機能説明
タスク追跡作業中に軽量な計画やタスクリストを維持します。
確認質問判断や不足情報が必要な場合にユーザーへ質問します。
Memory 管理memory 機能が利用可能な場合、永続情報を保存します。
Skills の使用設定済みの専門指示やワークフローを読み込みます。
作業計画実行前に分析が必要な場合、Plan Mode に入る、または終了します。
Memory と Skills はモデルにコンテキストを提供しますが、セキュリティ境界ではありません。強制的なポリシーには権限ルールと Hooks を使用してください。

委任と自動化

現在の環境で関連機能が有効な場合、Qoder CLI は委任と自動化機能を使用できます。
機能説明
Subagents専門 Agent に特定の作業を委任します。
Workflows設定済みの再利用可能なワークフローを実行します。
Goals長めの目標を追跡して実行します。
Worktrees並列セッションが必要な場合、独立した Git worktree で作業します。
スケジュール作業スケジュール機能が有効な場合、定期タスクを作成または管理します。
利用可否は製品設定、機能フラグ、現在のセッションによって変わります。

MCP ツール

Qoder CLI は Model Context Protocol (MCP) サーバーに接続し、外部ツールやデータソースを利用できます。MCP サーバーを設定すると、そのツールは同じ /tools ビューに表示され、同じ権限システムを通過します。 MCP ツールは、Issue 管理、コードホスティング、データベース、ブラウザ自動化、社内プラットフォーム、企業独自サービスとの連携に適しています。 MCP 設定については MCP Servers を参照してください。

ツール使用の制御

ツールが見えることと、ツール実行が許可されることは別です。
制御説明
--tools現在のセッションで見えるツールを制限します。
--allowed-tools指定したツールまたはツールパターンを事前承認します。
--disallowed-tools指定したツールまたはツールパターンをブロックします。
permissions.allow / permissions.ask / permissions.denysettings ファイルに保存する永続的な権限ルールです。
tools.exclude起動時の検出結果からツールを削除します。
例:
# 読み取り専用の調査
qodercli --tools Read Grep Glob --allowed-tools 'Read,Grep,Glob'

# 日常的な status コマンドを許可
qodercli --allowed-tools 'Read,Grep,Bash(git status)'

# 非対話型レビューでファイル編集を禁止
qodercli -p "review this repository" --disallowed-tools 'Write,Edit'
権限モード、ルール構文、判定順序については Permissions を参照してください。ツール呼び出しをインターセプトする Hooks については Hooks を参照してください。