Qwen Code

다중 모델 공급자·헤드리스 실행·확장 시스템을 갖춘 Qwen 터미널 코딩 에이전트

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Alibaba Qwen 팀이 공개한 터미널 코딩 에이전트입니다. 대화형 TUI와 헤드리스 실행에서 코드 수정·셸 명령·웹 검색·MCP를 다루며, 스킬·확장·서브에이전트·LSP와 여러 모델 공급자를 지원합니다. CLI는 Apache-2.0으로 무료지만 Qwen OAuth 무료 티어는 2026년 4월 종료돼 Coding Plan, Model Studio API, 제3자 API 또는 로컬 모델을 따로 연결해야 합니다.

판단

이럴 때 씁니다

  • 터미널 대화와 헤드리스·CI 실행을 같은 에이전트로 운영하고 싶을 때
  • Model Studio뿐 아니라 OpenAI·Anthropic·Gemini 호환 API나 로컬 모델을 골라 연결해야 할 때
  • MCP·스킬·확장·LSP·서브에이전트를 조합해 팀별 코딩 워크플로를 만들 때

이럴 땐 쓰지 마세요

  • 무료 Qwen OAuth만 기대하는 경우 — 신규 무료 인증 경로는 종료됐습니다.
  • Coding Plan 키를 애플리케이션 백엔드나 무인 배치에 재사용하려는 경우 — 공식 사용 조건과 맞지 않습니다.
  • 공급자 설정 없이 설치 즉시 완전한 오프라인 코딩 모델이 필요한 경우

차별점

  • Alibaba Model Studio 외에도 내장 제3자 공급자, OpenAI·Anthropic·Gemini 호환 엔드포인트와 로컬 서버를 설정할 수 있습니다.
  • qwen -p와 구조화 스트림 출력을 제공해 대화형 터미널뿐 아니라 스크립트·CI 파이프라인에서도 실행할 수 있습니다.
  • 스킬·확장 시스템, MCP, 서브에이전트, LSP, Git 워크트리와 샌드박스를 한 클라이언트에 묶습니다.
  • 터미널 CLI와 VS Code Companion, ACP·SDK·데몬 표면이 같은 코어를 공유합니다.

워크플로

  1. 01standalone 설치 스크립트를 실행하고 새 셸에서 qwen --version으로 v0.21.2를 확인합니다.
  2. 02프로젝트 루트에서 qwen을 실행하고 /auth에서 Coding Plan, 일반 API, 제3자 또는 로컬 공급자를 고릅니다.
  3. 03기본 승인 모드와 샌드박스 범위를 정한 뒤 MCP·스킬·확장을 필요한 만큼만 추가합니다.
  4. 04대화형 작업은 qwen, 자동화는 qwen -p와 구조화 출력으로 분리하고 각 인증 수단의 사용 조건을 지킵니다.

주요 명령

명령설명
qwen현재 프로젝트에서 대화형 터미널 세션을 시작합니다.
qwen -p "Fix the failing test"프롬프트 한 건을 헤드리스 모드로 실행해 스크립트에 연결합니다.
/authTUI 안에서 Model Studio, 제3자 공급자 또는 사용자 정의 공급자를 설정합니다.
qwen extensions install @scope/package검증한 scoped npm 패키지를 Qwen Code 확장으로 설치합니다.
qwen --sandbox파일·셸 도구를 샌드박스 모드로 실행합니다.

함정

설치 전에 확인하세요

  • Qwen OAuth 무료 티어는 2026-04-15 종료됐습니다. 새 설치는 Coding Plan, Model Studio API, 제3자 API 또는 로컬 모델을 구성해야 합니다.
  • Alibaba Cloud Coding Plan Pro는 2026-08-01 국제 리전 기준 월 50달러이며 대화형 코딩 도구 전용입니다. 자동 스크립트·백엔드·배치 호출에는 일반 API 키를 써야 합니다.
  • npm 수동 설치는 Node.js 22 이상이 필요합니다. 공식 standalone 설치 스크립트를 쓰면 이 런타임 준비 단계를 줄일 수 있습니다.
  • --yolo는 모든 도구 호출을 자동 승인합니다. 신뢰하지 않는 저장소에서는 기본 승인 모드나 --sandbox를 유지해야 합니다.

비교

Kimi Code가 영상 입력과 단일 바이너리 TUI 경험을 앞세운다면, Qwen Code는 공급자 선택과 헤드리스·구조화 출력, 확장 시스템에 무게를 둡니다. Codex CLI처럼 자동화에 넣을 수 있지만 Alibaba Coding Plan은 대화형 코딩 도구 전용이므로 CI에서는 일반 API나 로컬 모델의 사용 조건을 따라야 합니다.

최근 변경

v0.23.2는 0.23.x 안정 릴리스로, 같은 시점의 preview/nightly 및 별도 TypeScript SDK 릴리스와 구분되는 현재 Qwen Code 본체 stable tag입니다.

공식 변경 내역