Qwen Code API 키: 발급처, 연결 방법, 사용량 계산

누군가 Qwen Code를 설치하고 터미널에서 실행했는데, 첫 요청부터 키를 입력하라는 메시지가 뜹니다. 그러면 검색을 시작합니다. 사람들은 “buy api key for qwen code”라고 입력하고, 구독 상품이나 다른 사람의 기존 액세스를 판매하는 페이지로 이동합니다. 키가 무엇인지, 어디서 발급받는지, 비용은 얼마인지 단계별로 알아보겠습니다.

먼저 핵심부터 말하면, API 키는 별도의 포장 상품처럼 판매되지 않습니다. 모델 제공업체의 계정에서 직접 발급하는 액세스 문자열이며, 발급은 무료입니다. 나중에 잔액을 충전할 때 비용이 들며, 이 단계에는 제공업체의 약관이 적용됩니다. 아래에서 키를 어디서 발급받는지, Qwen Code에 연결하는 방법, 사용 비용을 살펴봅니다.

Qwen Code API 키란 정확히 무엇인가요?#

Qwen Code는 터미널에서 실행되며 작업에 필요한 코드를 작성하는 오픈 소스 AI 에이전트입니다. 무료이고 npm으로 설치하며, 자체 신경망은 내장되어 있지 않습니다. 지능적인 작업은 모두 모델이 수행하며, 모델은 제공업체의 서버에서 실행됩니다.

Qwen Code가 모델에 연결하려면 통행증이 필요합니다. 그 통행증이 바로 API 키입니다. 제공업체가 사용자에게 개별적으로 발급하는, 비밀번호처럼 긴 문자열입니다. 에이전트가 요청을 보내면 키를 함께 전달하고, 제공업체는 요청자를 식별해 응답한 뒤 사용량을 잔액에서 차감합니다.

이로부터 혼란의 절반을 해소하는 간단한 결론을 얻을 수 있습니다. 키는 마켓플레이스 상품으로 구매하는 것이 아닙니다. 제공업체에 계정을 만들고 “키 만들기”를 클릭하면 문자열을 무료로 받습니다. “buy api key”라는 검색은 실제로 “어디서 계정을 만들고 나중에 사용료를 어떻게 결제하나요?”라는 뜻이며, 아래에서 두 질문을 모두 다룹니다.

API 키는 구독 및 예전 무료 로그인과 어떻게 다른가요?#

Qwen Code 세션에서 /auth를 실행하면 설치한 버전이 지원하는 인증 선택지가 표시됩니다. 키를 발급한 플랫폼과 과금 요금제에 맞는 항목을 선택하세요. 아래에서는 이전 무료 로그인, Coding Plan, 이 글에서 쓰는 표준 API 키를 구분하며 현재 메뉴 전체를 나열하는 것은 아닙니다.

첫 번째 옵션은 Qwen 계정을 통한 무료 로그인(Qwen OAuth)입니다. 예전에는 키 없이 모델에 액세스할 수 있었지만, 이 방식은 중단되었습니다.

두 번째 옵션은 Alibaba ModelStudio의 Coding Plan 구독입니다. 월 고정 요금으로 주간 요청 할당량과 별도의 연결 주소를 제공합니다.

세 번째 옵션은 모델 제공업체의 API 키입니다. 고정 요금은 없습니다. 잔액을 충전하고 토큰 사용량에 따라 작업한 만큼 지불합니다. 유연한 방식이며 에이전트를 불규칙하게 사용하는 경우에 적합합니다. 이 글의 나머지 부분에서는 이 옵션을 다룹니다.

Qwen Code API 키는 어디서 발급받을 수 있나요?#

Qwen Code는 여러 프로토콜을 이해하므로, 키 제공업체를 하나만 선택해야 하는 것은 아닙니다. 공식 문서에는 연결 가능한 서비스가 명시되어 있습니다.

아래는 직접 연결하는 경로입니다.

직접 연결하려면 Alibaba Model Studio 콘솔에서 원하는 리전을 선택하고 API 키 관리 페이지에서 키를 만드세요. 리전과 워크스페이스 이름은 설정과 함께 기록하되 키는 공유 메모에 복사하지 마세요.

리전 가이드는 운영 환경에서 워크스페이스 전용 도메인을 권장합니다. Workspace Management에서 실제 API Host를 복사하고 Base URL 가이드를 따르세요. 워크스페이스 ID를 만들어 내지 마세요. 기존 공유 DashScope 엔드포인트와 워크스페이스 전용 엔드포인트는 별개 연결 선택지입니다. Coding Plan과 Token Plan도 각각 전용 엔드포인트와 키를 씁니다. 선택한 리전의 워크스페이스 콘솔에서 전체 OpenAI 호환 Base URL을 DASHSCOPE_BASE_URL에 복사하세요. JSON에서는 baseUrl을 생략하고 실행 전에 OPENAI_BASE_URL로 주소를 전달합니다. 워크스페이스 ID 자리표시자가 아닌 콘솔의 실제 값을 사용하세요.

키가 필요 없는 무료 옵션도 있습니다. Ollama를 통해 컴퓨터에서 Qwen 모델을 실행하고 Qwen Code를 자체 서버처럼 연결하면 됩니다. 고성능 컴퓨터와 별도의 설정이 필요합니다. 터미널에서 Qwen Code 실행하기 안내에서 에이전트를 로컬로 실행하는 방법을 확인할 수 있습니다.

Qwen Code에 키를 추가해 작동시키려면 어떻게 해야 하나요?#

기존 설정을 백업하고 아래 연결을 ~/.qwen/settings.json에 병합하세요. 관련 없는 공급자와 환경설정은 덮어쓰지 마세요. Qwen Code 공식 인증 예제를 바탕으로 워크스페이스 URL은 OPENAI_BASE_URL로 전달하고 API 키는 envKey가 지정한 환경 변수에서 읽으며 평문 env 블록은 생략합니다. qwen3-coder-plus는 공식 예제 모델입니다. 선택한 리전과 계정에서 제공하는지 먼저 확인하거나, 그 리전 콘솔의 실제 모델 ID를 두 곳에 동일하게 사용하세요.

선택한 리전의 워크스페이스 콘솔에서 전체 OpenAI 호환 Base URL을 DASHSCOPE_BASE_URL에 복사하세요. JSON에서는 baseUrl을 생략하고 실행 전에 OPENAI_BASE_URL로 주소를 전달합니다. 워크스페이스 ID 자리표시자가 아닌 콘솔의 실제 값을 사용하세요.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai는 호환 프로토콜을 선택합니다. envKey는 Qwen Code가 읽는 변수 이름이지 키 값이 아닙니다. model.name은 설정한 id와 같아야 합니다. 모델 공급자 참고 문서에 필드가 설명되어 있습니다.

macOS나 Linux에서는 Bash 터미널을 열고 표시되지 않는 입력 프롬프트에 키를 입력한 뒤 같은 터미널에서 Qwen Code를 시작하세요:

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

Windows에서는 PowerShell을 사용하세요:

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

이 명령은 실제 비밀 값을 JSON과 셸 명령 기록에 남기지 않습니다. 실행 중인 프로세스는 여전히 환경 변수로 받습니다. 출력하거나 커밋하거나 프롬프트에 붙여 넣지 마세요. 이 경로로 바꿀 때 설정에 남은 기존 비밀 포함 env 항목을 제거하세요. 새 터미널에는 변수를 다시 공급해야 합니다.

Qwen Code에서 /doctor로 인증을 검사하고 /model로 설정한 선택지를 확인하세요. 무해한 빈 테스트 폴더에서 “connected 한 단어로 답하세요. 파일을 읽거나 바꾸거나 명령을 실행하지 마세요”라고 보내세요. 정상 응답은 모델 요청 한 번을 시험하며 사용 요금이 발생할 수 있습니다. /model에 모델이 보이는 것만으로는 로컬 설정만 확인한 것입니다.

실패하면 비밀을 가린 오류와 제공된 요청 ID를 기록하세요. 인증과 모델 접근·과금을 나눠 확인하세요. 같은 공급자 콘솔에서 키 발급 플랫폼, 리전·워크스페이스, 표준 또는 요금제 전용 엔드포인트, 모델 ID, 잔액·할당량을 확인합니다. 401은 키·엔드포인트나 과금 요금제의 불일치일 수 있으므로 공급자 장애의 증거가 아닙니다. 실패한 확인 뒤에는 멈추고 문서로 확인한 불일치를 수정한 뒤 다시 시도하세요. 이 글은 문서 기반 예제이며 가이드를 위해 유료 요청을 수행했다는 뜻이 아닙니다.

API 키를 사용하면 비용은 얼마이고, 무엇이 요금을 늘리나요?#

키와 구독의 차이는 월 고정 금액이 없다는 점입니다. 모델이 읽고 쓰는 양을 토큰으로 측정해 비용을 지불합니다. 토큰은 대략 몇 글자 길이의 텍스트 조각입니다. 각 모델에는 입력 토큰 100만 개당 가격과 출력 토큰 100만 개당 가격이 따로 있으며, 출력은 거의 항상 입력보다 비쌉니다.

토큰 100만 개는 많은 양처럼 보이지만, 대규모 프로젝트를 작업할 때는 예상보다 빨리 소모됩니다. 에이전트는 요청할 때마다 파일을 전부 읽기 때문입니다.

실질적인 결론은 다음과 같습니다. 요금은 에이전트가 처리하는 텍스트 양에 따라 결정됩니다. 긴 파일, 긴 세션, 코드의 반복적인 재읽기가 잔액을 가장 빠르게 소모합니다. 작업의 개수는 부차적입니다. 별도의 글에서 API 토큰 사용량을 계산하는 방법과 사용량이 눈치채지 못하는 사이에 줄어들 수 있는 이유를 단계별로 설명합니다.

결제가 거부되는 이유는 무엇인가요?#

여기서 흔히 실수가 발생합니다.

문제는 그다음 단계에서 생깁니다. 키를 발급했더라도 잔액이 없으면 아무것도 결제할 수 없습니다. 제공업체는 잔액 부족 오류를 반환합니다.

카드를 발급한 은행 때문에 결제가 거부된 경우, 이메일, 인터페이스 언어 또는 프로필 설정을 변경해도 결제 조건은 달라지지 않습니다. 이 구조는 Claude를 위한 해외 카드를 예로 들어 설명합니다.

최종 결정은 결제 게이트웨이가 내린다는 점도 유념하세요. 자체적인 이유로 결제를 거부할 수 있으며, 결제가 승인된다는 보장은 없습니다.

어디서부터 시작해야 하나요?#

간단한 단계별 계획은 다음과 같습니다.

1. 이전 무료 OAuth, Coding Plan, 표준 Model Studio API를 구분하세요. 이전 무료 OAuth는 2026년 4월 종료됐습니다. 이 가이드는 표준 API 종량제 경로를 다루며 현재 인증 선택지 전체를 나열하지 않습니다.
2. 제공업체 계정을 만듭니다. 가장 간단한 옵션은 Alibaba를 직접 이용하는 것입니다.
3. 제공업체 계정의 액세스 키 섹션에서 키를 발급합니다. 발급은 무료이며, 이 단계에는 카드가 필요하지 않습니다.
4. 비밀 값 없이 리전에 맞는 연결을 ~/.qwen/settings.json에 병합하세요. 시작하는 터미널에서 DASHSCOPE_API_KEY를 공급한 뒤 위 절차로 선택한 모델과 짧은 응답 하나를 확인하세요.
5. 사용료를 결제하려면 본인 명의로 발급되었으며 제공업체의 결제 게이트웨이가 승인하는 카드가 필요합니다. 충전 조건은 결제 게이트웨이가 정합니다. 키 발급과 사용료 결제는 서로 별개의 단계입니다.

어떤 모델이 필요한지도 고려해 볼 만합니다. 까다로운 작업에는 고성능 Qwen3-Coder-Plus를 선택하고, 비용을 아끼려면 같은 사용량에서 몇 배 저렴한 경량 모델 Flash를 선택하세요. Claude Code를 대체하는 Qwen Code 안내에서는 Qwen Code가 다른 터미널 에이전트와 어떻게 다른지 보여 줍니다.

더 많은 자료는 Ailoot에서 확인할 수 있습니다.