에이전트의 권한을 제한하기 전에 다른 질문에 답해 보세요. 에이전트가 생성한 첫 번째 diff가 읽어볼 가치가 있는가? 최소 권한(Minimal privileges)은 이득이 아니라 피해에 관한 것입니다. 쓰기 권한 없이 샌드박스에서 에이전트를 실행하여 멋진 로그를 얻을 수는 있지만, 정작 에이전트가 문제를 해결하고 있는지는 알 수 없을 수도 있습니다.

이 글은 하나의 접근 방식에 대한 일기 형식의 기사입니다. 즉, Qwen 코딩 에이전트가 작업 저장소(repository)에 접근하기 전에 수행하는 read-only(읽기 전용) 평가에 관한 것입니다. 논지는 간단하며 실습을 통해 반박할 수도 있습니다. 에이전트를 격리된 작업 세트에 실행하고 제안된 diff를 수동으로 읽어보면, 단 한 줄의 코드 기록 없이도 이러한 변경 사항이 추가 검토를 할 가치가 있는지 확인할 수 있습니다. 만약 diff가 쓸모없다면, 아무리 신중하게 권한을 부여하더라도 이를 구할 수 없습니다.

미리 한계점을 말씀드리겠습니다. Qwen Code의 존재, 승인 모드, /review 팀의 동작, Model Studio 키 획득 단계 및 현재 제한 사항은 QwenLM 및 Alibaba Cloud의 문서에서 가져온 외부 사실입니다 (2026-07-18 기준). 반면, '격리된 작업 세트', '작업 - 제안된 diff - 리뷰 - 판결' 테이블 형식, 그리고 수동 평가 기준은 제가 제안하는 절차이며 Qwen의 문서화된 관행이 아닙니다. 이 둘을 혼동하지 마십시오.

Qwen Code에서 "read-only"란 무엇을 의미하는가

Qwen Code는 QwenLM(github.com/QwenLM/qwen-code)에서 제공하는 오픈 소스 터미널 기반 qwen coding agent입니다. 이 에이전트는 /auth 명령어를 통해 대화형으로 설정할 수 있는 여러 인증 프로토콜(OpenAI, Anthropic, Gemini 및 Qwen/DashScope)을 지원합니다. 즉, 동일한 qwen code agent를 서로 다른 백엔드에 연결할 수 있으며, 이는 공정한 평가를 위해 중요합니다. 모델은 바뀌더라도 리뷰 절차는 동일하게 유지될 수 있기 때문입니다.

에이전트는 다섯 가지 승인 모드를 가지고 있습니다: Plan, Ask Permissions (기본값), Auto-Edit, Auto, 그리고 YOLO입니다. 이들은 Shift+Tab 또는 /approval-mode <name> 명령어로, 혹은 .qwen/settings.json 파일의 `

동일한 읽기 전용 (read-only) 세트를 다른 호환 가능한 경로를 통해 실행해 보는 것도 유용합니다. 예를 들어, provod.ai (러시아의 OpenRouter)와 같은 곳입니다. 이곳에서는 Qwen이 하나의 채팅과 하나의 API 내에서 Claude, GPT, Gemini, DeepSeek와 함께 나란히 배치되어 있습니다. 백엔드를 변경하더라도 규칙은 변하지 않습니다. 먼저 diff를 평가한 다음, 권한을 논의하십시오. 단지 동일한 작업에 대해 두 번째 비교 지점이 생길 뿐입니다.

Qwen Code Agent에 키를 제공하되, 리포지토리는 제공하지 않는 방법

Qwen Code를 공식 API (Alibaba Cloud Model Studio)로 연결하기 위해, 문서는 다음과 같은 경로를 설명합니다: /auth를 실행하고, "Use your own API Key" → "Standard API Key"를 선택한 다음, 지역(region)을 지정하고 키를 환경 변수 BAILIAN_API_KEY에 저장합니다. 호환 모드에서의 기본 URL(Base URL)은 지역에 따라 다릅니다. 베이징, 싱가포르, 미국(버지니아)은 각각 고유한 엔드포인트(endpoint)를 가집니다. 이는 매우 중요한데, 설정 파일에 잘못된 지역을 입력하면 다른 할당량(limit)과 다른 지연 시간(latency)이 적용되기 때문입니다.

키 자체는 CLI에서 가져오는 것이 아닙니다. Alibaba Cloud의 문서에 따르면 계정(또는 API 키 권한이 있는 RAM 사용자)과 활성화된 Model Studio가 필요합니다. 키는 콘솔의 API Key 페이지에서 생성되며, 생성 시 단 한 번만 전체 내용이 표시되므로 즉시 복사하거나 다운로드해야 합니다. 따라서 qwen studio api는 터미널이 아닌 콘솔에서 시작되며, 이는 "qwen api를 어디서 가져오나요"와 같은 질문의 절반 이상에 대한 답변이 됩니다.

# 읽기 전용 (Read-only) 실행: 환경 변수에 키를 설정하며, 어떠한 쓰기 (write) 작업도 수행하지 않음
export BAILIAN_API_KEY="Model_Studio_콘솔에서_가져온_당신의_키"

...

별개의 번거로움은 필요한 페이지에 도달하는 것입니다. "액세스 권한을 달라"는 동일한 의도를 수십 가지 방식으로 작성하며, 일부 문구는 완전히 다른 제품으로 유도합니다. 메신저의 Qwen 봇 (Qwen-bot)은 Model Studio 콘솔과 아무런 관련이 없습니다. 시간을 낭비하지 않기 위한 짧은 요약입니다:

마지막 줄은 함정처럼 여기에 놓여 있으며, 사람들은 정기적으로 여기에 빠집니다. 메신저의 Qwen 봇과 터미널의 Qwen coding agent는 서로 다른 권한을 가진 별개의 제품입니다. 이후의 모든 내용은 두 번째 제품(coding agent)에 관한 것입니다.

하드코딩(Hardcode)해서는 안 되는 모델들

설정 시 가장 흔한 실수는 이전 튜토리얼에 나온 모델 이름을 입력하고 더 이상 확인하지 않는 것입니다. 지난 몇 년 동안 꽤 많은 별칭이 쌓였습니다: qwen 3.7 api, qwen 3.6 api, qwen 3.5 api, qwen 3 api, qwen 2.5 api, qwen max api, 그리고 qwen 3.7 plus api, qwen 3.7 max api, qwen 3.6 27b api와 같은 특정 모델들이 있습니다. 이 목록을 유효 기간이 지났을 수 있는 목록이라고 생각하십시오. 이 목록에 있는 어떤 이름이든 기억이나 타인의 가이드에 의존하지 말고, 실행 당일에 콘솔에서 확인해야 합니다.

여기서의 엄격함은 정당합니다. Model Studio에서 지원하는 모델 개요(2026-07-18 기준 접근 가능)는 권장되는 텍스트 티어(text tiers)로 qwen3.7-max, qwen3.7-plus, qwen3.6-flash를 명시하며, 사용 가능한 전체 목록, 레거시(legacy) 및 타사 모델은 Model Plaza의 별도 카탈로그로 안내합니다. 즉, qwen api models는 변동성이 있는 값이며, 매 실행 전에 대조해야 합니다. 이는 평가 조건의 날짜 지정된 조건과 정확히 일치합니다: 모델과 제한 사항(limits)은 실행 당일에 확인됩니다.

옆에는 실수로 실행 과정에 포함하기 쉬운 두 개의 자(ruler)가 놓여 있습니다. qwen image api는 이미지 생성용이며, 코드 리뷰와는 아무런 관련이 없습니다. 두 번째는 전용 Qwen-Coder입니다. Alibaba의 문서는 qwen3-coder-next 모델을 중심으로 예시를 구성하고 있지만(베이징 지역의 Completions API를 위한 qwen-coder-turbo도 언급함), 대부분의 사용자에게는 비전문적인 작업을 위해 특화된 qwen coder api를 사용하는 대신 최신 범용 (general-purpose) 모델을 사용할 것을 권장합니다. 평가를 위한 결론: 어떤 모델로 diff를 읽었는지 반드시 기록하세요. 판정 결과는 해당 모델에 종속되기 때문입니다.

평가 지도(Evaluation Map): 실행의 핵심 산출물

여기서부터 방법론이 실체화됩니다. 평가 지도(Evaluation Map)는 "작업(task) - 제안된 diff - 리뷰 - 품질 판정"으로 구성된 표입니다. 각 작업에 대해 에이전트가 무엇을 제안했는지(diff 텍스트), /review가 무엇이라고 말했는지, 개인적인 의견은 무엇인지, 그리고 최종 결정(어떤 diff는 계속 검토하고, 어떤 것은 수정을 요청하며, 어떤 것은 즉시 거절할지)을 기록합니다. 이 중 그 어떤 것도 코드에 직접 적용되지 않습니다. 지도는 리포지토리(repository)와 별개로 존재합니다.

왜 이런 번거로운 절차를 거칠까요? "에이전트가 diff를 생성했다"는 것과 "diff가 훌륭하다"는 것은 서로 다른 사건이며, 오직 후자만이 기록을 논할 권리를 부여하기 때문입니다. 지도는 당신이 "대충 작동하는 것 같다"는 막연한 느낌에 굴복하지 않고, 각 항목에 대해 명확한 판단을 내리도록 강제합니다. 에이전트는 오직 긍정적인 평가 지도가 있을 때만 다음 단계로 넘어갑니다. 단순히 변경 사항을 출력했다는 사실만으로는 허용되지 않습니다.

리뷰 기준은 문서화된 표준이 아닌 저의 규범적 입장입니다: 함수의 시그니처(signature) 및 계약(contract) 준수, 작업 범위를 벗어난 불필요한 수정의 부재, 가독성, 테스트의 존재 또는 적절한 스텁(stub), 생소한 코드에서의 "확신에 찬" 환각(hallucination) 부재 등입니다. 당신만의 기준을 세워도 좋습니다. 중요한 것은 기준이 실행 전에 확정되어야 한다는 점입니다. 그렇지 않으면 리뷰가 결과에 맞춰 끼워 맞춰질 수 있습니다.

제한 사항과 429 에러: 읽기 전용(read-only) 실행이 멈추는 지점

무해한 읽기 전용 (read-only) 실행조차 할당량(quota) 문제에 부딪힙니다. Model Studio는 RPM (Requests Per Minute, 분당 요청 수)과 TPM (Tokens Per Minute, 분당 토큰 수)이라는 두 가지 제한 사항을 Alibaba Cloud 루트 계정 수준에서 관리하며, 이를 모든 워크스페이스와 모든 키에 대해 통합하여 적용합니다. 즉, 사용자의 평가용 키는 동일한 계정 내의 다른 모든 키와 상한선을 공유하므로, 하나의 시끄러운 이웃(noisy neighbor)이 전체 실행을 중단시킬 수 있습니다.

qwen3-coder-plus 모델의 구체적인 수치(Model Studio 제한 페이지, 2026-07-18 기준)를 살펴보면, 싱가포르 및 미국(버지니아) 지역은 2,400 RPM / 2,000,000 TPM인 반면, 중국(베이징)은 5,000 RPM / 5,000,000 TPM입니다. 429 에러는 보통 약 1분 정도 지속됩니다. Alibaba는 요청에 따라 제한량이 상향될 수 있다고 명시하고 있으므로, 이 수치들을 영구적인 상한선이 아닌 특정 시점의 스냅샷으로 간주해야 합니다. 평가 작업의 경우, 이는 곧 모든 작업 세트를 한 번에 몰아치지 말고 여러 배치(batch)로 나누어야 함을 의미합니다.

비용과 무료에 대한 신화

이제 비용에 대해 이야기해 보겠습니다. 무료 액세스에 대한 기대는 qwen api бесплатно, free api qwen, qwen api free, qwen free api 등 다양한 방식으로 표현됩니다. 키에 관한 구체적인 검색어로는 qwen api key free, qwen free api key, api ключи qwen бесплатно, 때로는 버전을 포함한 qwen 3.7 api free 등이 있습니다. 하지만 이에 해당하는 요금제는 없습니다. DashScope 키를 통한 표준 경로는 종량제 (pay-as-you-go) 방식이므로, 진짜 질문은 두 가지입니다. 비용이 얼마나 드는지, 그리고 무엇으로 결제하는지입니다.

별도의 제품인 고정형 "Coding Plan" (예: 월 $50의 Pro 레벨)이 Qwen Code, Claude Code, Cursor 등과 같은 도구들을 위한 건별 과금 방식의 대안으로 존재합니다. 이 플랜은 유동적인 제한 (문서에 따르면 5시간당 6,000회 요청, 주당 45,000회, 월간 90,000회)을 적용하며, 그 약관에는 스크립트를 이용한 자동화 및 비대화형 (non-interactive) 사용을 명시적으로 금지하고 있습니다. 우리의 읽기 전용 (read-only) 실행을 고려할 때 이는 중요한 주의 사항입니다. Coding Plan은 표준 API 키와 동일하지 않으며, 수동 리뷰를 위해 필요한 것도 아닙니다. 만약 자동화를 목적으로 qwen api 구매를 원한다면, 스크립트 사용이 금지된 구독 형태가 아닌 일반적인 키가 필요합니다.