Coding Agent 설정

Qwen Code 설정: API Key, Base URL, 모델

BetterToken API Key와 Base URL로 Qwen Code를 구성하고 Responses 설정 및 파일 읽기 제한을 확인하세요.

~/.qwen/settings.json의 modelProviders.openai를 통해 Qwen Code를 BetterToken에 연결하세요. GPT 모델을 사용한 macOS 테스트에서 Qwen Code 0.26.0은 Responses와 Chat Completions 모두에서 텍스트 요청을 완료했습니다.

주요 설정

필드	값
API Key	`envKey`로 참조하는 BetterToken API Key
Base URL	`baseUrl`의 `https://bettertoken.ai/v1`
모델	`YOUR_MODEL_ID`
제공자 구성	`modelProviders.openai`
API 형식	`wireApi: "responses"`

사전 요구 사항

아래 npm 설치를 위한 Node.js 22 이상
BetterToken API Key: 등록하고 발급받기
모델 광장에서 복사한 Model ID

설치

공식 빠른 시작 안내의 npm 방법을 사용하세요.

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

수동 설정

YOUR_API_KEY를 바꾸고 터미널에서 API Key를 설정하세요.

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

이 설정을 ~/.qwen/settings.json에 병합하세요. 두 YOUR_MODEL_ID 값을 모두 같은 정확한 Model ID로 바꾸세요.

{
  "modelProviders": {
    "openai": [
      {
        "id": "YOUR_MODEL_ID",
        "envKey": "BETTERTOKEN_API_KEY",
        "baseUrl": "https://bettertoken.ai/v1",
        "wireApi": "responses"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "YOUR_MODEL_ID"
  }
}

envKey는 환경 변수 이름이며 API Key 값 자체가 아닙니다. 공식 모델 제공자 참조는 wireApi: "chat-completions"도 지원합니다. 이번 테스트에서 Responses가 파일 읽기 성공 횟수가 더 많았지만 두 형식 모두 모든 시도에서 통과하지는 못했습니다.

연결 확인

같은 터미널에서 텍스트만 확인하는 다음 명령을 실행하세요.

qwen -p "Reply with only: OK" --output-format stream-json --max-session-turns 4

최종 답변에 OK가 있는지 확인하세요. 텍스트 요청 성공이 파일 읽기 작업의 올바른 최종 답변을 보장하지는 않습니다. 작업 흐름을 선택할 때 위 제한 사항을 고려하세요.

모델 전환

modelProviders.openai 아래에 모델 항목을 추가하고 model.name을 정확한 id로 설정한 뒤 새 세션을 시작하세요.

자주 발생하는 오류

증상	확인할 내용
인증 실패	Qwen Code를 실행하는 터미널에서 `envKey`로 지정한 변수를 export하세요.
엔드포인트가 잘못됨	`baseUrl`에 `https://bettertoken.ai/v1`을 사용하세요. `wireApi`가 요청 프로토콜을 선택합니다.
모델을 찾을 수 없음	`model.name`이 `modelProviders.openai` 아래의 `id`와 일치하게 하세요.
파일을 읽은 뒤 답변이 비거나 잘못됨	0.26.0에서는 도구 결과가 올바른 경우에도 발생했습니다. Responses로 바꿔도 실패가 사라지지 않았으므로 파일 읽기 작업에는 다른 테스트된 클라이언트를 사용하세요.

기술 세부 정보

wireApi: "responses"는 /v1/responses를, wireApi: "chat-completions"는 /v1/chat/completions를 선택합니다. Qwen Code 0.26.0 테스트에서 두 텍스트 경로 모두 통과했습니다. 파일 읽기 결과는 각각 2/3, 0/3이었습니다.