Qoder CLI のコアコンセプトと用語の説明
本ページでは、Qoder CLI ドキュメントに登場する主要な概念と用語をまとめ、迅速な参照ができるようにしています。
製品とブランド
| 用語 | 説明 |
|---|---|
| Qoder | 海外ユーザー向けの AI ネイティブ CLI ブランド。 |
| Qoder CLI | 製品の正式名称。 |
qoder | ユーザーがターミナルに入力するコマンド名。 |
共通技術用語
| 用語 | 説明 |
|---|---|
| Terminal | ユーザーが CLI と対話するためのテキストインターフェース環境。 |
| サブコマンド (Subcommand) | qoder の後に続く操作語。login や commit など。 |
| フラグ (Flag) | --model や --resume などのコマンドライン引数。 |
| 環境変数 | QODER_ プレフィックスを持つシステム変数を通じて CLI の動作を設定します。 |
| TUI | Text User Interface。ターミナル内のリッチな対話型インターフェース。 |
| ヘッドレスモード (Headless Mode) | GUI なしのモード。CI/CD などの非対話型環境に適しており、確認プロンプトは表示されません。 |
認証
| 用語 | 説明 |
|---|---|
| Browser Login | 推奨されるサインイン方法。ブラウザーを通じて OAuth 認証を完了します。 |
| Qoder PAT | 個人アクセストークン（Personal Access Token）。CI/CD やブラウザーレス環境に適しています。 |
モデル
| 用語 | 説明 |
|---|---|
| モデルキー | モデルを指定するために使用される、モデルの一意な識別子。 |
| BYOK | Bring Your Own Key。ユーザーが独自の API キーを持ち込んでカスタムモデルを使用すること。 |
| デフォルトモデル | デフォルトで提供される階層化モデル。Efficient / Auto / Performance / Ultimate を含みます。 |
| カスタムモデル | 独自の API キーをサポートするカスタムモデル。 |
| Thinking Efforts | モデル推論時の思考の深さの設定。low / medium / high / xhigh / max など。 |
| Fast Mode | 一部のモデルで提供される高速モード。応答速度の向上を優先します（/fast）。 |
| コンテキストウィンドウ | モデルが一度に処理できるコンテキストのサイズ。 |
エージェントとセッション
| 用語 | 説明 |
|---|---|
| エージェント | タスクを実行する AI アシスタントのインスタンス。 |
| サブエージェント | メインエージェントから派生した独立した実行ユニット。サブタスクの並列処理に使用されます。 |
| セッション | 一連の完全な対話セッション。 |
| メモリ | エージェントがセッションを跨いで保持する永続化情報。ユーザーの好みやプロジェクトの知識を保持します。 |
| メモリファイル | メモリを保存するファイル。ユーザーレベルの ~/.qoder/AGENTS.md、プロジェクトレベルの AGENTS.md と AGENTS.local.md、および .qoder/rules/ 配下のルールファイルを含みます。 |
| ワークツリー | Git ワークツリーの隔離。エージェントがメインディレクトリに影響を与えずに独立したブランチで作業できるようにします。 |
| コンパクション | 会話が長くなりすぎた場合に、履歴メッセージを自動的に圧縮してコンテキストウィンドウ内に収めます。 |
| Plan Mode | エージェントがまず計画を立て、ユーザーの確認を得てから実行する作業モード。 |
| Goal Mode | エージェントが指定された目標に向けて継続的に実行する作業モード。 |
| 動的ワークフロー | JavaScript スクリプトを使用して複数のサブエージェントのバックグラウンドタスクをオーケストレーションする動的ワークフロー。 |
ツール
| 用語 | 説明 |
|---|---|
| ツール | ファイルの読み書き、コマンドの実行、コードの検索など、エージェントが呼び出せる機能ユニット。 |
| MCP | Model Context Protocol。サードパーティのツールやサービスの接続を可能にするツール拡張プロトコル。 |
| MCP サーバー | MCP プロトコルを実装し、ツールのクエリと呼び出しをサポートするサーバー。 |
| RepoWiki | リポジトリの構造化された Wiki ドキュメントを生成する qoder wiki コマンド。 |
アクセス許可システム
| 用語 | 説明 |
|---|---|
| ワークスペースディレクトリ | CLI 起動時のカレントディレクトリ。 |
| 追加ディレクトリ | --add-dir または /add-dir を通じて現在のセッションに追加される追加の信頼済みディレクトリ。 |
| 権限モード | ツール実行前の確認原則を設定する権限モード。 |
| Default Mode | 標準モード。安全な読み取りと内部アクションは自動的に実行され、機密操作は個別に確認されます。 |
| Auto-accept Edits Mode | ファイル編集を自動的に承認しますが、シェルコマンドには引き続き確認が必要です。 |
| Auto Mode | AI が安全な操作を自動的に判断し、承認します。 |
| Don't Ask Mode | 確認が必要なすべての操作を拒否します。 |
| YOLO モード | 権限をバイパスし、すべての操作を自動的に承認します。 |
プラグインと拡張機能
| 用語 | 説明 |
|---|---|
| プラグイン | CLI に新しいスキル、フック、または MCP サーバーを追加するインストール可能な拡張パッケージ。 |
| プラグインマーケットプレイス | コミュニティまたは公式が公開したプラグインを閲覧およびインストールするプラグインマーケットプレイス。 |
| スラッシュコマンド | / で始まるセッション内のショートカットコマンド。 |
| スキル | /スキル名 を通じて呼び出される、再利用可能な専門機能テンプレート。 |
| 条件付きスキル | 特定のファイルパスに一致した場合にのみアクティブになるスキル。 |
| フック | 特定のイベント発生時に自動的に実行されるカスタムロジック。 |
| フックタイプ | フックの実行方法。シェルコマンド、HTTP リクエスト、プロンプトインジェクションなどをサポートします。 |
| フックイベント | ツール実行の前後やセッションの開始/終了など、フックをトリガーするタイミング。 |
構成ファイル
| 用語 | 説明 |
|---|---|
| ユーザー設定 | ~/.qoder/settings.json に配置され、すべてのプロジェクトに適用されるユーザーレベルの構成。 |
| プロジェクト設定 | .qoder/settings.json に配置され、コードリポジトリと共に共有されるプロジェクトレベルの構成。 |
| プロジェクトローカル設定 | .qoder/settings.local.json に配置され、ローカルマシンにのみ適用されるプロジェクトローカルの構成。 |
課金とクォータ
| 用語 | 説明 |
|---|---|
| クレジット | 課金単位。 |
| プラン | アカウントの現在のプラン（/usage の Qoder プランとプランクォータなど）。 |
| プランティア | サブスクリプションティア：Community、Pro、Teams。 |
| クォータ | 使用済み/残り/合計を含むクォータ割り当て。 |
| Price Factor | 異なるモデルが消費するクレジットの倍率。 |
| アドオンクレジット | プランクォータとは別に購入する追加クレジットパッケージ。 |
| 組織リソースパッケージ | チーム/組織によって一元分配されるクォータリソースパッケージ。 |
インテグレーション関連
| 用語 | 説明 |
|---|---|
| ACP | Agent Client Protocol。CLI と IDE 間の通信プロトコル。 |
| SDK | Software Development Kit。サードパーティのインテグレーションをサポートする、CLI が提供する開発ライブラリ。 |
| Cloud Mode | タスクがクラウド仮想マシンでホストされて実行される --remote クラウド実行モード。 |
| Remote Control | モバイル/Web を通じてローカルで実行されているエージェントをリアルタイムで制御し、重要なノードでリモートから意思決定を行います。 |
次のステップ
- 主要な概念の詳細：タスク実行の仕組み。
- すべての構成項目：構成項目、環境変数、およびファイルパス。