Qwen Code: OpenAI 호환으로 Claude와 GPT 사용하기

Qwen Code는 Alibaba의 오픈소스 터미널 에이전트입니다. modelProviders 설정이 임의의 OpenAI 호환 base URL을 받으므로 하나의 Code By AI 키로 Claude와 GPT를 사용할 수 있습니다.

Qwen Code는 Gemini CLI에서 파생된 터미널 coding agent입니다. ~/.qwen/settings.json을 읽고 여러 OpenAI 호환 모델을 등록해 /model로 전환할 수 있습니다.

명령 하나로 설정 (macOS / Linux)

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --qwen-code

API 키를 숨김 입력으로 물어본 뒤 셸 설정 파일에 CODEBYAI_API_KEY를 쓰고, ~/.qwen/settings.json에 gpt-5.6-terra와 claude-sonnet-5를 추가해 기본 모델로 지정합니다. 쓰기 전에 원본 파일을 백업합니다. 키는 settings.json에 쓰지 않습니다. QWEN_HOME을 설정했다면 Qwen Code와 마찬가지로 그 위치의 파일을 수정합니다. 다시 실행하면 키가 갱신되고 /model로 고른 모델은 그대로 유지되며, | sh -s -- --uninstall은 원래 파일을 복원합니다. 완료 후 새 터미널을 열고 qwen을 실행하세요. settings.json의 주석은 유지되지 않으며 백업에 남습니다. 아래 수동 단계도 같은 작업을 합니다.

1. Qwen Code 설치하기

Node.js 22 이상이 필요합니다.

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

macOS/Linux에서는 brew install qwen-code도 사용할 수 있습니다. qwen --version으로 확인하세요.

2. Code By AI API 키 만들기

Code By AI에 로그인하고 API Keys 페이지에서 키를 만듭니다. sk-proj-... 형식입니다.

3. settings.json에 모델 추가하기

~/.qwen/settings.json(사용자 수준)을 열고 기존 객체에 다음을 병합합니다. 이미 있는 공급자는 유지하세요.

Copy
1
{
2
  "modelProviders": {
3
    "openai": [
4
      {
5
        "id": "gpt-5.6-terra",
6
        "name": "CodeByAI GPT",
7
        "baseUrl": "https://www.codebyai.net/api/agent/v1",
8
        "envKey": "CODEBYAI_API_KEY"
9
      },
10
      {
11
        "id": "claude-sonnet-5",
12
        "name": "CodeByAI Claude",
13
        "baseUrl": "https://www.codebyai.net/api/agent/v1",
14
        "envKey": "CODEBYAI_API_KEY"
15
      }
16
    ]
17
  },
18
  "security": { "auth": { "selectedType": "openai" } },
19
  "model": { "name": "gpt-5.6-terra" }
20
}

공급자 ID openai는 OpenAI 호환 프로토콜을 뜻합니다. wireApi를 생략했으므로 Chat Completions를 사용하며, 게이트웨이는 이 경로에서 두 패밀리를 모두 처리합니다. Responses API를 의도한 경우가 아니면 wireApi: "responses"를 추가하지 마세요.

4. 키를 환경 변수로 내보내기

자격 증명은 환경에서 읽고 설정 파일에는 저장하지 않습니다.

Copy
1
export CODEBYAI_API_KEY="sk-proj-xxxx"

~/.zshrc 또는 ~/.bashrc에 추가하고 새 셸을 엽니다. 변수가 없으면 Qwen Code는 해당 경로를 건너뛰거나 인증에 실패하며, 다른 공급자로 조용히 대체하지 않습니다.

5. Qwen Code 시작하기

Copy
1
cd your-project
2
qwen

/model을 실행해 gpt-5.6-terra 또는 claude-sonnet-5를 고르고 프롬프트를 보냅니다. 선택은 세션에 저장됩니다.

문제 해결

• /model에 모델이 없음 — modelProviders가 배열 형태가 아니거나 공급자 ID가 내장 인증 유형이 아닙니다. 위의 "openai": [ ... ] 형태를 사용하세요.
• 401 — qwen을 시작한 셸에 CODEBYAI_API_KEY가 없습니다. echo $CODEBYAI_API_KEY로 키가 출력되어야 합니다.
• 404 — baseUrl에 /chat/completions가 붙어 있거나 /v1이 중복되었습니다. https://www.codebyai.net/api/agent/v1을 사용하세요.
• 한 패밀리만 동작 — 모델 ID가 Model Plaza와 일치하는지 확인하세요. claude-*는 Claude 채널로, 나머지는 Codex 채널 모델로 처리됩니다.