명령어

이 문서는 Qwen Code에서 지원하는 모든 명령어를 설명하며, 세션 관리, 인터페이스 커스터마이징, 동작 제어를 효율적으로 수행할 수 있도록 도와줍니다.

Qwen Code 명령어는 특정 접두사를 통해 실행되며 세 가지 범주로 나뉩니다:

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 내장 Skill

이 명령어들은 특수한 워크플로우를 제공하는 번들 skill을 호출합니다.

자세한 /review 문서는 코드 리뷰를 참조하세요.

1.6 사이드 질문 (/btw)

/btw 명령어를 사용하면 기본 대화 흐름을 중단하거나 영향을 주지 않고 빠른 사이드 질문을 할 수 있습니다.

작동 방식:

• 사이드 질문은 최근 대화 컨텍스트(최대 20개 메시지까지)와 함께 별도의 API 호출로 전송됩니다
• 응답은 Composer 위에 표시됩니다 — 대기 중에도 계속 입력할 수 있습니다
• 기본 대화가 차단되지 않습니다 — 독립적으로 계속 진행됩니다
• 사이드 질문 응답은 기본 대화 기록에 포함되지 않습니다
• 답변은 전체 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│
  ╰──────────────────────────────────────────╯
  > (Composer는 활성 상태 — 계속 입력 가능)

(답변이 도착한 후)

  ╭──────────────────────────────────────────╮
  │ /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 여전히 활성 상태)

지원되는 실행 모드:

1.7 세션 요약 (/recap)

/recap 명령어는 현재 세션의 짧은 “이전 작업 위치” 요약을 생성하여, 긴 대화 기록을 스크롤하지 않고도 이전 대화를 재개할 수 있게 해줍니다.

작동 방식:

• 구성된 빠른 모델(fastModel 설정)이 사용 가능할 때 이를 사용하고, 그렇지 않으면 기본 세션 모델로 대체됩니다. 요약에는 작고 저렴한 모델로 충분합니다.
• 최근 대화(최대 30개 메시지, 텍스트만 — 도구 호출과 도구 응답은 필터링됨)가 엄격한 시스템 프롬프트와 함께 모델로 전송됩니다.
• 요약은 실제 어시스턴트 응답과 구분되도록 어두운 색상과 ❯ 접두사로 렌더링됩니다.
• 모델 턴이 진행 중이거나 다른 명령어가 처리 중이면 인라인 오류로 거부됩니다. 사용 가능한 대화가 없거나 기본 생성이 실패하면, /recap은 요약 대신 짧은 정보 메시지를 표시합니다 — 수동 명령어는 항상 무언가로 응답합니다.

이석 중 복귀 시 자동 트리거:

터미널이 5분 이상 블러 상태였다가 다시 포커스를 받으면, 요약이 자동으로 생성되고 표시됩니다 (모델 응답이 진행 중이 아닐 때만; 그렇지 않으면 현재 턴이 완료될 때까지 기다린 후 실행됩니다). 수동 명령어와 달리, 자동 트리거는 실패 시 완전히 조용합니다: 생성에 오류가 있거나 요약할 내용이 없으면 기록에 메시지가 추가되지 않습니다. general.showSessionRecap 설정으로 제어됩니다 (기본값: false); 수동 /recap 명령어는 이 설정과 관계없이 항상 작동합니다.

예시:

> /recap

❯ Refactoring loopDetectionService.ts to address long-session OOM caused by
  unbounded streamContentHistory and contentStats. The next step is to
  implement option B (LRU sliding window with FNV-1a) pending confirmation.

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를 누르면 구문 강조된 hunk와 함께 인라인 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

Web Shell: Web Shell UI(qwen serve)에서, /diff는 그래픽 diff 대화 상자를 엽니다. 상단의 탭 바를 통해 Changes 뷰와 History 뷰(/log) 간에 전환할 수 있습니다.

History 뷰어 (/log) — Web Shell 전용

/log 명령어는 현재 작업 공간의 커밋 기록 브라우저를 엽니다. Web Shell UI에서만 사용할 수 있으며, CLI/TUI에는 이 명령어가 없습니다.

작동 방식:

/log는 커밋을 역순(최신 우선)으로 나열하는 대화 상자를 엽니다. 각 행에는 다음이 표시됩니다:

• 짧은 SHA (모노스페이스, 전체 SHA를 위한 복사 버튼 포함)
• 커밋 제목 (한 줄)
• 작성자 이름과 상대적 시간 (예: “2h ago”)
• 브랜치/태그 ref 라벨 (있는 경우)
• 병합 커밋에 대한 병합 아이콘 (⎇)

커밋 행을 클릭하면 상세 정보가 필요에 따라 확장됩니다:

• 전체 커밋 메시지 본문
• 파일 변경 통계 (변경된 파일, 추가/삭제된 줄, 파일별 세부 정보)

하단의 Load more를 사용하여 다음 페이지의 커밋을 가져옵니다 (페이지당 50개).

예시:

┌─ History ──────────────────────────── 50 commits ─ ✕ ┐
│                                                       │
│  a1b2c3d  feat(cli): add --json flag        2h ago   │
│           wenshao                                    │
│                                                       │
│  e4f5g6h  fix(core): handle null config     5h ago   │
│           dev · main  v1.2.0                         │
│                                                       │
│ ▼ 789abcd  refactor: simplify parser        1d ago   │
│   ┌─────────────────────────────────────────────┐    │
│   │  Broke the monolithic parse() into smaller  │    │
│   │  functions for readability.                 │    │
│   │                                             │    │
│   │  3 files · +45 −12                          │    │
│   │   +30 −8   src/parser.ts                    │    │
│   │   +10 −2   src/utils.ts                     │    │
│   │   +5  −2   test/parser.test.ts              │    │
│   └─────────────────────────────────────────────┘    │
│                                                       │
│              [ Load more ]                            │
└───────────────────────────────────────────────────────┘

1.9 정보, 설정 및 도움말

정보를 얻고 시스템 설정을 수행하는 명령어입니다.

1.10 일반적인 단축키

1.11 인증 명령어

Qwen Code 세션 내에서 /auth를 사용하여 인증을 구성하세요. /doctor를 사용하여 현재 인증 및 환경 상태를 확인하세요.

2. @ 명령어 (파일 가져오기)

@ 명령어는 로컬 파일이나 디렉터리 내용을 대화에 빠르게 추가하는 데 사용됩니다.

참고: 경로에 포함된 공백은 백슬래시로 이스케이프해야 합니다 (예: @My\ Documents/file.txt)

3. 느낌표 명령어 (!) - Shell 명령어 실행

느낌표 명령어를 사용하면 Qwen Code 내에서 시스템 명령어를 직접 실행할 수 있습니다.

환경 변수: !를 통해 실행된 명령어는 QWEN_CODE=1 환경 변수를 설정합니다.

4. 사용자 정의 명령어

자주 사용하는 프롬프트를 단축 명령어로 저장하여 작업 효율을 높이고 일관성을 유지하세요.

빠른 개요

우선순위 규칙: 프로젝트 명령어 > 사용자 명령어 (이름이 같을 때 프로젝트 명령어가 사용됨)

명령어 명명 규칙

파일 경로 → 명령어 이름 매핑 표

명명 규칙: 경로 구분자(/ 또는 \)가 콜론(:)으로 변환됩니다

Markdown 파일 형식 사양 (권장)

사용자 정의 명령어는 선택적 YAML 프론트매터가 있는 Markdown 파일을 사용합니다:

---
description: 선택적 설명 (/help에 표시됨)
---
 
여기에 프롬프트 내용을 작성하세요.
매개변수 주입에 {{args}}를 사용하세요.

TOML 파일 형식 (더 이상 사용되지 않음)

매개변수 처리 메커니즘

1. 컨텍스트 인식 주입 ({{args}})

2. 기본 매개변수 처리

🚀 동적 내용 주입

3. Shell 명령어 실행 (!{...})

예시: Git 커밋 메시지 생성

---
description: Generate Commit message based on staged changes
---
 
Please generate a Commit message based on the following diff:
 
```diff
!{git diff --staged}
```

4. 파일 내용 주입 (@{...})

예시: 코드 리뷰 명령어

---
description: Code review based on best practices
---
 
Review {{args}}, reference standards:
 
@{docs/code-standards.md}

실용적인 생성 예시

”순수 함수 리팩터링” 명령어 생성 단계 표

---
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

사용자 정의 명령어 모범 사례 요약

명령어 설계 권장 사항 표

보안 기능 알림 표

5. CLI 서브명령어

이 명령어들은 대화형 세션을 시작하기 전에 셸에서 qwen <subcommand>로 실행됩니다.

세션 관리

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

“더 많은 세션이 있음” 힌트는 stderr를 통해 출력되므로 jq로 파이프해도 안전합니다.

예시:

# 최근 20개 세션 표시 (기본값)
qwen sessions list
 
# 최근 50개 세션 표시
qwen sessions list --limit 50
 
# 스크립팅을 위해 JSON으로 출력
qwen sessions list --json | jq .