Qwen Code：用 OpenAI 相容介面跑 Claude 與 GPT

Qwen Code 是阿里開源的終端機 Agent；它的 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 Key，把 CODEBYAI_API_KEY 寫進 shell 設定檔，並把 gpt-5.6-terra 與 claude-sonnet-5 加進 ~/.qwen/settings.json 設為預設模型，寫入前先備份原檔。金鑰不會寫進 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 Key

登入 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
}

openai 這個供應商 ID 代表 OpenAI 相容協定。這裡省略 wireApi，所以走 Chat Completions；閘道在這條路徑同時服務兩個模型家族。除非你明确要用 Responses API，否則不要加 wireApi: "responses"。

4. 匯出金鑰

憑證只從環境變數讀取，不會存進設定檔：

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

把這行加進 ~/.zshrc 或 ~/.bashrc，再開一個新的 shell。變數不存在時，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 的 shell 沒有匯出 CODEBYAI_API_KEY。echo $CODEBYAI_API_KEY 應該印出金鑰。
• 404 — baseUrl 多了 /chat/completions 或重複的 /v1。請用 https://www.codebyai.net/api/agent/v1。
• 只有一個家族能用 — 確認模型 ID 與 模型廣場 一致；claude-* 會轉往 Claude 通道，其餘視為 Codex 通道模型。