Qwen Code: 터미널과 에디터를 넘나드는 오픈소스 AI 코딩 에이전트 CLI
Auto-Memory, MCP, SubAgent 및 다중 LLM 프로토콜을 지원하며 터미널·데스크톱·IDE 전반에서 동작하는 오픈소스 AI 코딩 에이전트 Qwen Code를 소개합니다.
Qwen Code(QwenLM/qwen-code)는 터미널을 중심으로 코드 에디터, 데스크톱 앱, 브라우저 웹 UI, 메신저 채널까지 아우르며 동작하는 오픈소스 AI 코딩 에이전트입니다. Apache License 2.0으로 공개된 이 프로젝트는 특정 언어 모델(LLM) 공급자에 종속되지 않고 런타임에 여러 API와 로컬 모델을 자유롭게 전환할 수 있도록 설계되었습니다. 2025년 6월 저장소 개설 이후 꾸준히 업데이트되고 있으며, 2026년 11월 13일에는 웹 셸과 백그라운드 작업 관리를 다듬은 0.27.3 버전이 릴리스되었습니다.

이미지 출처: QwenLM
단순히 터미널 창에서 질문에 답하는 챗봇과 달리, AI 코딩 에이전트는 로컬 저장소의 파일 구조를 읽고 명령어를 실행하며 코드를 수정하는 작업 흐름을 스스로 조율합니다. Qwen Code는 이러한 에이전트 실행 환경(하네스)을 오픈소스로 제공해, 개발자가 자신의 작업 환경과 선호하는 모델 백엔드를 조합해 쓸 수 있게 해줍니다.
핵심 구조와 다중 모델 지원 방식
Qwen Code의 가장 두드러진 특징은 특정 클라우드 벤더에 묶이지 않는 다중 프로토콜 지원입니다. OpenAI, Anthropic, Gemini, Qwen의 공식 API뿐만 아니라 Ollama나 vLLM처럼 로컬 환경에서 직접 구동하는 오픈 모델 백엔드도 지원하며, 실행 도중(런타임)에 연결할 모델을 바꿀 수 있습니다.
첫 세션을 시작할 때부터 바로 활용할 수 있는 에이전트 구성 요소들도 내장되어 있습니다.
- Auto-Memory 및 Skills: 이전 대화 맥락이나 작업 규칙을 자동으로 기억하고 재사용 가능한 작업 단위를 불러오는 기능입니다.
- SubAgents: 복잡한 작업을 여러 하위 에이전트로 나누어 처리하는 구조입니다.
- MCP(Model Context Protocol): 외부 데이터 소스나 개발 도구를 표준화된 방식으로 AI 모델에 연결해 주는 개방형 프로토콜로, Qwen Code는 이를 기본 지원합니다.
- 실험적 확장 기능: 여러 에이전트가 협업하거나 결과를 비교하는 Agent Teams, Agent Arena, Dynamic Workflows 기능도 내장되어 있으나, 공식 문서 기준으로 실험적(experimental) 또는 선택적 활성화(opt-in) 상태로 분류됩니다.
이와 함께 기존 Qwen Code에 Qoder의 에이전트 하네스 역량을 결합한 오픈소스 프리뷰 트랙인 Qwen Code 1.0 Preview(v1.0.0-preview)도 별도 브랜치와 문서로 제공되고 있습니다.
설치 방법과 실제 사용 흐름
Qwen Code는 개발자의 운영체제와 패키지 관리 환경에 맞춰 여러 설치 경로를 제공합니다. 독립형 셸 스크립트를 실행하거나 Homebrew, 혹은 Node.js 패키지 관리자(npm)를 통해 전역으로 설치할 수 있습니다. 단, npm 패키지로 설치할 때는 Node.js 22.0.0 이상의 런타임 환경이 반드시 필요합니다.
# macOS / Linux 독립형 스크립트 설치
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
# Homebrew 설치 (macOS / Linux)
brew install qwen-code
# npm 설치 (Node.js 22 이상 필수)
npm install -g @qwen-code/qwen-code@latest
설치 후 터미널을 재시작해 환경 변수를 반영한 다음, 작업할 프로젝트 폴더로 이동해 qwen 명령어를 입력하면 에이전트 세션이 열립니다. 세션 내부에서 /auth 명령어를 실행하면 Qwen 계정 구독(Plus 또는 Pro)으로 로그인하거나 외부 API 키를 설정해 바로 코드베이스 분석과 수정 작업을 요청할 수 있습니다.
사용 환경이 터미널에만 머물지 않는다는 점도 실용적입니다. macOS·Windows·Linux용 데스크톱 앱을 내려받아 쓰거나, VS Code, Zed, JetBrains 계열 에디터에 통합해 개발 환경 안에서 직접 호출할 수 있습니다. 또한 qwen serve --open 명령어로 브라우저 기반 Web UI를 띄울 수 있으며, Telegram, DingTalk, WeChat, Feishu 등 메신저 채널 연동도 지원합니다.
최근 0.27.3 릴리스 변경점과 유의사항
2026년 11월 13일 공개된 안정화 버전 0.27.3 변경 로그(CHANGELOG)를 보면, 프로젝트가 다중 세션과 백그라운드 작업 안정화에 초점을 맞추고 있음을 확인할 수 있습니다.
- Web Shell 및 세션 UI 개선: 브라우저 기반 Web Shell 입력창 상단에 완료되지 않은 백그라운드 워크플로우, 셸, 모니터, 로컬 에이전트 상태를 보여주는 칩(chip) UI가 추가되어 기존 상태 바 표시를 대체했습니다. 사이드바 세션 목록도 한 번에 전체를 나열하지 않고 클릭당 10개씩 확장되도록 바뀌었습니다.
- Managed MCP 인벤토리 관리: 연결된 MCP 도구를 최대 32개의 활성 선택 항목으로 계산하고, 동시에 활성화할 수 있는 개수는 16개로 유지하되 제거된 항목의 스냅샷을 최대 96개까지 보관해 복구할 수 있도록 개선했습니다.
- 자동화 및 알림 채널 확장: 지정된 DingTalk 그룹 봇으로 작업 결과와 알림을 마크다운(Markdown) 형식으로 전송하는 웹훅 채널(
dingtalk-webhook)이 추가되었고, 샌드박스 검증 명령(/verify) 실행 시 강제 푸시(force-push)나 누락된 커밋을 처리할 수 있도록 PR과 베이스 이력을 더 깊게 체크아웃하도록 보완되었습니다.
다만 도입 전에 확인해야 할 제약 사항도 분명합니다. 브라우저에서 여는 Web UI(qwen serve --open)와 다이나믹 워크플로우, 통합 에이전트 루프(experimental.unifiedAgentLoop) 같은 일부 고급 기능은 아직 실험적(experimental) 단계로 표기되어 있어 프로덕션 자동화 파이프라인에 그대로 적용하기에는 변동 가능성이 있습니다. 또한 공개된 README와 릴리스 노트에는 전체 아키텍처와 기능 목록이 상세히 기술되어 있으나, 타사 코딩 에이전트 대비 정량적인 벤치마크 수치나 대규모 저장소에서의 실측 성능 데이터는 저장소 본문에 별도로 제시되어 있지 않습니다.
출처
- GitHub 공식 저장소: QwenLM/qwen-code