Qwen Code를 CheapTokens에 연결하기: 환경 변수와 settings.json

Qwen Code는 OpenAI 호환 커스텀 엔드포인트에 연결할 수 있으므로, CheapTokens에 연결하려면 세 가지 값이 필요합니다: 베이스 URL https://api.cheaptokens.dev/v1, API 키, 그리고 deepseek-ai/DeepSeek-V4-Flash-0731 같은 전체 모델 id입니다. 이들을 OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL로 내보내거나 ~/.qwen/settings.json에 넣으세요. 두 방법 모두 Qwen Code 인증 문서(페이지 최종 업데이트 2026년 10월 22일)에서 나온 것입니다.

긴 세션을 상상해 보세요: 에이전트가 파일 열두 개를 읽고, 세 개를 수정하고, 테스트를 다시 실행합니다. 매 단계마다 컨텍스트를 다시 보내므로 입력 비용을 계속 지불하게 됩니다. 그래서 토큰 잔액 기반의 저렴한 모델이 터미널 에이전트에 적합하고, 아래 설정에 10분을 투자할 가치가 있는 것입니다.

Qwen Code 설치#

Qwen Code는 Node.js 22 이상이 필요합니다. 프로젝트 README(github.com/QwenLM/qwen-code)에 여러 설치 방법이 나열되어 있으며, 그중 두 가지는 다음과 같습니다:

npm install -g @qwen-code/qwen-code@latest

brew install qwen-code

qwen로 시작합니다. 문서에는 프록시나 지원되지 않는 제공자를 수동으로 연결하기 위한 /auth → Custom Provider도 설명되어 있습니다. 아래 두 방법은 한 줄씩 자세히 설명되어 있으니, 그중 하나로 시작하세요.

방법 1: 환경 변수 세 개#

가장 빠른 방법입니다. 프로젝트에서 터미널을 열고 실행하세요:

export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_BASE_URL="https://api.cheaptokens.dev/v1"
export OPENAI_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
qwen

키는 자리 표시자입니다. CheapTokens 대시보드에서 본인의 키를 붙여넣으세요. OPENAI_API_KEY을 내보내는 것은 모든 것을 환경 변수로 설정할 때 Qwen Code가 OpenAI 호환 인증을 사용하도록 하는 역할도 합니다. OPENAI_MODEL에는 별칭 QWEN_MODEL이 있습니다.

사람들이 자주 걸리는 부분이 하나 있습니다: 모델 id입니다. CheapTokens 문서에 있는 전체 id를 사용하세요. 가격 옆에 보이는 짧은 이름 deepseek-v4-flash-0731은 API에서 허용되지 않으며, id는 제공자마다 다릅니다.

어떤 변수가 무슨 역할을 할까요? 짝지어 보세요:

내보낸 값은 터미널을 닫을 때까지 유지됩니다. 설정을 유지하려면 다음 방법을 사용하세요.

방법 2: settings.json과 git 외부의 키#

팀과 저장소를 공유하는데 아무도 설정 파일에 키를 두고 싶지 않다고 해봅시다. 그렇다면 ~/.qwen/settings.json에 모델을 설명하고 키는 별도 파일에 보관하세요.

{
  "modelProviders": {
    "openai": [
      {
        "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
        "name": "DeepSeek-V4-Flash (CheapTokens)",
        "baseUrl": "https://api.cheaptokens.dev/v1",
        "description": "DeepSeek-V4-Flash through CheapTokens",
        "envKey": "CHEAPTOKENS_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek-ai/DeepSeek-V4-Flash-0731" }
}

네 개의 필드가 핵심입니다:

• id은 API로 전송되는 모델 id이므로 전체 id여야 합니다.
• model.name는 id 값 중 하나와 일치해야 하며, 그렇지 않으면 Qwen Code가 선택할 것이 없습니다.
• security.auth.selectedType를 "openai"로 설정하면 OpenAI 호환 경로가 선택됩니다.
• envKey은 키를 담은 변수의 이름을 지정합니다. 선택 사항이며 기본값은 OPENAI_API_KEY입니다.

키 자체는 문서에서 비밀 값에 권장하는 .qwen/.env에 넣으며, 이 파일은 git에서 제외됩니다:

CHEAPTOKENS_API_KEY=sk-your-api-key

settings.json의 env 블록보다 이 방법을 선호할 이유가 있습니다: env의 값은 우선순위가 가장 낮고, 키가 들어 있는 파일은 실수로 커밋하기 쉽습니다. 키를 안전하게 보관하는 방법은 API 키를 안전하게 저장하기에서 더 다룹니다.

실행 후 /model는 설정된 모델을 보여주고 전환할 수 있게 합니다. 특정 모델로 시작하려면 qwen --model "deepseek-ai/DeepSeek-V4-Flash-0731"을 실행하세요.

코딩 세션 비용#

터미널 에이전트는 입력이 많습니다: 각 단계마다 지금까지 수집한 파일과 기록을 함께 보냅니다. 40단계 작업을 가정하고, 단계마다 입력 토큰 30,000개와 출력 토큰 1,000개라고 해봅시다. 그러면 40 × 30,000 = 1,200,000 입력 토큰과 40 × 1,000 = 40,000 출력 토큰입니다. 다음은 실시간 가격 기준의 전체 작업 비용입니다:

입력과 출력을 합쳐 계산하면, 표의 각 모델에서 CheapTokens가 OpenRouter보다 저렴합니다. 이런 종류의 루프에는 DeepSeek-V4-Flash가 잘 맞습니다: 380K 컨텍스트, 한 응답에 최대 32,768 출력 토큰, 시간대와 무관한 단일 가격, 모든 모델에 하나의 잔액. 본인의 수치는 다를 테니 슬라이더를 움직여 보세요:

가격은 가격 페이지에 있습니다. 다른 에이전트에서 사용량을 살펴본다면, Cline 비용은 얼마인가에서 같은 계산을 다룹니다.

시도해 볼 다른 모델#

전환은 id를 바꾸는 것뿐입니다. 모델 페이지나 GET /v1/models에서 가져오세요:

• zai-org/GLM-5.3-Flash: 390K 컨텍스트, 응답당 최대 8,192 출력 토큰, OpenRouter보다 낮은 총 가격.
• MiniMaxAI/MiniMax-M2.7: 180K 컨텍스트, 응답당 최대 8,192 출력 토큰, OpenRouter보다 낮은 총 가격.

OPENAI_MODEL을 변경하거나, modelProviders.openai에 두 번째 항목을 추가하고 /model로 둘 사이를 전환하세요.

Qwen Code가 연결되지 않을 때#

• 인증 유형이 선택되지 않음. 환경 변수만 사용하는 경우 OPENAI_API_KEY를 내보내야 합니다. settings.json을 사용하는 경우 selectedType이 "openai"인지 확인하세요.
• 모델을 찾을 수 없음. model.name는 id와 글자 하나까지 같아야 하며, id는 전체 게이트웨이 id여야 합니다.
• 401. 키가 없거나 잘못되었습니다. envKey를 사용한다면 해당 변수가 .qwen/.env나 셸에 실제로 존재하는지 확인하세요.
• 404. 베이스 URL이 /v1로 끝나는지, id에 오타가 없는지 확인하세요. 전체 안내는 API 401 또는 404: 잘못된 키, 베이스 URL 또는 모델 id에 있습니다.
• 변수가 무시되는 것 같음. settings.json 내부의 env 값은 우선순위가 가장 낮으므로, 다른 곳에서 설정한 변수가 우선합니다.

다른 터미널 에이전트의 설정도 같은 패턴을 따릅니다. 예를 들어 OpenCode와 Aider가 있습니다. 키부터 첫 요청까지 나머지 모든 내용은 CheapTokens 문서에 있습니다.