Qwen Code

프로그램 소개/무엇인지

Qwen Code는 QwenLM에서 개발한 오픈소스 AI 코딩 에이전트로, 터미널을 기반으로 작동하며 데스크톱 앱, 웹 UI, 에디터 플러그인(VS Code, Zed, JetBrains), 채팅 통합(Telegram, DingTalk, WeChat, Feishu) 등을 통해 개발자에게 코드 생성, 디버깅, 프로젝트 탐색 및 자동화 작업을 지원합니다. Apache-2.0 라이선스로 배포되며, Qwen 모델과 연동되어 로컬 및 서드파티 LLM 제공자(OpenAI, Anthropic, Gemini 등)와 실시간 전환이 가능합니다. ‘Agentic out of the box’ 기능을 통해 Auto-Memory, Auto-Skills, SubAgents, Agent Teams, 동적 워크플로우 등을 별도 설정 없이 바로 사용할 수 있습니다.

주요 기능

코드 생성 및 디버깅

plain language로 기능을 설명하면 Qwen Code가 계획을 세우고 코드를 작성하며 작동 여부를 검증합니다. 버그나 오류 메시지를 설명하면 코드베이스를 분석하여 문제를 식별하고 수정을 구현합니다.

프로젝트 탐색 및 웹 연동

전체 프로젝트 구조를 인식하고 최신 정보를 웹에서 찾아올 수 있으며, MCP(Model Context Protocol)를 통해 Google Drive, Figma, Slack과 같은 외부 데이터 소스에서 정보를 가져올 수 있습니다.

자동화 및 스크립트 가능성

따뜻한 lint 문제 해결, 머지 충돌 해결, 릴리스 노트 작성 등을 단일 명령으로 수행할 수 있으며, CI/CD 파이프라인에서 `qwen -p “…”` 형태로 헤드리스 모드로 실행 가능합니다. Followup suggestions 기능을 통해 다음에 입력할 코드를 ghost text로 보여주어 생산성을 높입니다.

다중 인터페이스 지원

터미널(`qwen` 명령), 데스크톱 앱(공식 배포), 웹 UI(`qwen serve –open`), 에디터 플러그인(VS Code, Zed, JetBrains), 채팅 통합(Telegram, DingTalk, WeChat, Feishu via `qwen channel start`) 등을 통해 사용자의 워크플로에 맞는 인터페이스를 선택할 수 있습니다.

개발자 도구 및 확장성

TypeScript, Python, Java SDK를 통해 커스텀 통합이 가능하며, `qwen serve`를 이용한 데몬 모드(HTTP + SSE, ACP 프로토콜)로 멀티 클라이언트 공유 에이전트 구축이 가능합니다. Headless mode는 스크립트, CI/CD, 배치 작업에서 활용할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 PowerShell을 관리자 권한으로 열고 다음 명령을 실행하여 독립형 설치 스크립트를 통해 Qwen Code를 설치할 수 있습니다:

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

설치 후 터미널을 재시작하여 환경 변수가 적용되도록 해야 합니다. 대안적으로 Node.js 22 이상이 설치된 경우 npm을 통해 전역 설치도 가능합니다:

npm install -g @qwen-code/qwen-code@latest

공식 데스크톱 앱은 GitHub 릴리스 페이지에서 macOS, Windows, Linux용 바이너리를 다운로드할 수 있습니다.

기본 사용법/명령어

설치 후 프로젝트 폴더에서 터미널을 열고 다음 명령을 실행하여 Qwen Code를 시작합니다:

cd /path/to/your-project
qwen

첫 실행 시 모델 제공자 연결을 위한 프롬프트가 나타납니다. Alibaba ModelStudio(Coding Plan, Token Plan, Standard API Key), 서드파티 제공자(DeepSeek, MiniMax, Z.AI, Kimi, OpenRouter 등), 또는 커스텀 제공자(로컬 서버, 프록시)를 선택할 수 있습니다. 제공자와 API 키를 설정한 후 다음과 같이 사용할 수 있습니다:

Explain this repository and show me where to start.

이 명령은 프로젝트의 구조와 목적을 분석하여 설명을 반환합니다. 추가로 `/auth` 명령을 통해 언제든지 인증 설정을 수정할 수 있습니다.

이런 경우에 유용합니다

개발자가 자연 언어로 기능을 설명하고 바로 코드를 생성하고 테스트하고 싶을 때 유용합니다. 예를 들어 신규 기능을 구현해야 할 때 ‘로그인 폼을 만들고 유효성 검사 추가’라고 말하면 관련 코드를 생성해 줍니다.

대규모 코드베이스에서 특정 함수나 변수의 용도를 빠르게 파악하고 싶을 때 유용합니다. ‘이 파일에서 데이터 검증 로직은 어디에 있나요?’라고 질문하면 관련 위치를 찾아 설명해 줍니다.

반복적인 개발 작업을 자동화하고 싶을 때 유용합니다. 예를 들어 CI 파이프라인에서 새로운 문자열이 감지되면 프랑스어로 번역하고 PR을 생성하도록 `qwen -p “If there are new text strings, translate them into French and raise a PR for @lang-fr-team to review”`와 같이 스크립트에 삽입할 수 있습니다.

지원 환경·시스템 요구사항

Windows 10 이상, macOS 12 이상, Linux 배포본(우분투 20.04 이상 권장)에서 실행 가능합니다. Node.js 22 이상이 필수이며, npm 또는 독립형 설치 스크립트를 통해 설치할 수 있습니다. ARM64 및 x86_64 아키텍처를 모두 지원합니다.

최신 버전·업데이트

현재 최신 버전은 0.23.3이며, 이전 버전들(0.22.0, 0.19.0, 0.15.0 등)과 비교하여 평가 점수(Avg Score)가 지속적으로 향상되고 있습니다. 버전 0.22.0 기준 평균 점수 77.33%, 통과율 84.4%를 기록했으며, 최신 버전에서는 이러한 성능이 더욱 안정화되었습니다. 업데이트 내역은 GitHub 릴리스 페이지에서 확인할 수 있습니다.

제한 사항·확인 사항

Windows에서 설치 후 터미널을 재시작하지 않으면 `qwen` 명령이 즉시 인식되지 않을 수 있으므로, 설치 후 반드시 터미널을 재시작해야 합니다. 또한, 모델 제공자와의 통신을 위해 인터넷 연결이 필요하며, 오프라인 사용 시 로컬 모델(Ollama, vLLM 등)을 미리 설정해야 합니다. 일부 실험적 기능(Web UI, 데몬 모드)은 ‘–experimental’ 플래그를 통해 활성화해야 할 수 있습니다.

FAQ

• Qwen Code는 무료로 사용할 수 있나요?
  예, Apache-2.0 라이선스로 배포되는 오픈소스 소프트웨어로, 소스 코드와 바이너리를 자유롭게 사용, 수정, 재배포할 수 있습니다.
• Windows에서만 사용할 수 있나요?
  아니요, Windows, macOS, Linux를 모두 지원하며, 공식 데스크톱 앱과 터미널, 웹 UI, 에디터 플러그인, 채팅 통합을 크로스플랫폼으로 제공합니다.
• 사용하려면 API 키가 반드시 필요한가요?
  예, Qwen Code 자체는 오픈소스이지만, 실제 AI 모델 추론을 위해서는 Qwen, OpenAI, Anthropic 등 모델 제공자의 API 키가 필요합니다. 단, 로컬 모델(Ollama, vLLM 등)을 사용할 경우 외부 API 키 없이도 실행 가능합니다.