터미널에서 Qwen Code를 실행하고 편집 모드를 설정하는 방법

질문은 대개 이렇습니다. 콘솔에서 Qwen이 제대로 작동하게 하고 코드를 알아서 작성하도록 하려면 어떻게 해야 할까요? 보통 이 질문 뒤에는 실망이 숨어 있습니다. 누군가 Qwen Code를 설치하고 질문했지만, 답변으로 텍스트와 코드 한 조각만 받았고 이를 직접 복사해야 했습니다. 프로젝트에 들어가 모든 일을 알아서 해주는 에이전트라고 들었는데도 말입니다.

Qwen Code는 바로 그런 온전한 에이전트입니다. 파일을 열고 수정하며 명령을 직접 실행할 수 있습니다. 동작은 활성 승인 모드에 달려 있습니다. Ask Permissions는 확인을 요청하고 Auto-Edit과 Auto는 더 독립적인 작업을 허용합니다. Default라는 이름을 초기값으로 가정하지 말고 상태 표시를 확인하세요. 아래에서는 설치, 프로젝트에서 실행, 4월 변경 이후 모델 연결, 불필요한 질문 없이 에이전트가 코드를 편집하는 모드로 전환하는 방법을 차례로 설명합니다. 모든 내용은 2026년 8월 30일 기준 Qwen 공식 문서를 확인했습니다.

모델과 에이전트에 관한 실용 자료: Ailoot 문서.

“Qwen Code가 알아서 코드를 작성한다”는 것은 무슨 뜻인가요?#

차이는 간단합니다. 브라우저 채팅은 질문에 텍스트로 답합니다. 답변을 읽고 코드를 복사해 파일에 붙여 넣은 다음, 직접 실행하고 오류를 찾아 다시 채팅에 가져와야 합니다. 채팅과 프로젝트 사이에서 사용자가 전달자 역할을 합니다.

에이전트는 다르게 작동합니다. “피드백 양식을 추가해 줘”, “이 오류를 수정해 줘”처럼 일상적인 말로 작업을 맡기면 됩니다. 그러면 프로젝트 구조를 살펴보고 관련 파일을 찾아 수정한 뒤 검사를 실행합니다. 문서에서는 에이전트가 계획을 세우고 코드를 작성하며 제대로 작동하는지 확인한다고 명확하게 설명합니다.

질문에서 혼란이 생기는 이유가 바로 여기에 있습니다. “Qwen이 알아서 코드를 작성하지 않는다”는 말은 거의 항상 두 가지 중 하나를 뜻합니다. 터미널 에이전트가 아니라 브라우저 채팅을 열었거나, 에이전트는 실행 중이지만 편집할 때마다 허락을 구하는 모드로 설정되어 있는 것입니다. 첫 번째 문제는 Qwen Code를 설치하면 해결되고, 두 번째는 모드를 바꾸면 해결됩니다. 아래에서 두 방법을 모두 설명합니다.

터미널에 Qwen Code를 설치하려면 어떻게 하나요?#

가장 빠른 방법은 시스템에 맞는 버전을 자동으로 선택하는 공식 설치 프로그램을 사용하는 것입니다.

macOS와 Linux에서는 터미널을 열고 다음 한 줄을 붙여 넣으세요.

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows에서는 다음 PowerShell 명령을 사용하세요.

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

이미 npm을 설치했다면 npm을 사용하는 방법도 있습니다. 이 방법에는 Node.js 22 이상이 필요합니다.

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

설치가 끝나면 터미널을 다시 시작하세요. 설치 프로그램은 qwen 명령을 시스템 경로에 추가하며, 터미널은 다시 시작하기 전까지 이를 인식하지 못합니다. “설치했는데 명령을 찾지 못한다”는 문제의 가장 흔한 원인입니다. 설치가 제대로 되었는지 확인하려면 다음 명령을 실행하세요.

qwen --version

버전 번호가 표시되면 에이전트가 설치되었으며 프로젝트에서 실행할 준비가 된 것입니다.

프로젝트에서 Qwen Code를 실행하려면 어떻게 하나요?#

먼저 코드가 있는 폴더로 이동하세요. 중요한 단계입니다. 에이전트는 실행된 폴더 안에서 작동하고 그 안의 내용만 볼 수 있습니다.

cd path-to-your-project
qwen

에이전트 인터페이스가 터미널 안에서 바로 열립니다. 처음 실행하면 모델을 연결하라는 안내가 표시됩니다. 다음 섹션에서 연결 방법을 설명합니다. 모델을 연결한 뒤 다음처럼 일상적인 말로 작업을 입력해 에이전트가 무엇에 접근할 수 있는지 확인할 수 있습니다.

이 프로젝트는 무엇을 하나요?

에이전트가 파일을 읽고 구조를 파악해 유용한 답변을 제공합니다. 그런 다음 “로그아웃 버튼을 추가해 줘”, “이 파일을 둘로 나눠 줘”, “테스트가 실패하는 이유를 찾아 줘”처럼 코드 작성과 편집을 요청할 수 있습니다. 에이전트가 관련 부분을 찾아 직접 변경합니다.

인터페이스 없이 명령어 하나로 실행하는 두 번째 방법도 있습니다. 스크립트와 자동화 작업에 유용합니다.

qwen -p "README를 다시 읽고 명령어 목록을 업데이트해"

대화 없이 작업을 실행하고 종료합니다. 처음 시작할 때는 필요하지 않지만 나중을 위해 알아두면 유용합니다.

에이전트가 실행 중인데도 왜 알아서 작업하지 않나요?#

첫 번째 걸림돌은 모델 액세스입니다. 예전에는 Qwen Code가 무료 액세스를 제공했습니다. qwen.ai 계정으로 로그인하면 카드 없이 에이전트를 사용할 수 있었습니다. 이 액세스는 Qwen OAuth라고 불렸지만 중단되었습니다. 인증 문서에 직접 명시되어 있습니다. 무료 Qwen OAuth 등급은 2026년 4월 15일 종료되었으며, 이전에 저장한 로그인 정보는 잠시 계속 작동할 수 있지만 서버는 새 요청을 거부합니다. “qwen.ai로 로그인” 옵션도 메뉴에서 제거되었습니다.

따라서 에이전트가 작업을 생각해 내려면 먼저 모델을 연결해야 합니다. 다음 섹션에서는 유료 옵션과 무료 로컬 옵션을 모두 다룹니다.

두 번째 이유는 덜 눈에 띄고 더 답답할 수 있습니다. 모델은 연결되어 있고 에이전트도 응답하지만 파일은 수정하지 않고, 무엇을 할지 보여 준 뒤 기다리기만 합니다. Ask Permissions에서는 편집과 명령 전에 확인을 요청하는 것이 정상입니다. 모든 설치의 기본 시작 모드라는 증거는 아닙니다. 에이전트가 알아서 작업하게 하려면 모드를 바꿔야 합니다. 두 섹션 뒤에서 설명하며, 원래 질문에 대한 답도 찾을 수 있습니다.

무료 액세스가 종료된 지금 모델을 연결하려면 어떻게 하나요?#

에이전트에서 다음 명령을 입력하세요.

/auth

세 가지 주요 옵션이 있는 메뉴가 열립니다. 각 옵션의 기능은 다음과 같습니다.

Alibaba ModelStudio는 Qwen 제작자가 제공하는 공식 옵션입니다. 개인 개발자를 위한 고정 가격 및 주간 할당량의 Coding Plan, 팀을 위한 사용량 기반 요금의 Token Plan, 기존 ModelStudio 키를 연결하는 옵션을 제공합니다. Qwen의 “기본” 모델을 유료로 이용하는 방법입니다.

타사 공급자를 이용하면 기본 제공 공급자를 선택하고 키로 연결할 수 있습니다. 공식 목록에는 DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope 등이 포함됩니다. 공급자에게서 키를 받아 입력하면 에이전트가 해당 공급자의 모델을 사용합니다.

Custom Provider는 자체 서버, 프록시 또는 로컬 엔진을 연결합니다. 여기서 Ollama를 통해 컴퓨터에서 실행되는 모델을 연결할 수 있습니다. 이 옵션은 OpenAI, Anthropic, Gemini 형식을 지원하므로 거의 모든 액세스 방식과 호환됩니다.

~/.qwen/settings.json 파일에 키와 설정을 직접 입력할 수도 있습니다. 이 파일에는 modelProviders 필드(사용 가능한 모델), env(키 자체), security.auth.selectedType(시작할 때 활성화할 프로토콜), model.name(기본 모델)이 있습니다. 이렇게 설정하면 qwen이 해당 설정으로 시작하고 아무것도 묻지 않습니다. 처음에는 /auth를 이용하는 편이 더 쉽고, 설정을 모두 저장하고 싶을 때 파일을 수정하면 됩니다.

4월 이후 남아 있는 무료 옵션은 무료 Qwen Code에 관한 글에서 확인하세요.

에이전트가 알아서 코드를 편집하게 하려면 어떤 모드를 켜야 하나요?#

핵심은 액세스 모드가 에이전트의 자율적인 작업 범위를 결정한다는 것입니다. 가장 신중한 모드부터 가장 허용적인 모드까지 다섯 가지가 있습니다.

에이전트가 편집 내용을 보여 주기만 하고 기다린다면 Ask Permissions 모드일 가능성이 높습니다(이전 버전에서는 Default라고 불렸습니다). 그러면 모든 편집과 명령을 직접 확인해야 하므로 에이전트가 알아서 아무것도 하지 않는 것처럼 느껴집니다.

확인 없이 파일을 편집하게 하려면 Auto-Edit으로 전환하세요. 편집은 자동으로 진행되지만, 명령을 실행하기 전에는 계속 확인을 요청합니다. 예를 들어 엉뚱한 위치에서 rm을 실행하는 실수를 막아 주는 합리적인 보호 장치입니다.

Auto는 평가가 필요한 동작에 내부 평가기를 사용합니다. 설치 버전과 활성 상태를 확인한 뒤 의도적으로 선택하세요. Ask Permissions 설정에 남은 default는 호환성 이름이며 시작 모드의 증거가 아닙니다.

YOLO는 가장 허용적인 모드입니다. 에이전트가 아무것도 묻지 않고 파일을 편집하고 명령을 실행합니다. 문서에서는 신뢰하는 개인 프로젝트와 자동화된 작업 흐름에서만 사용하라고 합니다. 업무 프로젝트에서는 원치 않는 결과가 나올 수 있으므로, 정신이 맑을 때만, 가능하면 복사본에서 활성화하세요.

세션 중에 모드를 바꾸려면 어떻게 하나요?#

작업 도중에도 모드를 바꿀 수 있습니다. Shift+Tab을 눌러 다음 모드로 이동하세요. Windows에서는 일반 Tab 키가 같은 역할을 합니다. 순서는 Plan, 확인, 자동 편집, Auto, YOLO, 다시 Plan입니다.

현재 모드는 인터페이스 아래쪽 상태 표시줄에 항상 나옵니다. 에이전트에게 큰 작업을 맡기기 전에 모드를 확인하는 습관을 들이세요. 계획만 살펴보려 했는데 YOLO를 실행하는 일을 막을 수 있습니다.

초보자에게 적합한 작업 흐름은 세 단계입니다.

1. 에이전트를 Plan 모드로 실행하고 작업을 분석해 계획을 제안해 달라고 요청하세요. 아무것도 건드리지 않고 코드만 읽은 뒤, 하려는 일을 설명합니다.
2. 계획을 읽고 동의한다면 Shift+Tab을 눌러 Auto-Edit이나 Auto로 전환하세요.
3. 계속 진행하라고 말하세요. 이제 에이전트가 작업 결과를 확인하는 동안 파일을 알아서 편집합니다.

이 방법을 사용하면 초보자가 가장 걱정하는 “에이전트가 바로 전부 망가뜨리면 어떡하지?”라는 두려움을 줄일 수 있습니다. 먼저 안전한 모드에서 계획을 검토하고, 그 다음에 진행을 맡기면 됩니다.

바이브 코딩의 전체적인 접근 방식은 도구보다 방법론을 중심으로 합니다. Qwen이든 Claude든 그 밖의 도구든, 밑에서 작동하는 모델은 바꿀 수 있습니다. 모델을 바꿔도 결과를 유지하는 데 도움이 되는 세 가지 토대는 AI 클론, Second Brain, 컨텍스트 엔지니어링입니다. 이 세 가지를 함께 활용하면 예측 가능한 결과를 얻을 수 있습니다. 한 번의 운 좋은 결과와는 다릅니다.

카드 없이 사용하는 로컬 모델#

Ollama나 vLLM을 통해 컴퓨터에 오픈 모델을 설치한 다음 /auth 메뉴에서 Custom Provider로 연결하세요. 그러면 에이전트가 Alibaba 클라우드 대신 자신의 컴퓨터에 있는 모델을 사용합니다. 카드나 키가 필요 없고 요청 한도도 없습니다. 코딩에 적합한 오픈 모델은 무료 코딩 모델 리뷰를 참조하세요.

대신 하드웨어가 필요합니다. 코드를 꽤 잘 작성하는 모델은 비디오 메모리를 많이 차지합니다. 강력한 그래픽 카드가 있는 게이밍 컴퓨터에서는 사용할 만하지만, 일반 노트북에서는 모델이 들어가지 않을 수 있습니다. 또는 응답을 생성하는 데 너무 오래 걸려 다른 방법을 찾는 편이 나을 수도 있습니다.

로컬 실행의 또 다른 장점은 데이터 개인정보 보호입니다. 모든 코드가 컴퓨터에 남고 다른 사람의 서버로 전송되지 않습니다. 민감한 프로젝트라면 구독료를 아끼는 것보다 이 점이 더 중요할 수 있습니다.

에이전트가 프로젝트를 망가뜨리지 않게 하려면 어떻게 해야 하나요?#

독립적으로 작동하는 에이전트는 원하는 일을 해주는 동안에는 편리합니다. 실수로 손해를 보지 않으려면 세 가지 습관을 따르세요.

첫째, git을 사용하세요. 프로젝트가 버전 관리에 포함되어 있으면 에이전트가 수정한 내용을 모두 확인하고 원하는 수정 사항을 되돌릴 수 있습니다. git이 없으면 독립적인 에이전트는 정말 위험합니다. 무언가를 바꾸고 나면 이전 버전으로 복구할 방법이 없기 때문입니다. git이 있으면 짧은 명령 하나로 되돌릴 수 있습니다.

둘째, Plan 모드로 시작하세요. 큰 작업을 맡기기 전에 아무것도 건드리지 않는 모드에서 계획을 세우도록 요청하세요. 계획을 읽고 에이전트가 무엇을 하려는지 이해한 다음 편집을 시작하게 하세요.

셋째, YOLO를 조심해서 사용하세요. 이 모드에서는 파일을 삭제하는 명령을 포함해 에이전트가 명령을 직접 실행합니다. 업무 프로젝트에는 너무 많은 권한입니다. 문제가 생겨도 괜찮은 테스트용 복사본이나 작은 작업에만 YOLO를 사용하세요.

이 세 가지 습관은 “바이브 코딩을 하다가 프로젝트를 망가뜨리면 어떡하지?”라는 가장 큰 걱정을 덜어 줍니다. 바이브 코딩에서 변경 사항을 되돌리는 방법은 별도 리뷰를 참조하세요. Claude Code에 관한 글이지만 git을 사용한다는 원칙은 똑같습니다.

작업을 시작하려면 어디서부터 해야 하나요?#

전체 과정을 짧은 목록으로 정리했습니다. 위에서부터 차례로 따라 하세요.

1. 명령어 하나로 Qwen Code를 설치하고 터미널을 다시 시작합니다.
2. cd로 프로젝트 폴더로 이동한 다음 qwen을 실행합니다.
3. /auth를 통해 모델을 연결합니다. 유료 요금제를 선택하거나 카드 결제가 어렵다면 Ollama를 통한 로컬 모델을 선택합니다.
4. Plan 모드에서 에이전트에게 작업을 맡기고 계획을 읽습니다.
5. Shift+Tab으로 Auto-Edit이나 Auto로 전환해 에이전트가 작업하게 합니다.
6. 변경 사항을 되돌릴 수 있도록 프로젝트를 git으로 관리합니다.

요약하면 “Qwen이 알아서 코드를 작성하지 않는다”는 것은 거의 항상 모델이 연결되지 않았거나 에이전트가 확인 모드에 있다는 뜻입니다. 첫 번째 문제는 /auth 메뉴에서 해결하고, 두 번째는 Auto-Edit에 도달할 때까지 Shift+Tab을 눌러 해결하세요. 그러면 에이전트가 터미널에서 실제로 알아서 작업합니다.

Qwen과 다른 에이전트 중 작업에 적합한 도구를 비교하고 싶다면 Claude Code 대안 리뷰를 참조하세요. Qwen도 함께 다루므로 각 도구가 어떤 용도에 적합한지 확인할 수 있습니다.

바이브 코딩의 전체적인 접근 방식은 방법론을 바탕으로 하고, 구체적인 에이전트는 그다음입니다. AI 클론과 Second Brain, 컨텍스트 엔지니어링이 함께합니다. 밑에서 작동하는 도구는 바꿀 수 있지만 방법은 그대로입니다. 실용 자료: Ailoot 문서.

더 많은 자료와 도구: Ailoot.