Skip to main content
リファレンス

CLI コマンドとパラメーター

qoder コマンドラインの全起動パラメーター、フラグ、既定値、および使用例

本ページでは、qoder コマンドのすべての起動パラメーターとフラグについて説明します。qoder --help を使用すると、ターミナルで完全なリストを確認できます。 基本的な呼び出し形式: 
qoder [オプション] [プロンプトテキスト]
引数を指定せずに実行すると、インタラクティブセッションが開始されます。プロンプトテキストまたは --print を指定すると、非対話モードになります。

共通フラグ

フラグ短縮形型説明
--version-vbooleanバージョン番号を出力して終了します。
--help-hbooleanヘルプ情報を表示して終了します。
--debug-dbooleanデバッグログの出力を有効にします。
--cwd-wstring作業ディレクトリを指定します（デフォルトは現在のディレクトリ）。
--config-dirstringユーザー構成ディレクトリを上書きします（デフォルトは ~/.qoder）。
--add-dirstring[]現在のセッションに追加の信頼済みディレクトリを追加します（複数回使用可能）。
--attachmentstring初期プロンプトにファイルを添付します（複数回使用可能）。
--worktree[name]新しい Git ワークツリーで隔離実行し、結果をメインブランチにマージします。名前は省略可能で、省略時は自動生成されます。

モデルと推論

フラグ短縮形型説明
--model-mstringモデル識別子を指定します（auto、lite、performance、または BYOK キーなど）。
--reasoning-effortstring現在のセッションの推論エフォートを上書きします（high など）。
--context-windownumber現在のセッションのコンテキストウィンドウサイズ（トークン数）を上書きします。
--list-modelsboolean利用可能なモデルを一覧表示して終了します。
--output-stylestring有効化する出力スタイルの名前。

セッション管理

フラグ短縮形型説明
--continue-cboolean直前のセッションを再開します。
--resume-r[id]識別子に基づいて履歴セッションを復元します。ID を指定しない場合はリストから選択します。
--session-idstring指定された ID のセッションを再開します。
--fork-sessionboolean復元されたセッションから新しいセッションをフォークします（--resume/--session-id と組み合わせて使用）。
--name-nstring現在のセッション名を設定または上書きします。
--list-sessionsbooleanすべての履歴セッションを一覧表示して終了します。
--delete-session<index>指定されたセッションを番号で削除します。
競合ルール: --continue、--resume、--remote、--remote-session、--teleport、--remote-control は同時に使用できません。

出力とスクリプトモード

フラグ短縮形型説明
--print-pboolean非対話モード: 1 回応答を出力して終了します（CI/スクリプト向け）。
--output-format-oenum出力形式: text（デフォルト）、json、stream-json。
--input-formatenum入力形式: text（デフォルト）、stream-json。
--max-turnsnumber単一クエリの最大対話ターン数を制限します（自動化シナリオでの無限ループを防止するため）。
--max-output-tokensnumberモデルの単一出力における最大トークン数を設定します。
--prompt-interactive-istring指定されたプロンプトを先に実行し、その後インタラクティブモードに移行します。
--no-session-persistencebooleanセッションをディスクに書き込まず、復元できなくします（--print 下でのみ有効）。

権限制御

フラグ短縮形型説明
--permission-modeenum権限モードを設定します: default / plan / auto / bypass_permissions / accept_edits / dont_ask。
--yoloboolean--permission-mode bypass_permissions と同等です（危険: すべての権限確認をスキップします）。
--dangerously-skip-permissionsboolean--permission-mode bypass_permissions と同等です（危険: すべての権限確認をスキップします）。

ツールと MCP

フラグ短縮形型説明
--toolsstring[]利用可能な組み込みツールを制限します。スペースまたはカンマ区切り（"" ですべて無効化、default ですべて有効化。-p または -- を使用してクエリと区切ります）。
--allowed-toolsstring[]使用を許可するツールの許可リスト。
--disallowed-toolsstring[]使用を禁止するツールのブロックリスト。
--mcp-configstringMCP 構成ファイルのパス（JSON）。
--strict-mcp-configboolean厳格モード。--mcp-config で指定された MCP サーバーのみを読み込みます。
--allowed-mcp-server-namesstring[]許可された MCP サーバー名の許可リスト。
--max-model-request-retriesnumberQoder と外部プロバイダーモデルリクエストの最大リトライ回数。

サンドボックス

フラグ短縮形型説明
--sandbox-sbooleanサンドボックスを有効にします（ブールスイッチ、バックエンド名は受け付けません）。バックエンドは QODER_SANDBOX または tools.sandbox で指定します。

エージェントとシステムプロンプト

フラグ短縮形型説明
--agentstringメインスレッドで使用するエージェント名を指定します。
--agentsjsonJSON オブジェクトとしてカスタムエージェントを定義します。
--system-promptstringシステムプロンプトを上書きします。
--append-system-promptstringデフォルトのシステムプロンプトの後にコンテンツを追加します。

構成の上書き

フラグ短縮形型説明
--settingsstringJSON ファイルパスまたはインライン JSON オブジェクト（{ で始まる場合はインラインとして解析）。最優先の構成として機能します。
--setting-sourcesstring[]読み込む構成ソースのリストを指定します。
--plugin-dirstring追加のプラグイン検索ディレクトリ。

リモートとコラボレーション

フラグ短縮形型説明
--remote[task]クラウドリモートセッションを作成し、アクセス URL を出力します（オプションで初期タスクを付与）。
--remote-session<id>既存のリモートセッションをコールドロードして接続します。
--teleport<id>リモートセッションを読み込んで接続します。
--remote-control<id>ヘッドレスリモートコントロールワーカーとして実行します。

エディター統合

フラグ短縮形型説明
--acpbooleanACP サーバーとして起動し、Zed などの ACP プロトコルを実装するクライアントが標準入出力を介して統合できるようにします。

サブコマンド

起動パラメーターに加え、qoder はいくつかのサブコマンドも提供しており、qoder <サブコマンド> の形式で実行します。
サブコマンド説明
mcpMCP サーバーを構成および管理します。
plugins（エイリアス plugin）プラグインを管理します。
skills（エイリアス skill）エージェントスキルを管理します。
hooks（エイリアス hook）フックを管理します。
agents（エイリアス agent）エージェントを管理します。
loginアカウントにサインインします。
commitコミットメッセージを生成し、変更をコミットします。
rollback以前のバージョンにロールバックします。
update最新バージョンに更新します。
remote-controlリモートコントロールデーモンを起動します。
statusセッションステータスを表示します。
feedbackフィードバックを送信します。
wikiプロジェクトの Wiki ドキュメントを生成します。

使用例

# インタラクティブモードで起動
qoder

# モデルを指定
qoder -m performance

# 非インタラクティブな単発実行
qoder -p "このコードが何をしているか説明してください"

# スクリプトで利用するためのJSON出力
qoder -p -o json "プロジェクトの依存関係を一覧表示してください"

# 前回のセッションを続行
qoder -c

# 隔離されたWorktreeで実行
qoder --worktree "データベース層をリファクタリングしてください"

# 全自動モード + サンドボックス
qoder --permission-mode auto -s docker "テストを実行し、失敗した項目を修正してください"

次のステップ

はじめに
コアコンセプト
Qoder CLI を使用する
Qoder CLI の拡張
リモートと統合
設定とセキュリティ
リファレンス
トラブルシューティング
CLI コマンドとパラメーター - Qoder