XylemNode

接入指南

Qwen Code

通义推出的终端 AI 编码 agent（Gemini CLI 分支），面向代码理解与自动化。它支持 OpenAI 兼容协议，配好环境变量就能用上 XylemNode。

获取 API Key
官网 / 下载
  1. 01

    安装

    用 npm 全局安装，需 Node.js 20+。装完用版本号确认命令就绪。

    # 安装
npm install -g @qwen-code/qwen-code@latest

# 验证
qwen --version
  2. 02

    配置端点与密钥

    用环境变量把 XylemNode 的密钥、地址和模型交给 qwen，地址带 /v1。Windows 用 setx 写入后需重开终端。

    # Windows（PowerShell / CMD）
setx OPENAI_API_KEY "sk-你的密钥"
setx OPENAI_BASE_URL "https://api.xylemnode.com/v1"
setx OPENAI_MODEL "gpt-5.6-sol"
# setx 后重开终端

# macOS / Linux
export OPENAI_API_KEY="sk-你的密钥"
export OPENAI_BASE_URL="https://api.xylemnode.com/v1"
export OPENAI_MODEL="gpt-5.6-sol"
  3. 03

    启动并选认证方式

    在项目目录运行 qwen。首次进入用 /auth 选 Custom Provider / OpenAI，它会用上面的环境变量预填 API Key、Base URL、Model，回车确认即可开始。

    cd /path/to/your/project
qwen

两点说明

① Qwen OAuth 免费层已于 2026 年停用，接第三方端点请走 /auth 里的 Custom Provider / OpenAI。 ② 想固定配置，也可写进 ~/.qwen/.env（放 OPENAI_API_KEY 等），或在 settings.json 的 modelProviders 里定义、用 /model 切换。

常见问题

Qwen Code 用环境变量配好了，但发图片（@image）不工作？

这是已报的一个行为：只用 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL 三个环境变量、settings.json 里没有 modelProviders 条目时，它不会去推断模型的 modalities，图片附件因此走不通。解法是在 settings.json 的 modelProviders 里把这个模型显式写出来，并且把 modalities 放进该条目自己的 generationConfig——官方把 provider 这一层称作不透水层：模型一旦来自 modelProviders，顶层 model.generationConfig 里的 contextWindowSize、modalities 等字段会被整体忽略，只认 provider 条目内的值。写 modelProviders 还有两处容易踩：内置 provider id 只有 openai、anthropic、gemini、vertex-ai、qwen-oauth，想用自定义 id 就必须用顶层 providerProtocol 映射到其中之一，否则整个条目会被跳过、只留一条警告，模型也不会出现在 /model 列表里；OpenAI 兼容端点默认按 Chat Completions 发，要走 Responses 协议得在模型上写 wireApi: "responses"，注意 api 不是它的别名。另外 Qwen OAuth 免费层已停用，接第三方端点请走 /auth 里的 Custom Provider / OpenAI。