Agent setup: If your agent doesn't auto-load skills (e.g. Claude Code), see agent-compatibility.md once per session.

Qwen Model Selector (Advisor)

1. Interactive advisory — asks diagnostic questions to recommend the right model (see Diagnostic Flow).
2. Cross-skill resolution — provides a fast-path model lookup for execution skills that need a model decision without user interaction (see recommendation-matrix.md).

Skill directory

references/cli-usage.md

references/error-handling.md

references/recommendation-matrix.md

references/pricing-disclaimer.md

references/pricing.md

references/model-list.md

references/sources.md

references/agent-compatibility.md

Prerequisites

qianwen version

npm install -g @qianwenai/qianwen-cli

Security & Credential Model

sk-...

sk-sp-...

$DASHSCOPE_API_KEY

$QIANWEN_API_KEY

qianwen

qianwen auth login

• NEVER output any credential value in plaintext. Use variable references; report only status ("set" / "not set", "valid" / "invalid"). Never display

  .env

  or config file contents.
• NEVER conflate the two systems. When CLI returns

  Not authenticated

  /

  AUTH_REQUIRED

  , run the 3-step device-flow login (see cli-usage.md). DO NOT ask the user for an API key, and DO NOT try to set

  $DASHSCOPE_API_KEY

  to fix CLI auth.

Data Resolution Order

Default

recommendation-matrix.md

cli-usage.md

qianwen models search "<X>" --format json

error-handling.md

model-list.md

pricing.md

sources.md

Diagnostic Flow (Interactive Advisory)

1. Content type? — text / image / video / audio / vision
2. Primary task? — generation / understanding / coding / reasoning / translation
3. Priority? — quality vs speed vs cost
4. Input size? — short / medium / long context
5. Structured output? — JSON / function calling needed?

Default Recommendations

Degradation: If this skill is not loaded, each execution skill falls back to its own built-in default. This protocol is purely additive — it enhances model selection but never blocks execution.

CLI Quick Reference

Auth required. All

models

and

usage

commands need an active CLI session (browser device-flow login — NOT the API key). If the command returns

Not authenticated

/

AUTH_REQUIRED

:

1. Run the 3-step device-flow login in cli-usage.md (proactively open the verification URL using the OS-appropriate command, then poll immediately).
2. Retry the original command after

   success

   .
3. DO NOT ask the user for

   $DASHSCOPE_API_KEY

   /

   $QIANWEN_API_KEY

   — those are for model API calls, not CLI session. See Security & Credential Model above.
4. DO NOT silently fall back to snapshots.

Token Plan 团队版 (

sk-sp-

keys): The

qianwen

CLI does not yet support querying Token Plan seat allowances or shared-package Credits. For Token Plan usage queries, direct the user to the Token Plan Subscription console. Token Plan model availability (4 text + 4 image models) is documented in recommendation-matrix.md.

qianwen models list --all --format json

qianwen models list --input image --output text --format json

qianwen models info <model-id> --format json

qianwen models search "<query>" --format json

qianwen usage free-tier --format json

qianwen auth status --format json

--format json

--format text

---

CLI Error Handling — Quick Guide

auth-failure

not-installed

model-not-found

qianwen models search "<keyword>"

network-timeout

rate-limit

quota-exhausted

version-mismatch

qianwen version --check

other

Pricing & Cost Estimation

• Latest pricing: Run

  qianwen models info <model> --format json

  first; use

  pricing.md

  only as offline fallback. Never invent a price.
• Mandatory disclaimer: Every cost-related answer must end with the disclaimer in pricing-disclaimer.md (Chinese or English version, matching the user's response language). Omitting the disclaimer is a critical failure.
• Free quota: Never assume free quota is available — use

  qianwen usage free-tier

  to verify or direct the user to the console.
• Usage / billing queries: Direct the user to the appropriate console page — see the table in pricing-disclaimer.md.

Update Check

1. Find qianwen-update-check: Look for

   qianwen-update-check/SKILL.md

   in sibling skill directories.
2. If found — run:

   python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response

   and report the result. Use

   --force

   if the user asks to force-check.
3. If not found — run

   qianwen version --check

   and report the result.

Anti-Patterns

• Never fabricate model names — only recommend models listed in this skill or returned by CLI.
• Never invent or guess any price figure — use CLI /

  pricing.md

  / official pricing page only. Fabricating a price is a critical failure.
• Never silently fall back to snapshots when CLI errors out — apply error-handling.md recovery actions first.
• Never assume free quota is available — quotas may have been consumed, expired, or removed. Always present the paid unit price first.
• Never output API keys in plaintext — see Security section.
• Never confuse CLI session with API key — CLI auth uses browser device-flow login; never offer

  $DASHSCOPE_API_KEY

  or

  $QIANWEN_API_KEY

  as a fix for CLI

  Not authenticated

  /

  AUTH_REQUIRED

  errors.
• Never proactively fetch URLs or trigger web searches — only access online sources when CLI + snapshots cannot answer AND the user confirms.
• Never construct usage/billing/console URLs — only use the exact links listed in this skill or its references. If a URL is not listed, do not invent one.
• Always include the cost disclaimer for any cost-related answer (see pricing-disclaimer.md).

References

qianwen models list --format json

qianwen models info <id> --format json

qianwen models search "<q>" --format json

qianwen usage free-tier --format json