Kling 4.0 출시 — 믿기 어려울 만큼 사실적인 영상 | 지금 체험 →
Agent 설정

Qwen Code를 WaveSpeed LLM API에 연결

Qwen Code용 권장 ~/.qwen/settings.json 설정을 복사하고 요청을 /v1/chat/completions로 라우팅한 뒤 WaveSpeed Logs에서 로컬 agent 호출을 확인하세요.

Alibaba의 오픈소스 터미널 코딩 에이전트로, 사용자 지정 OpenAI 호환 제공자를 지원합니다.

설정 파일

~/.qwen/settings.json

프로토콜

OpenAI 호환 chat completions

Endpoint

/v1/chat/completions

수동 설정

1

WaveSpeed 액세스 키 만들기

2

필요한 키를 로컬에서 export

3

설정을 붙여넣을 파일~/.qwen/settings.json

4

qwen 실행 후 Logs 확인

OpenAI 호환 chat completions

사용량은 Dashboard와 Logs에 표시됩니다

Agent 코드를 다시 쓰지 않고 모델 전환

명령어 한 줄로 설정

Qwen Code를 설정하고, 동작을 확인하며, 기존 설정을 백업합니다. --undo를 붙이면 복원할 수 있습니다.

  1. 1

    WaveSpeed CLI 설치

    npm install -g @wavespeed/cli
  2. 2

    로그인

    wavespeed login
  3. 3

    Qwen Code 설정

    wavespeed setup qwen

Node.js가 없나요? 다른 설치 방법 보기

수동 설정

~/.qwen/settings.json 편집
// File: ~/.qwen/settings.json
{
  "modelProviders": {
    "wavespeed": [
      {
        "id": "deepseek/deepseek-v4.1-flash-1017",
        "name": "deepseek/deepseek-v4.1-flash-1017",
        "envKey": "WAVESPEED_API_KEY",
        "baseUrl": "https://llm.wavespeed.ai/v1"
      }
    ]
  },
  "providerProtocol": { "wavespeed": "openai" },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "deepseek/deepseek-v4.1-flash-1017" }
}

변수 이름을 바꾸지 마세요

WAVESPEED_API_KEY는 agent가 읽는 환경 변수 이름입니다. 설정 파일에는 이 이름을 그대로 두고, 실제 API key는 shell 환경 변수에 넣으세요.

1

현재 terminal에서만 임시 적용

이 terminal 창을 닫을 때까지 동작합니다.

export WAVESPEED_API_KEY="wsk_live_..."
2

재시작 후에도 유지

shell profile에 key를 써서 새 terminal에서도 읽을 수 있게 합니다.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Agent 통합 가이드

Qwen Code를 WaveSpeed LLM API와 함께 사용

이 가이드는 ~/.qwen/settings.json, OpenAI 호환 chat completions, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1, 기본 모델 deepseek/deepseek-v4.1-flash-1017로 Qwen Code를 WaveSpeed AI에 연결하는 방법을 보여줍니다. 위 설정을 복사하고 API 키를 export한 뒤 agent를 실행하고 Logs에서 요청을 확인하세요.

1

WaveSpeed 액세스 키 만들기

2

필요한 키를 로컬에서 export

3

설정을 붙여넣을 파일

~/.qwen/settings.json
4

qwen 실행 후 Logs 확인

이 Qwen Code 설정이 구성하는 항목

프로토콜

OpenAI 호환 chat completions

Endpoint

/v1/chat/completions

모델

deepseek/deepseek-v4.1-flash-1017

위의 복사 가능한 설정은 권장 setup에서 수정해야 하는 유일한 Qwen Code 파일입니다: ~/.qwen/settings.json. API 키가 repository에 커밋되지 않도록 shell 환경에 보관하세요.

문제 해결

API 키가 인식되지 않습니다

Qwen Code를 실행하는 같은 shell에서 WAVESPEED_API_KEY를 export하세요. shell profile을 사용한다면 agent를 시작하기 전에 terminal을 다시 로드하세요.

프로토콜 또는 endpoint 오류로 요청이 실패합니다

Qwen Code가 OpenAI 호환 chat completions 및 endpoint /v1/chat/completions를 사용하는지 확인하세요. 프로토콜 불일치는 404 또는 payload 오류의 가장 흔한 원인입니다.

선택한 모델이 작동하지 않습니다

모델 ID가 WaveSpeed Models에 존재하는지 확인한 뒤 정확한 ID를 ~/.qwen/settings.json에 붙여넣으세요. 이 페이지에 표시된 기본 모델로 시작할 수 있습니다.

Logs에 요청이 표시되지 않습니다

Qwen Code가 WaveSpeed base URL과 현재 API 키를 사용하는지 확인하세요. 그런 다음 로컬 agent에서 새 prompt를 보내고 Logs를 새로고침하세요.

이 Qwen Code 가이드가 검색에 표시될 수 있나요?

네. 이 페이지는 Qwen Code custom provider, OpenAI 호환 endpoint, base URL, 로컬 agent 설정 workflow를 검색하는 사용자를 위한 indexable 설정 가이드로 만들어졌습니다.