Token Plan (Team Edition)
지정된 사용자에게 Credits 기반 접근 권한, 팀 관리 기능 및 보다 광범위한 Token Plan 모델 풀을 제공하는 데 최적화된 계획입니다.
도구 + 모델 연계
Qwen Code과 알리바바 코딩 계획 및 크레딧 계획 (Token Plan)
Alibaba Model Studio 인증과 모델 전환 기능이 있는 오픈 소스 CLI 코딩 도구입니다.
Qwen Code는 알리바바와 가장 직접적으로 연계된 터미널 워크플로우입니다. Token Plan, Coding Plan, 및 pay-as-you-go를 위한 안내형 `/auth` 흐름을 제공하며, 명시적인 모델 전환과 IDE 동반 애플리케이션 간 공유 설정도 지원합니다.
올바른 액세스 경로 선택
올바른 액세스 경로 선택
가장 명확한 설정을 원한다면 여기서 시작하세요. 여러 개의 이름이 지정된 모델이나 재현 가능한 팀 설정 지침이 필요하지 않은 이상, 구성 파일을 수동으로 편집하지 말고 `/auth`를 사용하세요.
추천두 계획 모두 사용 가능합니다. 모델 브랜딩이 아닌 사용 패턴에 따라 선택하세요.
Coding Plan
한 명의 개발자에게 최적화된 요금제로, 고정된 월간 인터랙티브 코딩 할당량을 원하며 롤링 및 주간 요청 할당량을 수용할 수 있는 경우에 적합합니다.
Pay-as-you-go Model Studio API
Qwen Code의 대화형 세션 외부에서 애플리케이션 코드 작성, 자동화, CI, 일괄 평가 또는 기타 직접적인 API 작업 부하에 사용하세요.
안전한 구성 패턴
내장 요금제 인증 흐름을 우선 사용하세요
예시는 의도적으로 마스킹되어 있습니다. 플레이스홀더는 사용자의 기기에서만 교체하고, 실제 API 키를 Nfero에 붙여넣지 마세요.
시작하기 전에
- Alibaba의 최신 설치 프로그램을 사용해 Qwen Code를 설치하고, `qwen --version` 명령어로 정상 설치 여부를 확인하세요.
- 사용하려는 Token Plan 또는 Coding Plan 구독에서 전용 API 키를 확보하세요.
- 일반 Model Studio API 키도 함께 사용하는 경우, 계획별 자격 증명을 별도로 관리하세요.
- 현재 지원되는 모델 목록에서 정확한 모델 ID를 선택하세요.
안전한 구성 패턴
- 프로토콜
- OpenAI-compatible
- 구성 경로
~/.qwen/settings.json (macOS/Linux) or %USERPROFILE%\.qwen\settings.json (Windows)
- `qwen`을 실행하고 `/auth`를 입력하세요.
- 구독 요금제를 선택한 후, Alibaba Cloud Model Studio Token Plan 또는 Coding Plan를 선택하세요.
- 해당 요금제에 대한 전용 키를 장치에 입력하세요.
- `/model`을 사용하여 정확히 지원되는 모델을 선택하세요. 가려진 예시는 고급 설정을 위한 동등한 Token Plan 구조를 보여줍니다.
{
"env": {
"BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_TOKEN_PLAN_API_KEY"
},
"modelProviders": {
"openai": [{
"id": "qwen3.7-plus",
"name": "[Token Plan Team Edition] qwen3.7-plus",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
}]
},
"security": { "auth": { "selectedType": "openai" } },
"model": { "name": "qwen3.7-plus" },
"$version": 3
}연결 확인
- `/auth`를 실행하고 예상된 과금 요금제가 선택되었는지 확인합니다.
- `/model`을 실행하고 구성한 모델을 선택합니다.
- 작은 작업 후 `/stats`를 실행하여 세션 사용량을 점검합니다.
- 긴 대화가 컨텍스트 제한에 가까워질 경우 `/compress`를 사용하거나 새 세션을 시작하세요.
모델 연계
추천 시작 모델
이 도구을 사용하여 각 모델과 함께 대화형 코딩, 추론, 검토 및 문서 작업을 수행하세요. 생산 환경에서 최종 모델 가용성과 정확한 계획 지원은 Alibaba Cloud에서 확인하십시오.
Qwenqwen3.7-plus
텍스트 생성추론시각적 이해
최적의 조합 각도
Coding Plan의 현재 기본 추천 모델이며, 강력한 Token Plan 코딩 모델입니다.
Qwenqwen3.7-max
텍스트 생성추론
최적의 조합 각도
대규모 저장소 및 다단계 에이전트 작업에 적합한 긴 컨텍스트 처리 능력을 갖춘 대안 모델입니다.
Qwenqwen3.6-flash
텍스트 생성추론시각적 이해
최적의 조합 각도
작은 규모의 코드 편집 및 일반적인 설명 작업에 빠르고 효율적인 Token Plan 옵션입니다.
자주 발생하는 문제
자주 발생하는 문제
증상
401 잘못된 액세스 토큰
가능한 원인
일반 Model Studio 키가 요금제 엔드포인트와 함께 사용되었거나, 요금제 키가 잘못된 엔드포인트와 연결되었습니다.
해결 방법
`/auth`로 돌아가서 실제 구독을 선택한 후, 해당 구독 전용 키를 다시 입력하세요.
증상
`/model`에서 기대하는 모델이 누락됨
가능한 원인
모델이 `modelProviders`에 추가되지 않았거나, 모델 ID가 정확하지 않거나, Qwen Code가 파일을 새로 불러오지 않았습니다.
해결 방법
현재 허용 목록을 확인하고, 모델 ID를 수정한 후 `settings.json`을 저장한 다음 Qwen Code를 재시작하세요.
증상
입력 길이 또는 컨텍스트 오류
가능한 원인
저장소 컨텍스트와 대화 기록이 모델의 입력 제한을 초과했습니다.
해결 방법
`/compress` 명령어를 사용하거나 새 세션을 시작하거나 작업 디렉토리를 좁히거나, 공식 문서에서 긴 컨텍스트를 지원하는 모델로 전환하세요.
증상
예기치 않은 pay-as-you-go 과금
가능한 원인
Qwen Code가 전용 요금제 쌍이 아닌 일반 Model Studio 키 또는 일반 엔드포인트를 사용 중입니다.
해결 방법
`/auth` 화면과 `settings.json`의 엔드포인트를 확인하세요. 키와 URL 모두 구독한 요금제에 속해야 합니다.
주요 제한 사항
- 전용 API 키와 기본 URL은 동일한 Alibaba 청구 계획에서 가져와야 합니다. Coding Plan, Token Plan, 일반 Model Studio 자격 증명은 상호 교환 불가능합니다.
- 계획 키는 지정된 사용자의 대화형 코딩 또는 에이전트 도구에서만 사용하도록 설계되었습니다. 키를 공유하거나, 저장소에 커밋하거나, 스크린샷에 노출하지 마세요.
- 자동화된 스크립트, 일괄 작업, 애플리케이션 백엔드, 공개 서비스 또는 기타 비대화형 API 작업 부하에는 Coding Plan 또는 Token Plan 키를 사용하지 마세요. 이러한 작업 부하는 pay-as-you-go Model Studio API 접근 방식을 사용해야 합니다.
- 모델 가용성은 정확한 문자열 허용 목록 기반으로 관리되며 변경될 수 있습니다. 작동 중인 설정을 수정하기 전에 현재 Alibaba 계획 문서에서 모델 ID를 반드시 확인하세요.