Qwen Code 설정: 설치, 제공업체, 독일어 인터페이스 및 API

Qwen Code는 Alibaba의 Qwen 팀이 만든 오픈 소스 AI 코딩 에이전트(Apache-2.0)입니다. 설정은 네 단계로 진행됩니다. 설치하고, 프로젝트에서 qwen를 실행하고, /auth로 제공업체를 선택한 다음, 작업을 요청합니다. 먼저 알아둘 점은 무료 Qwen OAuth 할당량이 2026년 4월 15일에 종료되었다는 것입니다. 이전 안내를 따라도 더 이상 무료로 사용할 수 없습니다. 이 페이지는 최신 /auth 메뉴를 따르며, 독일어로 변경하는 방법, Claude 또는 GPT용 사용자 지정 엔드포인트 설정 방법, 주요 명령어를 보여 줍니다. 최신 버전은 v0.24.7이며 2026년 9월 29일 npm에 출시되었습니다. 릴리스는 최소 주 1회 제공되므로 qwen --version로 버전을 확인하세요.

설치

명령어는 공식 README에서 가져왔습니다. 독립 실행형 설치 프로그램을 사용하면 Node.js를 직접 제공할 필요가 없습니다. npm을 사용할 때만 Node.js 22 이상이 필수입니다.

# macOS / Linux (offizieller Standalone-Installer)
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 (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

이후 터미널을 새로 열어 환경 변수가 적용되도록 하세요. Qwen Code는 원래 Google Gemini CLI v0.8.2를 기반으로 했지만, v0.1부터 독립적으로 개발되었으며 더 이상 원본과 동기화되지 않습니다. Gemini CLI의 설정과 할당량은 여기서 적용되지 않습니다.

첫 실행과 독일어 인터페이스

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

/language ui de-DE 후 Qwen Code는 “인증 방법 선택” 또는 “도구 승인 모드”와 같은 자체 독일어 명칭을 표시합니다. 이 페이지도 동일한 용어를 사용합니다. 응답 언어는 별도로 설정되며 /language output German로 지정합니다.

터미널 외에도 데스크톱 앱, 브라우저의 웹 인터페이스(qwen serve --open, 실험적), VS Code·Zed·JetBrains 통합, 스크립트 및 CI용 헤드리스 모드(qwen -p "...")가 있습니다. 모두 동일한 무료 저장소에 포함되지만, 추론 비용은 별도로 지불해야 합니다.

/auth로 제공업체 선택하기

/auth(별칭 /login)는 최상위에 세 가지 옵션이 있는 “인증 방법 선택”을 엽니다. 아직 Qwen OAuth를 선택하려는 경우 “중단됨 — Coding Plan 또는 API Key로 전환하세요”라는 메시지가 표시됩니다.

세 가지 ModelStudio 방식은 동일한 청구서의 세 가지 결제 수단이 아닙니다. 문서에서는 각각에 별도의 엔드포인트와 키를 지정하며, 키 유형과 baseUrl가 서로 일치해야 합니다. 2026년 10월 1일 기준 Coding Plan은 “제한적으로 제공되며, 선착순으로 매일 0시(UTC+8)에 충전”된다고 표시되어 있었습니다. 따라서 어떤 날에는 구매할 수 없을 수도 있습니다. Coding Plan에서 하나의 작업은 여러 모델 호출을 소비합니다. Alibaba는 간단한 작업에는 일반적으로 5–10회, 복잡한 작업에는 10–30회 또는 그 이상을 제시합니다. 비용 비교는 영어 페이지 Qwen Code pricing에서 자세히 다룹니다.

Claude 또는 GPT 사용하기: settings.json의 사용자 지정 제공업체

인증 문서는 OpenAI, Anthropic, Google, OpenRouter 또는 자체 엔드포인트와 같은 타사 제공업체에 대해 modelProviders 블록을 ~/.qwen/settings.json에 추가할 것을 권장합니다. Kunavo에서는 다음과 같이 설정합니다.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-kompatibel",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

문제 해결에 도움이 되는 네 가지 사항:

• baseUrl는 /v1에서 끝나야 합니다. Model Providers 참조 문서는 /v1 API 루트를 사용하고 /v1/chat/completions는 사용하지 말라고 명시합니다. 경로는 SDK가 직접 추가합니다. 경로를 포함하면 인증 오류가 아니라 404가 발생합니다.
• 키가 저장되는 위치. Qwen Code는 envKey가 지정하는 환경 변수에서 키를 읽습니다. 우선순위는 셸-export, 그다음 .env 파일(권장 .qwen/.env; 처음 발견된 파일만 사용), 마지막으로 env의 settings.json입니다. 후자의 경우 키가 평문으로 저장됩니다.
• 파일이 CLI 옵션보다 우선합니다. 순서는 /auth의 값 → 선택한 modelProviders 항목 → CLI 인수 → 환경 변수 → settings.json입니다. 따라서 --openai-base-url가 때때로 적용되지 않는 것처럼 보입니다. 이전 안내의 security.auth.apiKey 및 security.auth.baseUrl는 오래된 방식입니다.
• Chat Completions로 시작하세요. wireApi가 없으면 Chat Completions가 사용됩니다. "responses"를 사용하면 엔드포인트 검색이나 자동 폴백이 제공되지 않습니다. modelProviders의 변경 사항은 실행 중인 세션에도 적용됩니다(/model를 다시 여세요).

Kunavo 카탈로그에는 Qwen 텍스트 모델이 없습니다. 따라서 Qwen을 더 저렴하게 사용하는 방법이 아니라, 선불 잔액으로 Qwen Code에서 Claude 또는 GPT를 사용하는 방법입니다. Kunavo는 Qwen Code를 해당 엔드포인트에 직접 실행해 보지도 않았습니다. 구성은 영어 Qwen Code 설정 페이지와 마찬가지로 공식 문서에서 가져왔습니다. 시험하는 동안 작동하는 경로를 유지하세요.

첫 작업과 주요 명령어

README는 첫 작업으로 다음과 같은 요청을 제안합니다. “이 저장소를 설명하고 어디서 시작해야 하는지 알려 줘.” 이 요청은 파일 접근과 도구 호출을 한 번에 확인합니다. 단순한 “안녕하세요”만으로는 연결 문제를 발견할 수 없습니다.

yolo 및 기타 자동 모드에 대해 문서 자체도 신뢰할 수 있고 격리된 환경 또는 일회용 환경에서만 사용하라고 경고합니다. /stats model의 예상 비용은 Qwen Code가 직접 계산하며, 실제 금액은 제공업체의 사용 기록에 표시됩니다.

알아두어야 할 제한 사항

• 내장 웹 검색은 호스트에 따라 달라집니다. DashScope의 서버 측 검색을 사용합니다. ModelStudio Standard API Key와 Token Plan, 그리고 감지된 DashScope 호스트의 항목에서는 활성화되고, Coding Plan에서는 비활성화됩니다(여기서는 확인되지 않음). 다른 호스트의 타사 제공업체 및 사용자 지정 엔드포인트에서도 비활성화됩니다(web_search 문서). 대안으로 MCP 검색 서버를 사용할 수 있습니다.
• Kunavo에서는 채팅만 제공됩니다. Kunavo는 임베딩, 음성 합성 또는 음성 인식 모델을 제공하지 않습니다. Qwen Code의 Live Voice는 어차피 DashScope 엔드포인트를 요구하며, 채팅 모델이 가리키는 위치와 관계없이 자체 키를 사용합니다.

Kunavo를 사용해 볼 때 결제하기

Kunavo는 구독 없이 선불 잔액을 사용하고 토큰 단위로 과금됩니다. 최소 충전 금액은 $10이며, Stripe 체크아웃에서는 카드(Visa, Mastercard, American Express), Apple Pay, Google Pay 및 Link를 사용할 수 있고 오스트리아에서는 EPS도 사용할 수 있습니다. SEPA 자동이체는 현재 제공되지 않습니다. Stripe는 영국, 아일랜드 및 핀란드의 구매자에게만 Pay by Bank를 제공하며, 독일에서는 현재 비공개 미리보기로만 제공됩니다(Stripe 문서, 2026년 10월 3일 기준). 자세한 내용은 결제 안내에서 확인하고, 계정을 생성하여 키를 만드세요. 첫 번째 작업 후 사용량 내역에 실제 금액이 표시됩니다.

자주 묻는 질문

2026년 10월 1일 확인: Qwen Code README, 인증·Model Providers·명령어·web_search 문서(main 브랜치), 독일어 UI 텍스트(packages/cli/src/i18n/locales/de.js), npm의 @qwen-code/qwen-code 0.24.7, Coding Plan 및 Token Plan에 관한 Alibaba Cloud 페이지. Kunavo는 Qwen Code를 자사 엔드포인트를 대상으로 실행해 보지 않았습니다.