터미널에서 AI한테 코드를 시키는 도구가 요즘 쏟아지고 있습니다. Claude Code, Gemini CLI, OpenAI Codex CLI까지. 그 사이에 알리바바 Qwen 팀이 만든 Qwen Code도 있습니다. 오픈소스에 멀티 모델 지원이라는 점이 눈에 띄는데, 실제로 설치해서 쓰려면 어떤 과정을 거쳐야 하는지, 지금 무료로 쓸 수 있는지까지 한 번에 정리합니다.
Qwen Code란
Qwen Code는 알리바바 통이 랩(Alibaba Tongyi Lab)이 만든 터미널 기반 AI 코딩 에이전트입니다. GitHub의 QwenLM/qwen-code 저장소에서 Apache-2.0 라이선스로 공개되어 있고, 기본적으로 Qwen3-Coder 모델에 맞춰 설계됐습니다.
핵심은 “Qwen 전용”이 아니라는 점입니다. 같은 CLI에서 DashScope API뿐 아니라 OpenAI, Anthropic, Gemini 호환 API, 심지어 로컬 Ollama나 vLLM 서버도 연결할 수 있습니다. 모델 공급자에 묶이지 않는 에이전트 하니스라는 게 다른 CLI 도구와 구분되는 지점입니다.
설치
지원 OS는 Linux, macOS, Windows 세 가지입니다. 설치 방법은 세 가지 중 하나를 고르면 됩니다.
독립형 설치기 (권장):
“`bash
Linux / macOS
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash “`
“`powershell
Windows PowerShell
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex “`
npm으로 설치 (Node.js 22 이상 필요):
bash npm install -g @qwen-code/qwen-code@latest
Homebrew (macOS / Linux):
bash brew install qwen-code
설치가 끝나면 터미널을 새로 열고 qwen --version으로 확인합니다. pip install로 Qwen Code CLI 자체를 설치하는 공식 방법은 없습니다. 간혹 보이는 pip install python-lsp-server는 선택적 LSP 기능용 언어 서버이지 Qwen Code 본체가 아닙니다.
인증과 설정
설치 다음에 막히는 지점이 바로 여기입니다. Qwen Code를 처음 실행하면 /auth 메뉴가 나오고, 모델 공급자를 골라야 합니다.
Alibaba Model Studio 경로:
- Coding Plan: 월 정액 구독 (Pro 기준 월 ¥200)
- Token Plan: 토큰 종량제
- Standard API Key: 일반 DashScope API 키
제3자 공급자: DeepSeek, Grok, MiniMax, Kimi, OpenRouter 등도 선택할 수 있습니다.
커스텀 공급자: 로컬 서버나 프록시를 직접 지정하는 경로입니다.
DashScope Standard API 키를 쓴다면 settings.json에 다음처럼 설정합니다.
json { "modelProviders": { "openai": [ { "id": "qwen3-coder-plus", "name": "qwen3-coder-plus", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "envKey": "DASHSCOPE_API_KEY" } ] }, "model": { "name": "qwen3-coder-plus" } }
API 키는 환경 변수나 .qwen/.env 파일에 넣고, .gitignore에 추가해서 커밋되지 않게 합니다.
무료로 쓸 수 있나?
결론부터 말하면, 예전만큼 쉽지 않습니다. 2025년에는 Qwen 계정 OAuth 로그인만 하면 하루 1,000회 무료로 쓸 수 있었습니다. 바이브코딩 할 때 무료 치고 넉넉하게 잘 돌아갔다는 경험도 있습니다.
하지만 이 OAuth 무료 티어는 2026년 4월 15일에 중단됐습니다. 지금 새로 설치하면 유료 API를 연결해야 합니다.
현재 남아 있는 무료 요소는 Model Studio Standard API의 신규 사용자 100만 토큰 무료 쿼터입니다. 다만 중국 베이징 리전 기준이고, 활성화 후 90일 이내에 써야 합니다. 다른 리전에서의 무료 쿼터는 공식적으로 보장되지 않으므로 콘솔에서 직접 확인해야 합니다.
프로젝트에서 실행하기
인증이 끝나면 사용법은 간단합니다.
bash cd my-project qwen
프로젝트 폴더에서 qwen을 실행하면 대화형 세션이 시작됩니다. 자연어로 “이 프로젝트 구조를 설명해 줘”, “테스트 실패를 고쳐 줘”처럼 요청하면 에이전트가 파일을 읽고, 편집이나 명령 실행을 제안합니다. 파일을 바꾸기 전에는 변경안을 보여주고 승인을 받도록 설계되어 있습니다.
비대화형 실행도 됩니다. CI/CD 파이프라인이나 스크립트에 넣을 때 유용합니다.
“`bash
한 줄 지시로 실행하고 끝내기
qwen -p “테스트 실패 원인을 분석하고 수정안을 제시해 줘”
모델을 직접 지정
qwen -m qwen3-coder-plus -p “이 저장소를 요약해 줘”
샌드박스 모드로 안전하게
qwen -s -p “테스트 스위트를 실행해 줘” “`
-p는 비대화형, -m은 모델 지정, -s는 샌드박스 실행입니다.
Qwen Code 주요 명령과 기능
세션 안에서 쓸 수 있는 슬래시 명령이 꽤 많습니다. 전부 외울 필요는 없고, 자주 쓰는 것 위주로 알아두면 됩니다.
| 분류 | 주요 명령 | 하는 일 |
|---|---|---|
| 세션 관리 | /init, /summary, /compress, /clear | 세션 초기화, 요약, 컨텍스트 압축, 초기화 |
| 모델·권한 | /auth, /model, /approval-mode | 인증 변경, 모델 전환, 승인 모드 설정 |
| 작업 | /plan, /review, /tasks | 작업 계획, 코드 리뷰, 태스크 관리 |
| 도구·확장 | /mcp, /tools, /extensions | MCP 연결, 도구 목록, 확장 관리 |
이 외에도 몇 가지 알아두면 편한 단축 문법이 있습니다.
@파일경로: 해당 파일이나 디렉터리 내용을 대화에 직접 넣습니다!명령: 셸 명령을 바로 실행합니다/model <모델ID>: 세션 도중에 모델을 바꿉니다
설치된 확장이나 기능 플래그에 따라 보이는 명령이 달라질 수 있으므로, /help로 본인 환경의 실제 목록을 확인하는 게 가장 정확합니다.
/approval-mode yolo는 파일 쓰기, 셸 실행, 네트워크 접근의 승인을 모두 건너뜁니다. 신뢰할 수 있는 샌드박스 환경이 아니라면 쓰지 않는 편이 안전합니다.
실제 코딩에 쓸 때
2025년에 Qwen Code를 바이브코딩에 써본 경험을 돌아보면, 무료 한도 안에서 꽤 넉넉하게 코딩 작업을 처리했습니다. 지시를 주면 국밥처럼 묵직하게 잘 해내는 느낌이었다고 합니다.
Qwen Code가 구동하는 Qwen3-Coder 모델 자체는 MoE(Mixture-of-Experts) 구조로 총 4,800억 파라미터 중 요청당 350억을 활성화하며, 최대 100만 토큰까지 컨텍스트를 확장할 수 있습니다. SWE-bench Verified 기준으로 67~69.6% 수준의 점수를 기록하고 있어, 상용 모델들과 나란히 놓아도 손색없는 코딩 성능입니다.
다만 지금은 무료 OAuth가 막혔기 때문에, 본격적으로 쓰려면 API 비용을 감안해야 합니다.
비용 구조
현재 Qwen Code의 모델 사용 비용은 선택한 경로에 따라 달라집니다.
종량제 (Model Studio Standard API, 중국 베이징 기준):
qwen3-coder-plus 100만 토큰당:
| 요청 입력 길이 | 입력 | 출력 |
|---|---|---|
| 32K 이하 | ¥4 | ¥16 |
| 32K~128K | ¥6 | ¥24 |
| 128K~256K | ¥10 | ¥40 |
더 저렴한 qwen3-coder-flash는 같은 구간에서 입력 ¥1~2.5, 출력 ¥4~10 수준입니다.
정액제 (Coding Plan Pro): 월 ¥200. 시간·주·월 단위 요청 한도가 함께 적용됩니다.
리전, 모델, 프로모션에 따라 가격이 달라질 수 있으므로 결제 전에 공식 가격표와 콘솔을 꼭 확인하세요.
장단점 정리
장점:
- CLI 자체가 Apache-2.0 오픈소스이므로 수정·재배포가 자유롭습니다
- Qwen 모델뿐 아니라 OpenAI, Anthropic, Gemini, 로컬 서버까지 하나의 CLI에서 연결할 수 있습니다
- MCP, 서브에이전트, 데몬 모드(
qwen serve), 메신저 채널 연동 등 확장 기능이 다양합니다 - 비대화형 모드(
-p)로 CI/CD 자동화에 활용할 수 있습니다
단점:
- 예전의 OAuth 무료 티어가 사라져서 진입 장벽이 높아졌습니다
- DashScope API 가격 체계가 리전·모델·입력 길이에 따라 복잡합니다
- 공식 문서가 영문과 중문 위주여서 한국어 사용자에게는 설정 과정이 낯설 수 있습니다
- 모델 공급자를 직접 골라 설정해야 하므로, “설치하면 바로 되는” 경험과는 거리가 있습니다
터미널에서 AI 코딩 에이전트를 쓰고 싶은데 특정 모델에 묶이기 싫다면, Qwen Code는 살펴볼 만한 선택지입니다. 다만 무료였던 시절과 달리 지금은 API 비용이 발생하니, 본인의 사용량과 비용을 먼저 따져보는 게 좋겠습니다.
