qwen-adapter 1.0.0

package/.env.example

@@ -0,0 +1,11 @@
+# 通义千问 API Key (必需)
+# 获取地址: https://dashscope.console.aliyun.com/
+QWEN_API_KEY=sk-9fa7dfeabef54f2d956392cebfbd8da6
+
+# 服务配置 (可选)
+PORT=3000
+HOST=localhost
+
+# 模型配置 (可选)
+# 可选: qwen-2.5-max, qwen-2.5-plus, qwen-2.5-turbo
+MODEL=qwen-2.5-max

package/README.md

@@ -0,0 +1,227 @@
+# qwen-adapter
+
+> 使用通义千问模型与 Claude Code - Anthropic 兼容 API 适配器
+
+[![npm version](https://img.shields.io/npm/v/qwen-adapter.svg)](https://www.npmjs.com/package/qwen-adapter)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🎯 功能
+
+- ✅ 将通义千问 API 转换为 Anthropic 兼容格式
+- ✅ 支持 Claude Code 完整功能
+- ✅ 支持流式响应
+- ✅ 支持 Tool Calling
+- ✅ 支持多模态（图片）
+
+## 📦 安装
+
+```bash
+npm install -g qwen-adapter
+```
+
+或使用 npx:
+
+```bash
+npx qwen-adapter start
+```
+
+## 🚀 快速开始
+
+### 1. 获取通义千问 API Key
+
+访问 [阿里云 DashScope](https://dashscope.console.aliyun.com/) 开通服务并创建 API Key。
+
+### 2. 自动配置 Claude Code（推荐）
+
+```bash
+# 一键安装配置
+npx qwen-adapter install
+
+# 设置 API Key
+export QWEN_API_KEY=your_api_key
+
+# 启动代理
+npx qwen-adapter start
+```
+
+### 3. 启动代理服务
+
+**方式一: 使用 .env 配置文件（推荐）**
+
+在项目目录或用户目录创建 `.env` 文件：
+
+```bash
+# 创建配置文件
+cp .env.example .env
+
+# 编辑 .env 文件，填入你的 API Key
+# QWEN_API_KEY=your_api_key_here
+
+# 启动服务
+npx qwen-adapter start
+```
+
+配置文件搜索路径（按优先级）：
+1. 当前工作目录的 `.env`
+2. 项目目录的 `.env`
+3. `~/.qwen-adapter/.env`
+
+**方式二: 使用环境变量**
+
+```bash
+export QWEN_API_KEY=your_api_key
+npx qwen-adapter start
+```
+
+**方式三: 使用命令行参数**
+
+```bash
+npx qwen-adapter start -k your_api_key
+```
+
+**方式四: 指定配置文件路径**
+
+```bash
+npx qwen-adapter start -c /path/to/.env
+```
+
+### 3. 配置 Claude Code
+
+编辑 `~/.claude/settings.json`:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "qwen-key",
+    "ANTHROPIC_BASE_URL": "http://localhost:3000/v1"
+  }
+}
+```
+
+### 4. 启动 Claude Code
+
+```bash
+claude
+```
+
+## 📖 命令
+
+```bash
+# 启动代理服务
+npx qwen-adapter start
+
+# 自动配置 Claude Code（推荐）
+npx qwen-adapter install
+
+# 移除配置
+npx qwen-adapter uninstall
+
+# 显示配置说明
+npx qwen-adapter config
+
+# 测试 API 连接
+npx qwen-adapter test
+```
+
+### 启动选项
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-k, --api-key <key>` | 通义千问 API Key | `QWEN_API_KEY` 环境变量 |
+| `-m, --model <model>` | 使用的模型 | `qwen-2.5-max` |
+| `-p, --port <port>` | 服务端口 | `3000` |
+| `-h, --host <host>` | 服务地址 | `localhost` |
+
+## 🤖 支持的模型
+
+### 通义千问原生模型
+
+| 模型 | 说明 |
+|------|------|
+| `qwen-2.5-max` | 最强模型，推荐使用 |
+| `qwen-2.5-plus` | 平衡性能和成本 |
+| `qwen-2.5-turbo` | 快速响应 |
+
+### Claude 模型别名
+
+以下 Claude 模型名称会被自动映射到对应的通义千问模型：
+
+| Claude 模型 | 映射到 |
+|------------|--------|
+| `claude-opus-4-6`、`claude-opus-4` | `qwen-max` |
+| `claude-sonnet-4-6`、`claude-sonnet-4` | `qwen-plus` |
+| `claude-haiku-4-5`、`claude-haiku-4` | `qwen-turbo` |
+
+## 🔧 高级用法
+
+### 作为库使用
+
+```javascript
+import { startServer } from 'qwen-adapter';
+
+await startServer({
+  apiKey: 'your_api_key',
+  port: 3000,
+  host: 'localhost',
+  model: 'qwen-2.5-max'
+});
+```
+
+### 自定义转换
+
+```javascript
+import { claudeToOpenAI, openAIToClaude } from 'qwen-adapter';
+
+// Claude 请求 → OpenAI 格式
+const openaiReq = claudeToOpenAI(claudeRequest);
+
+// OpenAI 响应 → Claude 格式
+const claudeRes = openAIToClaude(openaiResponse);
+```
+
+## 📊 与其他模型对比
+
+| 模型 | 代码能力 | 推理能力 | 中文能力 | 成本 |
+|------|---------|---------|---------|------|
+| Claude 4.6 Opus | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | 💰💰💰 |
+| GPT-4o | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | 💰💰 |
+| **Qwen-2.5-Max** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 💰 |
+| GLM-4 | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 💰 |
+
+## ⚠️ 已知限制
+
+1. **Tool Calling 差异**: 通义千问的 Function Calling 格式与 Claude 略有不同，大部分场景可正常工作
+2. **上下文长度**: 通义千问 128K vs Claude 200K，超长对话可能受限
+3. **响应速度**: 可能比 Claude 原生 API 稍慢
+
+## 🛠️ 故障排除
+
+### API Key 无效
+
+```
+Error: Qwen API error: 401
+```
+
+检查:
+- API Key 是否正确
+- 是否已开通通义千问服务
+- API Key 是否有余额
+
+### 端口被占用
+
+```
+Error: listen EADDRINUSE
+```
+
+使用其他端口:
+```bash
+npx qwen-adapter start -p 3001
+```
+
+## 📝 License
+
+MIT
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！

package/bin/cli.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+/**
+ * @anthropic-ai/qwen-adapter CLI
+ *
+ * 用法:
+ *   npx qwen-adapter start                    # 启动代理服务
+ *   npx qwen-adapter config                   # 显示配置说明
+ *   npx qwen-adapter test                     # 测试连接
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import dotenv from 'dotenv';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+import { startServer } from '../src/server.js';
+import { showConfig } from '../src/commands/config.js';
+import { testConnection } from '../src/commands/test.js';
+import { install, uninstall } from '../src/commands/install.js';
+
+// 加载 .env 文件（从当前工作目录和项目目录）
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const envPaths = [
+  join(process.cwd(), '.env'),           // 当前工作目录
+  join(__dirname, '..', '.env'),         // 项目目录
+  join(process.env.HOME || '~', '.qwen-adapter', '.env'),  // 用户目录
+];
+
+for (const envPath of envPaths) {
+  if (existsSync(envPath)) {
+    dotenv.config({ path: envPath });
+    break;
+  }
+}
+
+const program = new Command();
+
+program
+  .name('qwen-adapter')
+  .description('Use Qwen models with Claude Code - An Anthropic-compatible API adapter')
+  .version('1.0.0');
+
+// start 命令
+program
+  .command('start')
+  .description('Start the proxy server')
+  .option('-p, --port <port>', 'Server port', process.env.PORT || '3000')
+  .option('-k, --api-key <key>', 'Qwen API Key', process.env.QWEN_API_KEY)
+  .option('-m, --model <model>', 'Qwen model to use', process.env.MODEL || 'qwen-2.5-max')
+  .option('-h, --host <host>', 'Server host', process.env.HOST || 'localhost')
+  .option('-c, --config <path>', 'Path to .env config file')
+  .action(async (options) => {
+    // 如果指定了配置文件，加载它
+    if (options.config) {
+      dotenv.config({ path: options.config });
+      // 重新读取配置
+      options.apiKey = options.apiKey || process.env.QWEN_API_KEY;
+      options.port = options.port !== '3000' ? options.port : (process.env.PORT || '3000');
+      options.model = options.model !== 'qwen-2.5-max' ? options.model : (process.env.MODEL || 'qwen-2.5-max');
+      options.host = options.host !== 'localhost' ? options.host : (process.env.HOST || 'localhost');
+    }
+
+    const apiKey = options.apiKey;
+
+    if (!apiKey) {
+      console.error(chalk.red('Error: QWEN_API_KEY is required'));
+      console.error(chalk.yellow('Set it via:'));
+      console.error('  - Command line: --api-key YOUR_KEY');
+      console.error('  - Environment: export QWEN_API_KEY=YOUR_KEY');
+      console.error('  - .env file: QWEN_API_KEY=YOUR_KEY');
+      console.error('  - Config file: --config /path/to/.env');
+      process.exit(1);
+    }
+
+    console.log(chalk.cyan.bold('\n🚀 Qwen Adapter for Claude Code\n'));
+    console.log(chalk.gray('━'.repeat(40)));
+    console.log(chalk.white(`  Model:  `) + chalk.green(options.model));
+    console.log(chalk.white(`  Port:   `) + chalk.green(options.port));
+    console.log(chalk.white(`  Host:   `) + chalk.green(options.host));
+    console.log(chalk.gray('━'.repeat(40)));
+    console.log(chalk.yellow('\nClaude Code 配置:'));
+    console.log(chalk.white('  ANTHROPIC_BASE_URL: ') + chalk.cyan(`http://${options.host}:${options.port}/v1`));
+    console.log(chalk.white('  ANTHROPIC_AUTH_TOKEN: ') + chalk.cyan('任意值（如: qwen-key）'));
+    console.log();
+
+    await startServer({
+      port: parseInt(options.port),
+      host: options.host,
+      apiKey,
+      model: options.model
+    });
+  });
+
+// config 命令
+program
+  .command('config')
+  .description('Show configuration instructions')
+  .action(() => {
+    showConfig();
+  });
+
+// test 命令
+program
+  .command('test')
+  .description('Test Qwen API connection')
+  .option('-k, --api-key <key>', 'Qwen API Key')
+  .action(async (options) => {
+    const apiKey = options.apiKey || process.env.QWEN_API_KEY;
+    if (!apiKey) {
+      console.error(chalk.red('Error: QWEN_API_KEY is required'));
+      process.exit(1);
+    }
+    await testConnection(apiKey);
+  });
+
+// install 命令 - 自动配置 Claude Code
+program
+  .command('install')
+  .description('Configure Claude Code to use Qwen Adapter')
+  .option('-p, --port <port>', 'Proxy server port', '3000')
+  .option('-h, --host <host>', 'Proxy server host', 'localhost')
+  .action(async (options) => {
+    await install(options);
+  });
+
+// uninstall 命令 - 移除配置
+program
+  .command('uninstall')
+  .description('Remove Qwen Adapter configuration from Claude Code')
+  .action(async () => {
+    await uninstall();
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "qwen-adapter",
+  "version": "1.0.0",
+  "description": "Use Qwen models with Claude Code - An Anthropic-compatible API adapter",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "qwen-adapter": "./bin/cli.js"
+  },
+  "exports": {
+    ".": "./src/index.js",
+    "./server": "./src/server.js",
+    "./converters": "./src/converters/index.js"
+  },
+  "scripts": {
+    "start": "node bin/cli.js start",
+    "dev": "node --watch bin/cli.js start",
+    "test": "node tests/test.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "qwen",
+    "anthropic",
+    "openai-compatible",
+    "proxy",
+    "adapter"
+  ],
+  "author": "Tie Zi",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "node-fetch": "^3.3.2",
+    "chalk": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/renyanfeng/qwen-adapter.git"
+  },
+  "homepage": "https://github.com/renyanfeng/qwen-adapter#readme"
+}

package/src/commands/config.js

@@ -0,0 +1,68 @@
+/**
+ * 配置说明命令
+ */
+
+import chalk from 'chalk';
+
+export function showConfig() {
+  console.log();
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log(chalk.cyan.bold('           Qwen Adapter for Claude Code - 配置说明'));
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log();
+
+  console.log(chalk.yellow.bold('1. 获取通义千问 API Key'));
+  console.log(chalk.white('   访问: ') + chalk.cyan('https://dashscope.console.aliyun.com/'));
+  console.log(chalk.gray('   → 开通服务 → 创建 API Key'));
+  console.log();
+
+  console.log(chalk.yellow.bold('2. 启动代理服务'));
+  console.log(chalk.white('   方式一: 命令行参数'));
+  console.log(chalk.green('   npx @anthropic-ai/qwen-adapter start -k YOUR_API_KEY'));
+  console.log();
+  console.log(chalk.white('   方式二: 环境变量'));
+  console.log(chalk.green('   export QWEN_API_KEY=YOUR_API_KEY'));
+  console.log(chalk.green('   npx @anthropic-ai/qwen-adapter start'));
+  console.log();
+  console.log(chalk.white('   方式三: .env 文件'));
+  console.log(chalk.gray('   在项目根目录创建 .env 文件:'));
+  console.log(chalk.green('   QWEN_API_KEY=YOUR_API_KEY'));
+  console.log();
+
+  console.log(chalk.yellow.bold('3. 配置 Claude Code'));
+  console.log(chalk.white('   编辑 ~/.claude/settings.json:'));
+  console.log();
+  console.log(chalk.cyan('   {'));
+  console.log(chalk.cyan('     "env": {'));
+  console.log(chalk.cyan('       "ANTHROPIC_AUTH_TOKEN": "qwen-key",'));
+  console.log(chalk.cyan('       "ANTHROPIC_BASE_URL": "http://localhost:3000/v1"'));
+  console.log(chalk.cyan('     }'));
+  console.log(chalk.cyan('   }'));
+  console.log();
+
+  console.log(chalk.yellow.bold('4. 重启 Claude Code'));
+  console.log(chalk.green('   claude'));
+  console.log();
+
+  console.log(chalk.yellow.bold('5. 验证配置'));
+  console.log(chalk.white('   在 Claude Code 中运行:'));
+  console.log(chalk.green('   /model'));
+  console.log(chalk.gray('   应该显示 qwen-2.5-max 或你配置的模型'));
+  console.log();
+
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log();
+
+  console.log(chalk.yellow('可用模型:'));
+  console.log(chalk.white('  • qwen-2.5-max     ') + chalk.gray('- 最强模型，推荐'));
+  console.log(chalk.white('  • qwen-2.5-plus    ') + chalk.gray('- 平衡模型'));
+  console.log(chalk.white('  • qwen-2.5-turbo   ') + chalk.gray('- 快速模型'));
+  console.log();
+
+  console.log(chalk.yellow('命令行选项:'));
+  console.log(chalk.white('  -k, --api-key <key>   ') + chalk.gray('API Key'));
+  console.log(chalk.white('  -m, --model <model>   ') + chalk.gray('模型名称 (default: qwen-2.5-max)'));
+  console.log(chalk.white('  -p, --port <port>     ') + chalk.gray('服务端口 (default: 3000)'));
+  console.log(chalk.white('  -h, --host <host>     ') + chalk.gray('服务地址 (default: localhost)'));
+  console.log();
+}

package/src/commands/install.js

@@ -0,0 +1,118 @@
+/**
+ * 安装/配置命令 - 自动配置 Claude Code
+ */
+
+import chalk from 'chalk';
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+
+const CLAUDE_DIR = join(homedir(), '.claude');
+const SETTINGS_FILE = join(CLAUDE_DIR, 'settings.local.json');
+
+export async function install(options) {
+  console.log();
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log(chalk.cyan.bold('           配置 Claude Code 使用 Qwen Adapter'));
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log();
+
+  const port = options.port || '3000';
+  const host = options.host || 'localhost';
+  const baseUrl = `http://${host}:${port}/v1`;
+
+  // 读取现有配置
+  let settings = {};
+  if (existsSync(SETTINGS_FILE)) {
+    try {
+      const content = readFileSync(SETTINGS_FILE, 'utf-8');
+      settings = JSON.parse(content);
+      console.log(chalk.gray('  找到现有配置文件'));
+    } catch (e) {
+      console.log(chalk.yellow('  现有配置文件格式错误，将创建新配置'));
+    }
+  } else {
+    // 确保目录存在
+    if (!existsSync(CLAUDE_DIR)) {
+      mkdirSync(CLAUDE_DIR, { recursive: true });
+      console.log(chalk.gray('  创建配置目录: ~/.claude'));
+    }
+  }
+
+  // 合并配置
+  const newEnv = {
+    ...settings.env,
+    ANTHROPIC_BASE_URL: baseUrl,
+    ANTHROPIC_AUTH_TOKEN: 'qwen-adapter',
+  };
+
+  const newSettings = {
+    ...settings,
+    env: newEnv,
+  };
+
+  // 写入配置
+  writeFileSync(SETTINGS_FILE, JSON.stringify(newSettings, null, 2));
+
+  console.log(chalk.green('  ✓ 配置已更新'));
+  console.log();
+  console.log(chalk.yellow.bold('  配置内容:'));
+  console.log(chalk.white('  文件: ') + chalk.cyan(SETTINGS_FILE));
+  console.log();
+  console.log(chalk.cyan('  {'));
+  console.log(chalk.cyan('    "env": {'));
+  console.log(chalk.cyan('      "ANTHROPIC_BASE_URL": "') + chalk.green(baseUrl) + chalk.cyan('",'));
+  console.log(chalk.cyan('      "ANTHROPIC_AUTH_TOKEN": "qwen-adapter"'));
+  console.log(chalk.cyan('    }'));
+  console.log(chalk.cyan('  }'));
+  console.log();
+  console.log(chalk.yellow.bold('  下一步:'));
+  console.log(chalk.white('  1. 启动 Qwen Adapter:'));
+  console.log(chalk.green('     npx @anthropic-ai/qwen-adapter start'));
+  console.log();
+  console.log(chalk.white('  2. 重启 Claude Code'));
+  console.log();
+  console.log(chalk.white('  3. 验证配置:'));
+  console.log(chalk.green('     /model'));
+  console.log();
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log();
+}
+
+export async function uninstall() {
+  console.log();
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log(chalk.cyan.bold('           移除 Qwen Adapter 配置'));
+  console.log(chalk.cyan.bold('═══════════════════════════════════════════════════════════'));
+  console.log();
+
+  if (!existsSync(SETTINGS_FILE)) {
+    console.log(chalk.yellow('  未找到配置文件'));
+    return;
+  }
+
+  const content = readFileSync(SETTINGS_FILE, 'utf-8');
+  const settings = JSON.parse(content);
+
+  // 移除 Qwen Adapter 相关配置
+  const newEnv = { ...settings.env };
+  delete newEnv.ANTHROPIC_BASE_URL;
+  delete newEnv.ANTHROPIC_AUTH_TOKEN;
+
+  const newSettings = {
+    ...settings,
+    env: Object.keys(newEnv).length > 0 ? newEnv : undefined,
+  };
+
+  if (Object.keys(newEnv).length === 0) {
+    delete newSettings.env;
+  }
+
+  writeFileSync(SETTINGS_FILE, JSON.stringify(newSettings, null, 2));
+
+  console.log(chalk.green('  ✓ 配置已移除'));
+  console.log(chalk.white('  文件: ') + chalk.cyan(SETTINGS_FILE));
+  console.log();
+  console.log(chalk.yellow('  重启 Claude Code 使更改生效'));
+  console.log();
+}

package/src/commands/test.js

@@ -0,0 +1,67 @@
+/**
+ * 测试连接命令
+ */
+
+import chalk from 'chalk';
+
+const QWEN_API = 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions';
+
+export async function testConnection(apiKey) {
+  console.log();
+  console.log(chalk.cyan('测试通义千问 API 连接...'));
+  console.log();
+
+  try {
+    console.log(chalk.white('  → 发送测试请求...'));
+
+    const response = await fetch(QWEN_API, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify({
+        model: process.env.MODEL || 'qwen-max',
+        messages: [{ role: 'user', content: 'Hello, respond with just "OK"' }],
+        max_tokens: 10,
+      }),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      console.log(chalk.red('  ✗ 连接失败'));
+      console.log(chalk.red(`    Status: ${response.status}`));
+      console.log(chalk.red(`    Error: ${errorText}`));
+      console.log();
+      console.log(chalk.yellow('  可能的原因:'));
+      console.log(chalk.gray('    • API Key 无效或已过期'));
+      console.log(chalk.gray('    • 未开通通义千问服务'));
+      console.log(chalk.gray('    • 网络连接问题'));
+      return false;
+    }
+
+    const data = await response.json();
+    const content = data.choices?.[0]?.message?.content || '';
+
+    console.log(chalk.green('  ✓ 连接成功!'));
+    console.log();
+    console.log(chalk.white('  模型响应: ') + chalk.cyan(content));
+    console.log();
+    console.log(chalk.white('  Token 使用:'));
+    console.log(chalk.gray(`    输入: ${data.usage?.prompt_tokens || 0}`));
+    console.log(chalk.gray(`    输出: ${data.usage?.completion_tokens || 0}`));
+    console.log();
+
+    console.log(chalk.green.bold('✓ API Key 有效，可以开始使用!'));
+    return true;
+
+  } catch (error) {
+    console.log(chalk.red('  ✗ 连接失败'));
+    console.log(chalk.red(`    Error: ${error.message}`));
+    console.log();
+    console.log(chalk.yellow('  请检查:'));
+    console.log(chalk.gray('    • 网络连接是否正常'));
+    console.log(chalk.gray('    • API Key 是否正确'));
+    return false;
+  }
+}

package/src/converters/index.js

@@ -0,0 +1,7 @@
+/**
+ * 转换器模块导出
+ */
+
+export { claudeToOpenAI } from './request.js';
+export { openAIToClaude } from './response.js';
+export { StreamConverter, formatSSE } from './stream.js';