터미널에서 코드를 고치고 테스트까지 돌리는 AI 에이전트를 자유롭게 쓰는 방법
프로젝트 폴더에 들어간 뒤 qwen 명령어만 치면, AI가 저장소 구조를 파악하고 필요한 파일을 수정하며 테스트를 실행하는 장면을 눈앞에서 볼 수 있습니다. 이는 터미널, 데스크톱, 브라우저, 채팅 앱 등 다양한 환경에서 동작하는 오픈소스 AI 코딩 에이전트입니다. Qwen 1.0 Preview 버전에서는 Qoder와 Qwen Code의 에이전트 기능을 하나로 묶어 공개했습니다.
1.0 Preview에서 달라진 점
이번 1.0 Preview는 Qoder와 Qwen Code의 에이전트 하네스 기능을 통합한 오픈소스 릴리스입니다. 첫 세션부터 자동 메모리, 스킬, 서브 에이전트, MCP가 기본으로 작동합니다. 에이전트 팀, 에이전트 아레나, 동적 워크플로우는 실험적이거나 선택적으로 활성화되는 기능으로 포함되어 있습니다. 프레임워크와 Qwen 모델 모두 오픈소스라 벤더 종속 없이 함께 발전합니다.
다양한 환경에서 이어 쓰는 작업 흐름
터미널에서 시작해 데스크톱 앱이나 웹 UI로 전환할 수 있습니다. VS Code, Zed, JetBrains 같은 편집기 플러그인도 지원합니다. 텔레그램, 위챗, 깃허브 등 채팅 채널에 연결해 원격으로 작업을 지시할 수도 있습니다. 자동화 스크립트나 CI/CD 파이프라인에서는 헤드리스 모드로 실행하며, TypeScript, Python, Java SDK를 이용해 커스텀 통합을 만들 수 있습니다.
에이전트가 스스로 기억하고 확장하는 방식
에이전트는 세션 간에 자신의 노트를 작성하고 다시 불러오는 자동 메모리 기능을 가집니다. QWEN.md나 AGENTS.md 파일의 지시사항도 자동으로 로드됩니다. 내장된 /review, /bugfix 같은 스킬을 바로 쓰거나, /learn 명령어로 문서나 코드를 분석해 새로운 스킬을 만들 수 있습니다. MCP 서버를 연결해 도구와 리소스를 추가하고, 훅을 설정해 도구 호출 전후에 자체 스크립트를 실행할 수 있습니다.
모델 선택과 성능 검증
OpenAI, Anthropic, Gemini, Qwen API를 지원하며, Ollama나 vLLM 같은 로컬 모델도 런타임에서 전환해 사용할 수 있습니다. SWE-bench Verified 벤치마크에서 Qwen 3.7 Max 모델을 사용해 7개 버전의 평균 점수가 76.40%에서 77.80% 사이로 기록되었습니다. 이는 500개 태스크를 각 버전당 3회씩 실행한 결과입니다.
사용 전 확인해야 할 사항
데몬 모드를 실행할 때 기본 설정은 루프백 주소로만 경청하며 인증을 요구하지 않습니다. 공유 호스트나 신뢰할 수 없는 환경에서는 QWEN_SERVER_TOKEN을 설정하고 --require-auth 옵션을 반드시 사용해야 합니다. NPM 설치 시 Node.js 22 이상이 필요합니다. 설치 후 터미널을 재시작해야 환경 변수가 적용됩니다. 이 저장소는 Google Gemini CLI v0.8.2를 기반으로 시작했으나, v0.1부터 독립적인 개발을 이어오고 있습니다.