コマンド

このドキュメントでは、Qwen Code がサポートするすべてのコマンドについて詳しく説明します。セッションの管理、インターフェースのカスタマイズ、動作の制御を効率的に行うことができます。

Qwen Code のコマンドは特定のプレフィックスでトリガーされ、3つのカテゴリに分類されます。

1. スラッシュコマンド (/)

スラッシュコマンドは、Qwen Code のセッション、インターフェース、基本的な動作を管理するために使用します。

1.1 セッションとプロジェクト管理

これらのコマンドは、作業の進行状況の保存、復元、要約に役立ちます。

1.2 インターフェースとワークスペースの制御

インターフェースの外観や作業環境を調整するためのコマンドです。

1.3 言語設定

インターフェースおよび出力言語を制御するためのコマンドです。

• 利用可能な組み込み UI 言語: zh-CN（簡体字中国語）、en-US（英語）、ru-RU（ロシア語）、de-DE（ドイツ語）、ja-JP（日本語）、pt-BR（ポルトガル語 - ブラジル）、fr-FR（フランス語）、ca-ES（カタルーニャ語）
• 出力言語の例: Chinese、English、Japanese など

1.4 ツールとモデルの管理

AI ツールとモデルを管理するためのコマンドです。

1.5 組み込みスキル

これらのコマンドは、バンドルされたスキルを呼び出し、特殊なワークフローを提供します。

完全な /review のドキュメントについては コードレビュー を参照してください。

1.6 サイドクエスチョン (/btw)

/btw コマンドを使用すると、メインの会話フローを中断したり影響を与えたりすることなく、素早くサイドクエスチョンを行うことができます。

動作方法:

• サイドクエスチョンは、最近の会話コンテキスト（最大過去20メッセージ）を含む別個の API 呼び出しとして送信されます。
• 応答はコンポーザーの上に表示されます。待機中も入力は続けられます。
• メインの会話は ブロックされません。独立して続行されます。
• サイドクエスチョンの応答は、メインの会話履歴の 一部にはなりません。
• 回答は完全な Markdown サポート（コードブロック、リスト、テーブルなど）でレンダリングされます。

キーボードショートカット（対話モード）:

例:

（メイン会話がリファクタリングについて行われている最中）

> /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│
  ╰──────────────────────────────────────────╯
  > （コンポーザーはアクティブなまま — 入力を続行）

（回答が届いた後）

  ╭──────────────────────────────────────────╮
  │ /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 │
  ╰──────────────────────────────────────────╯
  > （コンポーザーはまだアクティブ）

対応実行モード:

1.7 セッション要約 (/recap)

/recap コマンドは、現在のセッションの簡潔な「前回の続き」サマリーを生成します。履歴を何ページもスクロールしなくても、以前の会話を再開できます。

動作の仕組み:

• 設定済みの高速モデル（fastModel 設定）が利用可能な場合はそれを使用し、なければメインセッションモデルにフォールバックします。要約には小さく安価なモデルで十分です。
• 最近の会話（最大30メッセージ、テキストのみ。ツール呼び出しとツール応答は除外）が、タイトなシステムプロンプトとともにモデルに送信されます。
• 要約は薄い色で ❯ のプレフィックスを付けて表示され、実際のアシスタント返信とは区別されます。
• モデルターンの処理中または別のコマンドが処理中の場合は、インラインエラーで拒否されます。利用可能な会話がない場合、または生成自体が失敗した場合は、 /recap は要約の代わりに短い情報メッセージを表示します。手動コマンドは常に何かしら応答します。

離席からの復帰時の自動トリガー:

ターミナルが 5分以上 ブラー状態になり、再びフォーカスされると、自動的に要約が生成・表示されます（モデル応答が進行中でない場合のみ。進行中の場合、現在のターンが終了してから実行されます）。手動コマンドとは異なり、自動トリガーは失敗時に完全にサイレントです。生成エラーや要約する内容がない場合、履歴にメッセージは追加されません。general.showSessionRecap 設定で制御されます（デフォルト: false）。手動の /recap コマンドはこの設定に関わらず常に動作します。

例:

> /recap

❯ 長セッションのOOM（原因は無制限のstreamContentHistoryとcontentStats）に対処するため
  loopDetectionService.ts をリファクタリング中。次はオプションB（FNV-1aを使用したLRUスライディングウィンドウ）を
  実装する予定（確認待ち）。

1.8 Diffビューア (/diff)

/diff コマンドは、未コミットの変更とターンごとのdiffを表示するインタラクティブなdiffビューアを開きます。←/→ で現在のgit diffと個々の会話ターンを切り替え、↑/↓ でファイルをブラウズし、Enter でインラインdiffを表示します。

動作の仕組み:

インタラクティブモードでは、 /diff は上部にソースピッカーがあるダイアログを開きます。

• Current — ワーキングツリーとHEADの比較（git diff HEAD）。ステージ済み、ステージ未済、追跡対象外のファイルを含むすべての未コミット変更を表示します。
• T1, T2, T3, … — ターンごとのdiff。ファイルを変更したモデルターンごとにタブが表示されます。最近のターンが最初に表示されます。各タブには元のプロンプトのプレビューが表示され、コンテキストがわかります。

ファイルリストにはファイルごとの統計（追加行/削除行）と、特別な状態を示すタグ（new, deleted, untracked, binary, truncated, oversized）が表示されます。ファイルでEnterを押すと、シンタックスハイライトされたハンクを含むインラインdiffを表示できます。

ターンごとのdiffを表示するには、ファイルチェックポイント機能が有効になっている必要があります（インタラクティブモードではデフォルトでオン）。ファイルチェックポイントがオフの場合は、「Current」ソースのみが利用可能です。

キーボードショートカット:

例:

┌ /diff · Turn 3「refactor the auth middleware」 ──── 3 files +45 -12 ────┐
│                                                                          │
│ ◀ Current · T3 · T2 · T1 ▶                                              │
│                                                                          │
│ › src/utils/parser.ts                              +30 -8                │
│   src/utils/parser.test.ts                         +12 -2                │
│   README.md                                        +3 -2                 │
│                                                                          │
│ ←/→ source · ↑/↓ file · Enter view · Esc close                          │
└──────────────────────────────────────────────────────────────────────────┘

非インタラクティブモード:

ヘッドレス（--prompt）または非インタラクティブコンテキストでは、 /diff はワーキングツリーとHEADのプレーンテキストサマリーを表示します。ターンごとのナビゲーションは利用できません。

3 files changed, +45 / -12
  +30  -8  src/utils/parser.ts
  +12  -2  src/utils/parser.test.ts
   +3  -2  README.md

1.9 情報、設定、ヘルプ

情報取得やシステム設定のためのコマンドです。

1.10 共通ショートカット

1.11 認証コマンド

Qwen Codeセッション内で /auth を使用して認証を設定します。/doctor を使用して現在の認証および環境状態を確認します。

2. @ コマンド（ファイルの導入）

@ コマンドは、ローカルファイルまたはディレクトリの内容をすばやく会話に追加するために使用します。

注: パスにスペースが含まれる場合はバックスラッシュでエスケープしてください（例: @My\ Documents/file.txt）

3. エクスクラメーションコマンド (!) - シェルコマンド実行

エクスクラメーションコマンドを使用すると、Qwen Code内で直接システムコマンドを実行できます。

環境変数: ! で実行されたコマンドは、QWEN_CODE=1 環境変数を設定します。

4. カスタムコマンド

頻繁に使用するプロンプトをショートカットコマンドとして保存し、作業効率の向上と一貫性の確保を実現します。

クイック概要

優先順位ルール: プロジェクトコマンド > ユーザーコマンド（同名の場合はプロジェクトコマンドが優先）

コマンド命名ルール

ファイルパスとコマンド名の対応表

命名ルール: パス区切り文字（/ または \）をコロン（:）に変換

Markdownファイル形式仕様（推奨）

カスタムコマンドは、オプションのYAMLフロントマターを持つMarkdownファイルを使用します。

---
description: オプションの説明（/help に表示）
---
 
プロンプトの内容をここに記述。
パラメータ注入には {{args}} を使用。

TOMLファイル形式（非推奨）

パラメータ処理メカニズム

1. コンテキスト認識注入 ({{args}})

2. デフォルトパラメータ処理

3. シェルコマンド実行（!{...}）

例：Gitコミットメッセージ生成

---
description: ステージングされた変更に基づいてコミットメッセージを生成
---
 
以下のdiffに基づいてコミットメッセージを生成してください：
 
```diff
!{git diff --staged}
```

4. ファイルコンテンツインジェクション（@{...}）

例：コードレビューコマンド

---
description: ベストプラクティスに基づくコードレビュー
---
 
{{args}}をレビューし、基準を参照してください：
 
@{docs/code-standards.md}

実践的な作成例

「純関数リファクタリング」コマンド作成手順テーブル

---
description: コードを純関数にリファクタリング
---
 
現在のコンテキストのコードを分析し、純関数にリファクタリングしてください。
要件：
 
1. リファクタリング後のコードを提供
2. 主要な変更点と純関数特性の実装を説明
3. 関数の動作は変更しない

カスタムコマンドのベストプラクティスまとめ

コマンド設計推奨事項テーブル

セキュリティ機能の注意テーブル

5. CLIサブコマンド

これらのコマンドは、インタラクティブセッションを開始する前にシェルから qwen <サブコマンド> として実行します。

セッション管理

qwen sessions list

最近のQwen Codeセッションとメタデータを一覧表示します。

フラグ：

人間可読出力（デフォルト）：

列：SESSION ID、STARTED（UTCタイムスタンプ）、TITLE、BRANCH、PROMPTのテーブル。

JSON出力（--json）：

stdoutにJSON Linesを出力。各行は以下のフィールドを持つJSONオブジェクト：

sessionId, startTime, mtime, prompt, gitBranch, customTitle, titleSource, filePath, cwd

「has more sessions」のヒントはstderrに出力されるため、jqへのパイプは安全です。

例：

# 最後の20セッションを表示（デフォルト）
qwen sessions list
 
# 最後の50セッションを表示
qwen sessions list --limit 50
 
# スクリプト用にJSONで出力
qwen sessions list --json | jq .