コマンド
このドキュメントでは、Qwen Code がサポートするすべてのコマンドを詳細に説明します。セッションの効率的な管理、インターフェースのカスタマイズ、動作の制御に役立ちます。
Qwen Code のコマンドは特定のプレフィックスでトリガーされ、以下の 3 つのカテゴリに分類されます。
| プレフィックスの種類 | 機能の説明 | 主なユースケース |
|---|---|---|
スラッシュコマンド (/) | Qwen Code 自体のメタレベル制御 | セッション管理、設定変更、ヘルプの取得 |
アットコマンド (@) | ローカルファイルの内容を会話に素早く注入 | AI に指定されたファイルやディレクトリ内のコードを分析させる |
エクスクラメーションコマンド (!) | システムシェルとの直接対話 | git status や ls などのシステムコマンドの実行 |
1. スラッシュコマンド (/)
スラッシュコマンドは、Qwen Code のセッション、インターフェース、基本動作を管理するために使用されます。
1.1 セッションとプロジェクト管理
これらのコマンドは、作業進捗の保存、復元、要約に役立ちます。
| コマンド | 説明 | 使用例 |
|---|---|---|
/init | 現在のディレクトリを分析し、初期コンテキストファイルを作成する | /init |
/summary | 会話履歴に基づいてプロジェクトの要約を生成する | /summary |
/compress | チャット履歴を要約に置き換え、Token を節約する | /compress |
/resume | 以前の会話セッションを再開する | /resume |
/restore | ツール実行前のファイル状態に復元する | /restore (一覧) または /restore <ID> |
1.2 インターフェースとワークスペース制御
インターフェースの外観や作業環境を調整するためのコマンドです。
| コマンド | 説明 | 使用例 |
|---|---|---|
/clear | ターミナル画面のコンテンツをクリアする | /clear (ショートカット: Ctrl+L) |
/context | コンテキストウィンドウの使用状況の内訳を表示する | /context |
→ detail | アイテムごとのコンテキスト使用状況の内訳を表示する | /context detail |
/theme | Qwen Code のビジュアルテーマを変更する | /theme |
/vim | 入力エリアの Vim 編集モードのオン/オフを切り替える | /vim |
/directory | マルチディレクトリサポートのワークスペースを管理する | /dir add ./src,./tests |
/editor | サポートされているエディタを選択するダイアログを開く | /editor |
1.3 言語設定
インターフェースと出力言語を制御するための専用コマンドです。
| コマンド | 説明 | 使用例 |
|---|---|---|
/language | 言語設定の表示または変更 | /language |
→ ui [language] | UI インターフェース言語を設定する | /language ui zh-CN |
→ output [language] | LLM 出力言語を設定する | /language output Chinese |
- 利用可能な組み込み UI 言語:
zh-CN(簡体字中国語)、en-US(英語)、ru-RU(ロシア語)、de-DE(ドイツ語) - 出力言語の例:
Chinese、English、Japaneseなど
1.4 ツールとモデル管理
AI ツールとモデルを管理するためのコマンドです。
| コマンド | 説明 | 使用例 |
|---|---|---|
/mcp | 設定済みの MCP サーバーとツールを一覧表示する | /mcp, /mcp desc |
/tools | 現在利用可能なツールの一覧を表示する | /tools, /tools desc |
/skills | 利用可能なスキルを一覧表示および実行する | /skills, /skills <name> |
/plan | プランモードに切り替え、またはプランモードを終了する | /plan, /plan <task>, /plan exit |
/approval-mode | ツール使用の承認モードを変更する | /approval-mode <mode (auto-edit)> --project |
→plan | 分析のみ、実行なし | 安全なレビュー |
→default | 編集に承認が必要 | 日常使用 |
→auto-edit | 編集を自動承認 | 信頼された環境 |
→yolo | すべて自動承認 | 迅速なプロトタイピング |
/model | 現在のセッションで使用するモデルを切り替える | /model |
/model --fast | プロンプト提案用に軽量モデルを設定する | /model --fast qwen3-coder-flash |
/extensions | 現在のセッションでアクティブなすべての拡張機能を一覧表示する | /extensions |
/memory | AI の指示コンテキストを管理する | /memory add Important Info |
1.5 組み込みスキル
これらのコマンドは、専門的なワークフローを提供するバンドルスキルを呼び出します。
| コマンド | 説明 | 使用例 |
|---|---|---|
/review | 5 つの並列エージェントと決定論的分析によるコード変更のレビュー | /review, /review 123, /review 123 --comment |
/loop | 定期的なスケジュールでプロンプトを実行する | /loop 5m check the build |
/qc-helper | Qwen Code の使用方法と設定に関する質問に回答する | /qc-helper how do I configure MCP? |
完全な /review ドキュメントについては、Code Review を参照してください。
1.6 サイドクエスション (/btw)
/btw コマンドを使用すると、メインの会話フローを中断したり影響を与えたりすることなく、簡単なサイドクエスション(補足質問)を行うことができます。
| コマンド | 説明 |
|---|---|
/btw <your question> | 簡単なサイドクエスションを行う |
?btw <your question> | サイドクエスションの代替構文 |
動作原理:
- サイドクエスションは、最近の会話コンテキスト(最大 20 メッセージ)とともに個別の API コールとして送信されます
- 応答は Composer の上に表示されます。待機中も入力を続けることができます
- メインの会話はブロックされません。独立して続行されます
- サイドクエスションの応答はメインの会話履歴の一部になりません
- 回答は完全な Markdown サポート(コードブロック、リスト、テーブルなど)でレンダリングされます
キーボードショートカット(インタラクティブモード):
| ショートカット | 動作 |
|---|---|
Escape | キャンセル(読み込み中)または閉じる(完了後) |
Space または Enter | 回答を閉じる(入力が空の場合) |
Ctrl+C または Ctrl+D | 実行中のサイドクエスションをキャンセルする |
例:
(While the main conversation is about refactoring code)
> /btw What's the difference between let and var in JavaScript?
╭──────────────────────────────────────────╮
│ /btw What's the difference between let │
│ and var in JavaScript? │
│ │
│ + Answering... │
│ Press Escape, Ctrl+C, or Ctrl+D to cancel│
╰──────────────────────────────────────────╯
> (Composer remains active — keep typing)
(After the answer arrives)
╭──────────────────────────────────────────╮
│ /btw What's the difference between let │
│ and var in JavaScript? │
│ │
│ `let` is block-scoped, while `var` is │
│ function-scoped. `let` was introduced │
│ in ES6 and doesn't hoist the same way. │
│ │
│ Press Space, Enter, or Escape to dismiss │
╰──────────────────────────────────────────╯
> (Composer still active)サポートされている実行モード:
| モード | 動作 |
|---|---|
| Interactive | Composer の上に Markdown レンダリングで表示 |
| Non-interactive | テキスト結果を返す: btw> question\nanswer |
| ACP (Agent Protocol) | stream_messages 非同期ジェネレーターを返す |
メインのタスクから逸脱せずに素早く回答が必要な場合は /btw を使用してください。概念の明確化、事実の確認、または主要なワークフローに集中しながら素早い説明を得る場合に特に便利です。
1.7 情報、設定、ヘルプ
情報の取得やシステム設定を行うためのコマンドです。
| コマンド | 説明 | 使用例 |
|---|---|---|
/help | 利用可能なコマンドのヘルプ情報を表示する | /help または /? |
/about | バージョン情報を表示する | /about |
/stats | 現在のセッションの詳細な統計情報を表示する | /stats |
/settings | 設定エディタを開く | /settings |
/auth | 認証方法を変更する | /auth |
/bug | Qwen Code に関する問題を報告する | /bug Button click unresponsive |
/copy | 最後の出力内容をクリップボードにコピーする | /copy |
/quit | Qwen Code をすぐに終了する | /quit または /exit |
1.8 一般的なショートカット
| ショートカット | 機能 | 注記 |
|---|---|---|
Ctrl/cmd+L | 画面をクリアする | /clear と同等 |
Ctrl/cmd+T | ツールの説明を切り替える | MCP ツール管理 |
Ctrl/cmd+C×2 | 終了確認 | 安全な終了メカニズム |
Ctrl/cmd+Z | 入力を元に戻す | テキスト編集 |
Ctrl/cmd+Shift+Z | 入力をやり直す | テキスト編集 |
1.9 CLI 認証サブコマンド
セッション内の /auth スラッシュコマンドに加えて、Qwen Code はターミナルから直接認証を管理するためのスタンドアロン CLI サブコマンドを提供します。
| コマンド | 説明 |
|---|---|
qwen auth | インタラクティブな認証セットアップ |
qwen auth qwen-oauth | Qwen OAuth で認証する |
qwen auth coding-plan | Alibaba Cloud Coding Plan で認証する |
qwen auth coding-plan --region china --key sk-sp-… | 非インタラクティブな Coding Plan セットアップ(スクリプト用) |
qwen auth status | 現在の認証ステータスを表示する |
これらのコマンドは Qwen Code セッションの外で実行されます。セッション開始前の認証設定や、スクリプト・CI 環境での使用に役立ちます。詳細は Authentication ページを参照してください。
2. @ コマンド(ファイルの導入)
@ コマンドは、ローカルファイルやディレクトリのコンテンツを会話に素早く追加するために使用されます。
| コマンド形式 | 説明 | 例 |
|---|---|---|
@<file path> | 指定されたファイルの内容を注入する | @src/main.py Please explain this code |
@<directory path> | ディレクトリ内のすべてのテキストファイルを再帰的に読み取る | @docs/ Summarize content of this document |
単独の @ | @ シンボル自体について議論する場合に使用 | @ What is this symbol used for in programming? |
注: パス内のスペースはバックスラッシュでエスケープする必要があります(例: @My\ Documents/file.txt)
3. エクスクラメーションコマンド (!) - シェルコマンド実行
エクスクラメーションコマンドを使用すると、Qwen Code 内で直接システムコマンドを実行できます。
| コマンド形式 | 説明 | 例 |
|---|---|---|
!<shell command> | サブシェルでコマンドを実行する | !ls -la, !git status |
単独の ! | シェルモードに切り替え、すべての入力が直接シェルコマンドとして実行される | !(Enter) → コマンド入力 → !(終了) |
環境変数: ! を介して実行されるコマンドには、QWEN_CODE=1 環境変数が設定されます。
4. カスタムコマンド
よく使用するプロンプトをショートカットコマンドとして保存し、作業効率の向上と一貫性の確保を図ります。
カスタムコマンドは現在、オプションの YAML フロントマター付き Markdown 形式を使用します。TOML 形式は非推奨ですが、後方互換性のために引き続きサポートされています。TOML ファイルが検出されると、自動移行プロンプトが表示されます。
クイック概要
| 機能 | 説明 | 利点 | 優先度 | 適用シナリオ |
|---|---|---|---|---|
| 名前空間 | サブディレクトリがコロン区切りのコマンド名を作成する | コマンドの整理が容易 | ||
| グローバルコマンド | ~/.qwen/commands/ | すべてのプロジェクトで利用可能 | 低 | 個人用頻繁コマンド、プロジェクト横断利用 |
| プロジェクトコマンド | <project root directory>/.qwen/commands/ | プロジェクト固有、バージョン管理可能 | 高 | チーム共有、プロジェクト固有コマンド |
優先度ルール: プロジェクトコマンド > ユーザーコマンド(名前が同じ場合はプロジェクトコマンドが使用される)
コマンド命名規則
ファイルパスからコマンド名へのマッピングテーブル
| ファイルの場所 | 生成されるコマンド | 呼び出し例 |
|---|---|---|
~/.qwen/commands/test.md | /test | /test Parameter |
<project>/.qwen/commands/git/commit.md | /git:commit | /git:commit Message |
命名規則: パス区切り文字(/ または \)がコロン(:)に変換される
Markdown ファイル形式仕様(推奨)
カスタムコマンドは、オプションの YAML フロントマター付き Markdown ファイルを使用します。
---
description: Optional description (displayed in /help)
---
Your prompt content here.
Use {{args}} for parameter injection.| フィールド | 必須 | 説明 | 例 |
|---|---|---|---|
description | オプション | コマンドの説明(/help で表示) | description: Code analysis tool |
| プロンプト本文 | 必須 | モデルに送信されるプロンプトコンテンツ | フロントマター以降の任意の Markdown コンテンツ |
TOML ファイル形式(非推奨)
非推奨: TOML 形式は引き続きサポートされていますが、将来のバージョンで削除される予定です。Markdown 形式への移行をお願いします。
| フィールド | 必須 | 説明 | 例 |
|---|---|---|---|
prompt | 必須 | モデルに送信されるプロンプトコンテンツ | prompt = "Please analyze code: {{args}}" |
description | オプション | コマンドの説明(/help で表示) | description = "Code analysis tool" |
パラメータ処理メカニズム
| 処理方法 | 構文 | 適用シナリオ | セキュリティ機能 |
|---|---|---|---|
| コンテキスト対応注入 | {{args}} | 正確なパラメータ制御が必要な場合 | 自動シェルエスケープ |
| デフォルトパラメータ処理 | 特別なマークなし | シンプルコマンド、パラメータ追加 | そのまま追加 |
| シェルコマンド注入 | !{command} | 動的コンテンツが必要な場合 | 実行前に確認が必要 before |
1. コンテキスト対応注入 ({{args}})
| シナリオ | TOML 設定 | 呼び出し方法 | 実際の効果 |
|---|---|---|---|
| 生注入 | prompt = "Fix: {{args}}" | /fix "Button issue" | Fix: "Button issue" |
| シェルコマンド内 | prompt = "Search: !{grep {{args}} .}" | /search "hello" | grep "hello" . を実行 |
2. デフォルトパラメータ処理
| 入力状況 | 処理方法 | 例 |
|---|---|---|
| パラメータあり | プロンプトの末尾に追加(2 行の改行で区切り) | /cmd parameter → 元のプロンプト + パラメータ |
| パラメータなし | プロンプトをそのまま送信 | /cmd → 元のプロンプト |
🚀 動的コンテンツ注入
| 注入タイプ | 構文 | 処理順序 | 目的 |
|---|---|---|---|
| ファイルコンテンツ | @{file path} | 最初に処理 | 静的参照ファイルの注入 |
| シェルコマンド | !{command} | 中間で処理 | 動的実行結果の注入 |
| パラメータ置換 | {{args}} | 最後に処理 | ユーザーパラメータの注入 |
3. シェルコマンド実行 (!{...})
| 操作 | ユーザーインタラクション |
|---|---|
| 1. コマンドとパラメータの解析 | - |
| 2. 自動シェルエスケープ | - |
| 3. 確認ダイアログの表示 | ✅ ユーザー確認 |
| 4. コマンドの実行 | - |
| 5. 出力をプロンプトに注入 | - |
例: Git コミットメッセージの生成
---
description: Generate Commit message based on staged changes
---
Please generate a Commit message based on the following diff:
```diff
!{git diff --staged}
```4. ファイルコンテンツ注入 (@{...})
| ファイルタイプ | サポート状況 | 処理方法 |
|---|---|---|
| テキストファイル | ✅ 完全サポート | コンテンツを直接注入 |
| 画像/PDF | ✅ マルチモーダルサポート | エンコードして注入 |
| バイナリファイル | ⚠️ 制限付きサポート | スキップまたは切り捨てられる可能性あり |
| ディレクトリ | ✅ 再帰的注入 | .gitignore ルールに従う |
例: コードレビューコマンド
---
description: Code review based on best practices
---
Review {{args}}, reference standards:
@{docs/code-standards.md}実践的な作成例
「純粋関数へのリファクタリング」コマンド作成手順テーブル
| 操作 | コマンド/コード |
|---|---|
| 1. ディレクトリ構造の作成 | mkdir -p ~/.qwen/commands/refactor |
| 2. コマンドファイルの作成 | touch ~/.qwen/commands/refactor/pure.md |
| 3. コマンドコンテンツの編集 | 以下の完全なコードを参照してください。 |
| 4. コマンドのテスト | @file.js → /refactor:pure |
---
description: Refactor code to pure function
---
Please analyze code in current context, refactor to pure function.
Requirements:
1. Provide refactored code
2. Explain key changes and pure function characteristic implementation
3. Maintain function unchangedカスタムコマンドのベストプラクティスまとめ
コマンド設計推奨事項テーブル
| 実践ポイント | 推奨アプローチ | 避けるべきこと |
|---|---|---|
| コマンド命名 | 名前空間を使用して整理する | 過度に一般的な名前を避ける |
| パラメータ処理 | {{args}} を明確に使用する | デフォルト追加に依存する(混乱を招きやすい) |
| エラーハンドリング | シェルのエラー出力を活用する | 実行失敗を無視する |
| ファイル構成 | ディレクトリ内で機能別に整理する | すべてのコマンドをルートディレクトリに配置する |
| 説明フィールド | 常に明確な説明を提供する | 自動生成された説明に依存する |
セキュリティ機能リマインダーテーブル
| セキュリティメカニズム | 保護効果 | ユーザー操作 |
|---|---|---|
| シェルエスケープ | コマンドインジェクションを防止する | 自動処理 |
| 実行確認 | 誤実行を回避する | ダイアログで確認 |
| エラーレポート | 問題の診断に役立つ | エラー情報を確認 |