Qwen Code Cli (Qwen3-Coder 모델) 사용법, 설치 총정리, vs Claude Code와 비교!

 

https://github.com/QwenLM/qwen-code

GitHub - QwenLM/qwen-code: qwen-code is a coding agent that lives in digital world.

 

 

 

https://github.com/QwenLM/Qwen3-Coder

GitHub - QwenLM/Qwen3-Coder: Qwen3-Coder is the code version of Qwen3, the large language model series developed by Qwen team, A

 

 

 

 

 

 

Qwen3‑Coder 모델 특징: 480B MoE로 큐원 3세대 진화

대형 오픈소스 코드 모델 Qwen3‑Coder‑480B‑A35B‑Instruct는 4,800억 파라미터 MoE(혼합 전문가) 구조이면서 활성 파라미터를 350억으로 줄여 추론 비용을 크게 낮췄어. 기본 256K 컨텍스트 창을 제공하고 YaRN 확장을 통해 1 M 토큰까지 길이를 늘릴 수 있지. SWE‑Bench Verified 기준 69.6 % 정확도로 GPT‑4.1·Gemini 2.5를 추월하고, Claude Sonnet 4와 거의 근접한 성능을 기록해 ‘오픈모델 TOP 클래스’ 반열에 올랐어. 

---

설치 총정리: Node 20+와 npm 2줄이면 끝

1. Node.js 20 이상 설치 후 글로벌 CLI 배포판을 깔아.

npm install -g @qwen-code/qwen-code 
qwen --version      # 설치 확인

1. 레포 직접 클론 → npm install -g . 로도 가능해. 

TIP : macOS·Linux 모두 동일 절차며, Windows는 WSL2 환경을 권장해.

 

 

Qwen Code

 

 

 

---

Qwen Code CLI 사용법: /model·/think 프롬프트 한 눈에

CLI를 실행하면 대화형 프롬프트가 열려. 첫 줄에 모델을 지정하자.

qwen
/model qwen3-coder-plus
/think ‘이 코드 버그를 고쳐줘’

여러 API 호출을 병렬로 보내기 때문에 긴 컨텍스트 작업은 토큰 소모가 커질 수 있어. 환경 변수 예시는 다음과 같아.

export OPENAI_API_KEY="DASHSCOPE_KEY"
export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"

중국 내부라면 기본 도메인 dashscope.aliyuncs.com 으로 바꿔주면 돼.

---

한글 설정 방법: 추가 옵션 없이도 완벽 지원

Qwen 계열은 119개 언어를 학습해 K‑switching error 0 % 수준의 자연스러운 한국어 처리 능력을 보여줘. 별도 로캘 설정이 필요 없으니 그대로 /think 나 /code 지시어에 한글 프롬프트를 입력하면 끝이야. Ollama·LM Studio 등 로컬 런타임에서는 ollama run qwen3:8b 처럼 작은 파라미터 버전을 INT4 양자화로 돌려 빠른 속도를 맛볼 수 있어.

 

Qwen3-Coder 특징

 

 

 

 

성능 & 벤치마크: SWE‑Bench·CodeForces 실전 수치

 

지표	Qwen3‑Coder	Claude Sonnet 4	GPT‑4o
SWE‑Bench Verified	69.6 %	70.4 %	74 %대
CodeForces ELO	2,056	~2,080	~2,100

 

500턴 인터랙션에서도 성능이 유지돼 대형 리포지토리 분석, 장거리 디버깅이 끊기지 않는다는 점이 특징이야.

 

---

가격: DashScope 토큰 구간 별 요율 알아두기

구간(입력 토큰)	입력 $/Mtok	출력 $/Mtok
0–32K	$1.0	$5.0
32–128K	$1.8	$9
128–256K	$3	$15

 

캐시 Hit 토큰은 40 % 할인 적용돼. 입력을 /compact 로 요약하거나, qwen3:8b 같은 경량 모델로 선(先) 린트·포맷 작업을 처리하면 비용을 절반까지 세이브할 수 있어.

---

Claude Code와 비교: 프로·콘텍스트·라이선스

항목	Qwen Code CLI	Claude Code CLI
라이선스	Apache 2.0 오픈소스	상용(프로 $20/월)
설치	npm i -g @qwen-code/qwen-code	npm i -g @anthropic-ai/claude-code
지원 모델	Qwen3‑Coder Plus 외 다수	Claude 3.5 Sonnet·Opus 등
컨텍스트	256K–1M	200K (Sonnet)
세션 제약	토큰 기반 과금	회당 45 msg(프로)
MCP 연동	install-mcp 전용 툴	데스크톱 앱 기본 내장

Qwen이 오픈소스·초장문 맥락에 강점을, Claude는 사용 편의성·영어 코드 해설에서 높은 완성도를 보여줘. 

---

MCP 설치 방법: tavily-mcp 로 검색 도구 붙이기

npx install-mcp tavily-mcp --client claude

설치 후 claude_desktop_config.json 또는 qwen-code.json에:

"mcpServers": {
  "tavily": { "command": "tavily-mcp" }
}

추가하면 곧바로 웹검색·코드런 같은 외부 툴을 양쪽 CLI에서 동시에 호출할 수 있어.

---

Qwen Code GitHub 레포: 활발한 커뮤니티 기여

공식 GitHub 저장소(QwenLM/qwen‑code)는 3일 새 ★3 k +를 기록하며 버그 픽스와 플러그인 PR이 쏟아지고 있어. 열려 있는 Discussions에서 모델 핫픽스, 프롬프트 템플릿, VSCode 확장 플랜을 공유하니 이슈 → PR 루프에 참여해 보자.

---

Qwen Code CLI 장단점: 실전 소감

장점

• 1M 토큰까지 읽는 초장문 컨텍스트
• Apache 2.0 기반으로 상업 프로젝트에 자유 사용
• MCP 표준 지원으로 Claude·Cline·VSCode 등과 공존
• 한국어 자연어 요구사항에 즉답

단점

• DashScope 해외 엔드포인트는 레이턴시가 다소 있음
• CLI가 Gemini CLI 포크라 멀티 호출 시 토큰 낭비 가능
• 초대형 모델(480B) API 호출료는 프로덕션에서 다소 부담

---

결론: 오픈소스·장문·다국어 ‘삼위일체’ 코딩 에이전트

정리하면 Qwen Code CLI + Qwen3‑Coder 조합은

1. 설치 : Node 20+ → npm i -g → 키만 넣으면 즉시 사용
2. 한국어 : 별도 옵션 없이 네이티브 품질 지원
3. 성능 : SWE‑Bench·CodeForces 상위권, Claude Sonnet 4에 근접
4. 비용 : 구간 단가·캐시·배치 호출로 Claude Pro 대비 50 % 이하 가능
5. 확장성 : MCP·OpenAI 호환 API 덕분에 모든 워크플로 중앙 집중

따라서 장문 코드 이해 + 오픈 라이선스 + 다국어 최적화를 한꺼번에 노린다면 올여름 가장 매력적인 선택지가 될 거야. 지금 바로 설치해서 내 개발 환경에 합류시켜 보자! 꾸리꾸리~