도구별 실전 가이드 · 공식 정보 확인 2026-08-20

qwen-code Apache-2.0 오픈소스 조건과 시작 절차

작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: CLI · 페이지 갱신: · 운영·편집 기준

터미널에서 코드베이스를 읽고 수정·명령 실행·MCP 도구 호출을 수행하는 Qwen 코딩 에이전트다.

터미널에서 코드베이스를 읽고 수정·명령 실행·MCP 도구 호출을 수행하는 Qwen 코딩 에이전트다. qwen-code의 첫 실전 과제는 “작은 버그를 재현한 뒤 테스트를 추가하고 패치를 제안하게 한다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.

이럴 때 맞습니다

  • “빈 검색어에서 API가 500을 반환하는 문제를 테스트와 함께 고쳐 줘” 같은 입력으로 qwen-code의 핵심 기능을 시험하려는 사람
  • 새 테스트가 수정 전 실패·수정 후 통과하고 diff가 요청 범위를 넘지 않는지 확인한다. 기준으로 qwen-code 결과를 직접 검수할 수 있는 경우
  • CLI 환경에서 Apache-2.0 코드를 직접 설치·관리하려는 작업

이럴 때는 멈추세요

  • CLI 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
  • 다음 위험을 사람이 확인할 수 없는 작업: 셸 명령과 코드 변경을 무검토로 승인하면 비밀 파일 노출이나 파괴적 변경이 발생할 수 있다.

참고 시작점

팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.

터미널에서 실패 테스트 재현하기

Qwen Code가 저장소를 읽고 작은 버그의 실패 로그와 관련 파일을 찾는다.

참고 시작점: 검색 필터 버그를 재현하는 테스트만 실행하고 원인 후보를 설명해 줘.

  1. terminal에서 저장소 상태와 기존 테스트 명령을 확인한다.
  2. Qwen Code에 실패 테스트와 관련 경로만 읽도록 허용한다.
  3. coding-agent가 제시한 원인 후보를 스택 트레이스와 대조하고 아직 파일은 수정하지 않는다.

회귀 테스트와 최소 패치 제안받기

ai-coding agent가 실패를 고정한 테스트와 작은 diff를 제시한다.

참고 시작점: 검색어 앞뒤 공백 때문에 결과가 사라지는 회귀 테스트를 추가하고 최소 수정안을 보여 줘.

  1. Qwen Code가 제안한 회귀 테스트를 먼저 추가해 실패를 확인한다.
  2. developer-tools 명령으로 관련 테스트만 실행하며 수정 파일을 두 개 이내로 제한한다.
  3. terminal에서 통과 결과와 git diff를 확인하고 예상 밖 파일 변경은 되돌릴 후보로 표시한다.

MCP와 셸 권한을 과제 뒤 회수하기

MCP 호출과 명령 실행이 저장소 진단 범위를 벗어나지 않는다.

참고 시작점: 테스트가 통과하면 외부 MCP와 쓰기 권한을 끄고 실행 기록을 요약해 줘.

  1. MCP 도구 목록에서 이번 버그와 무관한 외부 서비스 연결을 비활성화한다.
  2. coding-agent의 terminal 로그에서 삭제·배포·비밀 파일 읽기 명령이 없는지 검토한다.
  3. Qwen Code 세션을 닫고 남은 변경이 승인한 테스트와 구현 파일뿐인지 확인한다.

무료 조건과 주의점

Apache-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

Apache-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도

Apache-2.0 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.

셸 명령과 코드 변경을 무검토로 승인하면 비밀 파일 노출이나 파괴적 변경이 발생할 수 있다.

직접 대안과 비교

  • pi-desktop — Pi Desktop도 저장소에서 실패 테스트를 재현하고 최소 패치와 diff를 검토할 수 있어 같은 버그 수정 과제를 맡길 수 있다.

공식 근거와 확인일

qwen-code 가이드의 주장별 공식 출처
확인 항목확인한 내용공식 출처·확인일
제품 정보터미널에서 코드베이스를 읽고 수정·명령 실행·MCP 도구 호출을 수행하는 Qwen 코딩 에이전트다.qwen-code 공식 사이트
무료 조건Apache-2.0 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도공식 무료 정책·요금 안내
공식 코드 라이선스오픈소스 코드의 사용·수정·재배포 조건공식 코드 라이선스
공식 제품 페이지터미널에서 코드베이스를 읽고 수정·명령 실행·MCP 도구 호출을 수행하는 Qwen 코딩 에이전트다.공식 제품 페이지