open-claude-code-proxy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 lkyxuan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,226 @@
+<div align="center">
+
+# Open Claude Code Proxy
+
+**Route API requests through the official Claude Code client**
+
+[English](#english) | [中文](#中文)
+
+[![npm version](https://img.shields.io/npm/v/open-claude-code-proxy.svg?style=flat-square)](https://www.npmjs.com/package/open-claude-code-proxy)
+[![npm downloads](https://img.shields.io/npm/dm/open-claude-code-proxy.svg?style=flat-square)](https://www.npmjs.com/package/open-claude-code-proxy)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen?style=flat-square)](https://nodejs.org/)
+
+<img src="https://api.star-history.com/svg?repos=lkyxuan/open-claude-code-proxy&type=Date" alt="Star History Chart" width="600">
+
+</div>
+
+---
+
+<a name="english"></a>
+
+## English
+
+### What is this?
+
+A local proxy server that forwards Anthropic API requests through the **official Claude Code CLI**. This allows you to use Claude in any app that supports the Anthropic API (like [OpenCode](https://opencode.ai), Cursor, etc.) while leveraging your existing Claude Code authentication.
+
+### How it works
+
+```
+Your App (OpenCode/Cursor/etc.)
+    ↓ POST /v1/messages
+localhost:12346 (This Proxy)
+    ↓ Spawns `claude --print`
+Claude Code CLI (Official Client)
+    ↓ Uses your login session
+Anthropic API
+```
+
+### Quick Start
+
+#### Option 1: Use npx (Recommended)
+
+```bash
+npx open-claude-code-proxy
+```
+
+#### Option 2: Install globally
+
+```bash
+npm install -g open-claude-code-proxy
+claude-proxy start
+```
+
+#### Option 3: Clone and run
+
+```bash
+git clone https://github.com/lkyxuan/open-claude-code-proxy.git
+cd open-claude-code-proxy
+./claude-proxy start
+```
+
+### Prerequisites
+
+1. **Install Claude Code CLI**
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   ```
+
+2. **Login to Claude Code**
+   ```bash
+   claude auth login
+   ```
+
+3. **Configure Claude Code environment** (if using a relay service)
+   ```bash
+   # Add to ~/.zshrc or ~/.bashrc
+   export ANTHROPIC_BASE_URL="https://your-relay-service.com/v1"
+   export ANTHROPIC_API_KEY="your-api-key"
+   source ~/.zshrc
+   ```
+
+### Configure Your Client
+
+Point your app to the local proxy:
+
+```json
+{
+  "baseURL": "http://localhost:12346",
+  "apiKey": "any-string-works"
+}
+```
+
+> **Note**: The API key can be any string - authentication is handled by your Claude Code session.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `claude-proxy start` | Start the proxy (background) |
+| `claude-proxy stop` | Stop the proxy |
+| `claude-proxy restart` | Restart the proxy |
+| `claude-proxy status` | Check status |
+| `claude-proxy logs -f` | View logs (live) |
+| `claude-proxy test` | Test connectivity |
+
+### API Endpoints
+
+- `GET /health` - Health check
+- `POST /v1/messages` - Messages API (Anthropic-compatible)
+
+---
+
+<a name="中文"></a>
+
+## 中文
+
+### 这是什么？
+
+一个本地代理服务器，将 Anthropic API 请求通过**官方 Claude Code CLI** 转发。这允许你在任何支持 Anthropic API 的应用（如 [OpenCode](https://opencode.ai)、Cursor 等）中使用 Claude，同时利用现有的 Claude Code 登录会话。
+
+### 工作原理
+
+```
+你的应用 (OpenCode/Cursor/等)
+    ↓ POST /v1/messages
+localhost:12346 (本代理)
+    ↓ 调用 `claude --print`
+Claude Code CLI (官方客户端)
+    ↓ 使用你的登录会话
+Anthropic API
+```
+
+### 快速开始
+
+#### 方式 1: 使用 npx（推荐）
+
+```bash
+npx open-claude-code-proxy
+```
+
+#### 方式 2: 全局安装
+
+```bash
+npm install -g open-claude-code-proxy
+claude-proxy start
+```
+
+#### 方式 3: 克隆运行
+
+```bash
+git clone https://github.com/lkyxuan/open-claude-code-proxy.git
+cd open-claude-code-proxy
+./claude-proxy start
+```
+
+### 前置条件
+
+1. **安装 Claude Code CLI**
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   ```
+
+2. **登录 Claude Code**
+   ```bash
+   claude auth login
+   ```
+
+3. **配置 Claude Code 环境变量**（如使用中转服务）
+   ```bash
+   # 添加到 ~/.zshrc 或 ~/.bashrc
+   export ANTHROPIC_BASE_URL="https://your-relay-service.com/v1"
+   export ANTHROPIC_API_KEY="your-api-key"
+   source ~/.zshrc
+   ```
+
+### 配置客户端
+
+将你的应用指向本地代理：
+
+```json
+{
+  "baseURL": "http://localhost:12346",
+  "apiKey": "任意字符串"
+}
+```
+
+> **注意**：API Key 可以是任意字符串，实际认证由 Claude Code 会话处理。
+
+### 命令说明
+
+| 命令 | 说明 |
+|------|------|
+| `claude-proxy start` | 启动服务（后台运行） |
+| `claude-proxy stop` | 停止服务 |
+| `claude-proxy restart` | 重启服务 |
+| `claude-proxy status` | 查看状态 |
+| `claude-proxy logs -f` | 查看日志（实时） |
+| `claude-proxy test` | 测试连接 |
+
+### API 端点
+
+- `GET /health` - 健康检查
+- `POST /v1/messages` - 消息接口（兼容 Anthropic API）
+
+### 常见问题
+
+| 问题 | 解决方案 |
+|------|----------|
+| 提示需要登录 | 运行 `claude auth login` 重新登录 |
+| 连接失败 | 检查环境变量 `echo $ANTHROPIC_BASE_URL` |
+| 端口被占用 | 修改环境变量 `export PORT=12347` |
+
+---
+
+<div align="center">
+
+### Contributing
+
+PRs and issues are welcome!
+
+### License
+
+[MIT](./LICENSE) © 2025
+
+</div>

package/claude-proxy

@@ -0,0 +1,284 @@
+#!/bin/bash
+
+# Claude Local Proxy 控制脚本
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SERVER_JS="$SCRIPT_DIR/server.js"
+PID_FILE="$SCRIPT_DIR/.claude-proxy.pid"
+LOG_FILE="$SCRIPT_DIR/proxy.log"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 打印带颜色的消息
+info() { echo -e "${BLUE}ℹ${NC}  $1"; }
+success() { echo -e "${GREEN}✓${NC}  $1"; }
+warning() { echo -e "${YELLOW}⚠${NC}  $1"; }
+error() { echo -e "${RED}✗${NC}  $1"; }
+
+# 检查服务是否运行
+is_running() {
+    if [ -f "$PID_FILE" ]; then
+        PID=$(cat "$PID_FILE")
+        if ps -p "$PID" > /dev/null 2>&1; then
+            return 0
+        else
+            # PID 文件存在但进程不存在，清理
+            rm -f "$PID_FILE"
+            return 1
+        fi
+    fi
+    return 1
+}
+
+# 检查环境
+check_environment() {
+    info "检查运行环境..."
+
+    # 检查 Node.js
+    if ! command -v node &> /dev/null; then
+        error "Node.js 未安装"
+        echo "请先安装 Node.js: https://nodejs.org/"
+        return 1
+    fi
+    success "Node.js: $(node --version)"
+
+    # 检查 Claude Code
+    if ! command -v claude &> /dev/null; then
+        error "Claude Code 未安装或不在 PATH 中"
+        echo ""
+        echo "安装方式："
+        echo "  1. npm 安装: npm install -g @anthropic-ai/claude-code"
+        echo "  2. 或确保 native 安装的 claude 在 PATH 中"
+        return 1
+    fi
+
+    CLAUDE_PATH=$(which claude)
+    success "Claude Code: $CLAUDE_PATH"
+
+    # 检查环境变量
+    if [ -z "$ANTHROPIC_BASE_URL" ]; then
+        warning "ANTHROPIC_BASE_URL 未设置"
+        echo ""
+        echo "如需使用中转服务，请设置环境变量:"
+        echo "  export ANTHROPIC_BASE_URL=\"https://your-relay-service.com/v1\""
+        echo "  export ANTHROPIC_API_KEY=\"your-api-key\""
+        echo ""
+        echo "然后执行: source ~/.zshrc  # 或 source ~/.bashrc"
+        echo ""
+    else
+        success "ANTHROPIC_BASE_URL: $ANTHROPIC_BASE_URL"
+    fi
+
+    return 0
+}
+
+# 测试 Claude Code 连接
+test_claude() {
+    info "测试 Claude Code 连接..."
+
+    if ! check_environment; then
+        return 1
+    fi
+
+    # 测试简单命令
+    if timeout 10s claude --print "test" &> /dev/null; then
+        success "Claude Code 连接正常"
+        return 0
+    else
+        error "Claude Code 连接失败"
+        echo ""
+        echo "可能的原因："
+        echo "  1. Claude Code 未登录（运行: claude auth login）"
+        echo "  2. 环境变量配置错误"
+        echo "  3. 网络连接问题"
+        return 1
+    fi
+}
+
+# 启动服务
+start() {
+    if is_running; then
+        warning "服务已在运行 (PID: $(cat $PID_FILE))"
+        return 0
+    fi
+
+    info "启动 Claude Local Proxy..."
+
+    # 环境检查
+    if ! check_environment; then
+        error "环境检查失败，无法启动"
+        return 1
+    fi
+
+    # 后台启动
+    nohup node "$SERVER_JS" > "$LOG_FILE" 2>&1 &
+    PID=$!
+    echo $PID > "$PID_FILE"
+
+    # 等待启动
+    sleep 2
+
+    if is_running; then
+        success "服务已启动 (PID: $PID)"
+        success "监听地址: http://localhost:12346"
+        echo ""
+        info "查看日志: $0 logs"
+        info "查看状态: $0 status"
+        return 0
+    else
+        error "服务启动失败"
+        echo ""
+        echo "查看日志获取详细信息:"
+        echo "  tail -f $LOG_FILE"
+        return 1
+    fi
+}
+
+# 停止服务
+stop() {
+    if ! is_running; then
+        warning "服务未运行"
+        return 0
+    fi
+
+    PID=$(cat "$PID_FILE")
+    info "停止服务 (PID: $PID)..."
+
+    kill "$PID" 2>/dev/null
+
+    # 等待进程结束
+    for i in {1..10}; do
+        if ! ps -p "$PID" > /dev/null 2>&1; then
+            break
+        fi
+        sleep 0.5
+    done
+
+    # 强制结束
+    if ps -p "$PID" > /dev/null 2>&1; then
+        warning "强制结束进程..."
+        kill -9 "$PID" 2>/dev/null
+    fi
+
+    rm -f "$PID_FILE"
+    success "服务已停止"
+}
+
+# 重启服务
+restart() {
+    info "重启服务..."
+    stop
+    sleep 1
+    start
+}
+
+# 查看状态
+status() {
+    if is_running; then
+        PID=$(cat "$PID_FILE")
+        success "服务运行中"
+        echo ""
+        echo "  PID:      $PID"
+        echo "  地址:     http://localhost:12346"
+        echo "  日志:     $LOG_FILE"
+        echo ""
+
+        # 显示最近的日志
+        if [ -f "$LOG_FILE" ]; then
+            echo "最近日志:"
+            echo "─────────────────────────────────────"
+            tail -n 5 "$LOG_FILE"
+        fi
+    else
+        warning "服务未运行"
+    fi
+}
+
+# 查看日志
+logs() {
+    if [ ! -f "$LOG_FILE" ]; then
+        warning "日志文件不存在: $LOG_FILE"
+        return 1
+    fi
+
+    if [ "$1" = "-f" ] || [ "$1" = "--follow" ]; then
+        info "实时查看日志 (Ctrl+C 退出)..."
+        tail -f "$LOG_FILE"
+    else
+        cat "$LOG_FILE"
+    fi
+}
+
+# 显示帮助
+help() {
+    cat << EOF
+Claude Local Proxy 控制脚本
+
+用法: $0 <命令> [选项]
+
+命令:
+  start       启动服务
+  stop        停止服务
+  restart     重启服务
+  status      查看运行状态
+  logs        查看日志
+  logs -f     实时查看日志
+  test        测试环境和连接
+  help        显示此帮助信息
+
+示例:
+  $0 start          # 启动服务
+  $0 status         # 查看状态
+  $0 logs -f        # 实时查看日志
+  $0 restart        # 重启服务
+
+配置文件:
+  客户端配置 (opencode/cursor):
+    {
+      "baseURL": "http://localhost:12346",
+      "apiKey": "sk-any-key-works"
+    }
+
+更多信息: https://github.com/your-repo/claude-local-proxy
+EOF
+}
+
+# 主函数
+main() {
+    case "${1:-}" in
+        start)
+            start
+            ;;
+        stop)
+            stop
+            ;;
+        restart)
+            restart
+            ;;
+        status)
+            status
+            ;;
+        logs)
+            logs "${2:-}"
+            ;;
+        test)
+            test_claude
+            ;;
+        help|--help|-h)
+            help
+            ;;
+        *)
+            error "未知命令: ${1:-}"
+            echo ""
+            help
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "open-claude-code-proxy",
+  "version": "1.0.0",
+  "description": "Local proxy that forwards API requests through the official Claude Code CLI",
+  "main": "server.js",
+  "bin": {
+    "open-claude-code-proxy": "server.js",
+    "claude-local-proxy": "claude-proxy"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node server.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lkyxuan/open-claude-code-proxy.git"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "proxy",
+    "api",
+    "opencode",
+    "cursor"
+  ],
+  "author": "lkyxuan",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/lkyxuan/open-claude-code-proxy/issues"
+  },
+  "homepage": "https://github.com/lkyxuan/open-claude-code-proxy#readme",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/server.js

@@ -0,0 +1,478 @@
+#!/usr/bin/env node
+
+const http = require('http');
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const PORT = process.env.PORT || 12346;
+const LOG_FILE = path.join(__dirname, 'proxy.log');
+
+// 日志函数 - 同时输出到控制台和文件
+function log(message, data = null) {
+  const timestamp = new Date().toISOString();
+  let logLine = `[${timestamp}] ${message}`;
+  if (data) {
+    logLine += ' ' + JSON.stringify(data, null, 2);
+  }
+  console.log(logLine);
+  fs.appendFileSync(LOG_FILE, logLine + '\n');
+}
+
+// 启动时清空日志
+fs.writeFileSync(LOG_FILE, `=== Claude Local Proxy 启动于 ${new Date().toISOString()} ===\n`);
+
+// 创建 HTTP 服务器
+const server = http.createServer(async (req, res) => {
+  // CORS 支持
+  res.setHeader('Access-Control-Allow-Origin', '*');
+  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+  res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, anthropic-version, x-api-key');
+
+  if (req.method === 'OPTIONS') {
+    res.writeHead(200);
+    res.end();
+    return;
+  }
+
+  // 健康检查
+  if (req.method === 'GET' && req.url === '/health') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: 'ok', service: 'claude-local-proxy' }));
+    return;
+  }
+
+  // 处理 /messages 和 /v1/messages 请求
+  if (req.method === 'POST' && (req.url === '/v1/messages' || req.url === '/messages')) {
+    let body = '';
+
+    req.on('data', chunk => {
+      body += chunk.toString();
+    });
+
+    req.on('end', async () => {
+      try {
+        // 提取 API Key（支持多种格式）
+        const apiKey = req.headers['x-api-key'] ||
+                      req.headers['authorization']?.replace('Bearer ', '') ||
+                      req.headers['anthropic-api-key'] ||
+                      'anonymous';
+
+        const requestData = JSON.parse(body);
+
+        // 限制日志大小，保留最近的请求（超过 100KB 截断）
+        try {
+          const stats = fs.statSync(LOG_FILE);
+          if (stats.size > 100 * 1024) {
+            const content = fs.readFileSync(LOG_FILE, 'utf8');
+            // 保留最后 50KB
+            fs.writeFileSync(LOG_FILE, content.slice(-50 * 1024));
+          }
+        } catch (e) { /* 文件不存在时忽略 */ }
+
+        // 详细记录请求信息（用于调试）
+        log('========== 收到请求 ==========');
+        log('1️⃣ User-Agent', {
+          'user-agent': req.headers['user-agent']
+        });
+        log('2️⃣ 必需 Headers', {
+          'x-app': req.headers['x-app'],
+          'anthropic-beta': req.headers['anthropic-beta'],
+          'anthropic-version': req.headers['anthropic-version']
+        });
+        log('3️⃣ Stainless SDK Headers', {
+          'x-stainless-retry-count': req.headers['x-stainless-retry-count'],
+          'x-stainless-timeout': req.headers['x-stainless-timeout'],
+          'x-stainless-lang': req.headers['x-stainless-lang'],
+          'x-stainless-package-version': req.headers['x-stainless-package-version'],
+          'x-stainless-os': req.headers['x-stainless-os'],
+          'x-stainless-arch': req.headers['x-stainless-arch'],
+          'x-stainless-runtime': req.headers['x-stainless-runtime'],
+          'x-stainless-runtime-version': req.headers['x-stainless-runtime-version'],
+          'anthropic-dangerous-direct-browser-access': req.headers['anthropic-dangerous-direct-browser-access']
+        });
+        log('4️⃣ Body metadata', {
+          metadata: requestData.metadata,
+          user_id_in_metadata: requestData.metadata?.user_id
+        });
+        log('5️⃣ System Prompt', {
+          system: typeof requestData.system === 'string'
+            ? requestData.system.substring(0, 200) + '...'
+            : requestData.system || 'none'
+        });
+        log('6️⃣ 用户消息', {
+          messages: requestData.messages?.map(m => ({
+            role: m.role,
+            content: typeof m.content === 'string'
+              ? m.content.substring(0, 300)
+              : Array.isArray(m.content)
+                ? m.content.map(c => c.type === 'text' ? c.text?.substring(0, 300) : `[${c.type}]`).join(' ')
+                : '[complex]'
+          }))
+        });
+        log('其他信息', {
+          apiKey: apiKey.substring(0, 20) + '...',
+          model: requestData.model,
+          messagesCount: requestData.messages?.length,
+          stream: requestData.stream
+        });
+        log('================================');
+
+        // 检查是否需要流式响应
+        const isStream = requestData.stream === true;
+
+        if (isStream) {
+          await handleStreamRequest(requestData, res);
+        } else {
+          await handleNormalRequest(requestData, res);
+        }
+      } catch (error) {
+        console.error('[错误]', error);
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: { message: error.message } }));
+      }
+    });
+  } else {
+    // 记录未知请求，方便调试
+    console.log(`[${new Date().toISOString()}] 未处理的请求: ${req.method} ${req.url}`);
+    res.writeHead(404, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: { message: 'Not Found' } }));
+  }
+});
+
+// 处理普通请求（非流式）
+async function handleNormalRequest(requestData, res) {
+  const messages = requestData.messages || [];
+
+  // 构建 prompt：把 messages 数组转成对话格式
+  const prompt = buildPromptFromMessages(messages);
+
+  return new Promise((resolve, reject) => {
+    // 使用 JSON 输出格式，支持 tool_use
+    const claude = spawn('claude', [
+      '--print',
+      '--output-format', 'json',
+      prompt
+    ], {
+      env: { ...process.env },
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+
+    let output = '';
+    let errorOutput = '';
+
+    claude.stdout.on('data', (data) => {
+      output += data.toString();
+    });
+
+    claude.stderr.on('data', (data) => {
+      errorOutput += data.toString();
+    });
+
+    claude.on('close', (code) => {
+      if (code !== 0) {
+        console.error('[Claude 错误]', errorOutput);
+      }
+
+      try {
+        // 解析 Claude 的 JSON 输出
+        const claudeResponse = JSON.parse(output.trim());
+
+        // 构建 Anthropic API 格式的响应
+        const response = {
+          id: claudeResponse.id || `msg_${Date.now()}`,
+          type: 'message',
+          role: 'assistant',
+          content: claudeResponse.content || [{ type: 'text', text: output.trim() }],
+          model: requestData.model || 'claude-sonnet-4-20250514',
+          stop_reason: claudeResponse.stop_reason || 'end_turn',
+          stop_sequence: claudeResponse.stop_sequence || null,
+          usage: claudeResponse.usage || {
+            input_tokens: 0,
+            output_tokens: 0
+          }
+        };
+
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(response));
+        resolve();
+      } catch (parseError) {
+        // 如果 JSON 解析失败，fallback 到纯文本模式
+        console.error('[JSON 解析错误]', parseError);
+
+        const response = {
+          id: `msg_${Date.now()}`,
+          type: 'message',
+          role: 'assistant',
+          content: [{ type: 'text', text: output.trim() }],
+          model: requestData.model || 'claude-sonnet-4-20250514',
+          stop_reason: 'end_turn',
+          stop_sequence: null,
+          usage: {
+            input_tokens: 0,
+            output_tokens: 0
+          }
+        };
+
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(response));
+        resolve();
+      }
+    });
+
+    claude.on('error', (error) => {
+      console.error('[Spawn 错误]', error);
+      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: { message: error.message } }));
+      reject(error);
+    });
+  });
+}
+
+// 处理流式请求
+async function handleStreamRequest(requestData, res) {
+  const messages = requestData.messages || [];
+
+  // 使用 stream-json 格式与 Claude Code 交互
+  return new Promise((resolve, reject) => {
+    const claude = spawn('claude', [
+      '--print',
+      '--input-format', 'stream-json',
+      '--output-format', 'stream-json',
+      '--verbose'
+    ], {
+      env: { ...process.env },
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+
+    // 设置 SSE 响应头
+    res.writeHead(200, {
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache',
+      'Connection': 'keep-alive'
+    });
+
+    // 发送消息开始事件
+    const messageId = `msg_${Date.now()}`;
+    sendSSE(res, 'message_start', {
+      type: 'message_start',
+      message: {
+        id: messageId,
+        type: 'message',
+        role: 'assistant',
+        content: [],
+        model: requestData.model || 'claude-sonnet-4-20250514',
+        stop_reason: null,
+        stop_sequence: null,
+        usage: { input_tokens: 0, output_tokens: 0 }
+      }
+    });
+
+    // 发送 content block 开始
+    sendSSE(res, 'content_block_start', {
+      type: 'content_block_start',
+      index: 0,
+      content_block: { type: 'text', text: '' }
+    });
+
+    let buffer = '';
+    let fullText = '';
+    let contentBlockIndex = 0;
+    let currentBlockType = null;
+
+    claude.stdout.on('data', (data) => {
+      buffer += data.toString();
+
+      // 解析 JSON 行
+      const lines = buffer.split('\n');
+      buffer = lines.pop() || ''; // 保留不完整的行
+
+      for (const line of lines) {
+        if (!line.trim()) continue;
+
+        try {
+          const json = JSON.parse(line);
+
+          if (json.type === 'assistant' && json.message?.content) {
+            for (const content of json.message.content) {
+              // 处理文本内容
+              if (content.type === 'text' && content.text) {
+                // 增量发送文本
+                const newText = content.text.slice(fullText.length);
+                if (newText) {
+                  fullText = content.text;
+                  sendSSE(res, 'content_block_delta', {
+                    type: 'content_block_delta',
+                    index: 0,
+                    delta: { type: 'text_delta', text: newText }
+                  });
+                }
+              }
+
+              // 处理工具调用
+              if (content.type === 'tool_use') {
+                // 发送前一个 block 结束（如果有）
+                if (currentBlockType) {
+                  sendSSE(res, 'content_block_stop', {
+                    type: 'content_block_stop',
+                    index: contentBlockIndex
+                  });
+                  contentBlockIndex++;
+                }
+
+                // 发送新的 tool_use block 开始
+                sendSSE(res, 'content_block_start', {
+                  type: 'content_block_start',
+                  index: contentBlockIndex,
+                  content_block: {
+                    type: 'tool_use',
+                    id: content.id,
+                    name: content.name,
+                    input: {}
+                  }
+                });
+
+                // 发送工具输入
+                sendSSE(res, 'content_block_delta', {
+                  type: 'content_block_delta',
+                  index: contentBlockIndex,
+                  delta: {
+                    type: 'input_json_delta',
+                    partial_json: JSON.stringify(content.input)
+                  }
+                });
+
+                currentBlockType = 'tool_use';
+              }
+            }
+          }
+        } catch (e) {
+          // 忽略解析错误
+        }
+      }
+    });
+
+    claude.stderr.on('data', (data) => {
+      console.error('[Claude stderr]', data.toString());
+    });
+
+    claude.on('close', (code) => {
+      // 发送结束事件
+      sendSSE(res, 'content_block_stop', {
+        type: 'content_block_stop',
+        index: 0
+      });
+
+      sendSSE(res, 'message_delta', {
+        type: 'message_delta',
+        delta: { stop_reason: 'end_turn', stop_sequence: null },
+        usage: { output_tokens: 0 }
+      });
+
+      sendSSE(res, 'message_stop', { type: 'message_stop' });
+
+      res.end();
+      resolve();
+    });
+
+    claude.on('error', (error) => {
+      console.error('[Spawn 错误]', error);
+      res.end();
+      reject(error);
+    });
+
+    // 发送用户消息给 Claude
+    const lastUserMessage = messages.filter(m => m.role === 'user').pop();
+    if (lastUserMessage) {
+      const input = JSON.stringify({
+        type: 'user',
+        message: lastUserMessage
+      }) + '\n';
+
+      claude.stdin.write(input);
+      claude.stdin.end();
+    } else {
+      claude.stdin.end();
+    }
+  });
+}
+
+// 把 messages 数组转成对话格式的 prompt
+function buildPromptFromMessages(messages) {
+  if (!messages || messages.length === 0) {
+    return '';
+  }
+
+  // 如果只有一条消息，直接返回内容
+  if (messages.length === 1) {
+    return getMessageContent(messages[0]);
+  }
+
+  // 多条消息，构建对话上下文
+  let prompt = '以下是之前的对话历史：\n\n';
+
+  for (let i = 0; i < messages.length - 1; i++) {
+    const msg = messages[i];
+    const role = msg.role === 'user' ? 'User' : 'Assistant';
+    prompt += `${role}: ${getMessageContent(msg)}\n\n`;
+  }
+
+  // 最后一条消息作为当前请求
+  const lastMessage = messages[messages.length - 1];
+  prompt += `\n请基于上述对话历史，回复以下消息：\n\n${getMessageContent(lastMessage)}`;
+
+  return prompt;
+}
+
+// 获取消息内容（支持 string 和 array 格式）
+function getMessageContent(message) {
+  if (typeof message.content === 'string') {
+    return message.content;
+  }
+
+  if (Array.isArray(message.content)) {
+    return message.content
+      .filter(c => c.type === 'text')
+      .map(c => c.text)
+      .join('\n');
+  }
+
+  return '';
+}
+
+// 发送 SSE 事件
+function sendSSE(res, event, data) {
+  res.write(`event: ${event}\n`);
+  res.write(`data: ${JSON.stringify(data)}\n\n`);
+}
+
+// 启动服务器
+server.listen(PORT, () => {
+  console.log(`
+╔════════════════════════════════════════════════╗
+║       Claude Local Proxy 已启动                 ║
+╠════════════════════════════════════════════════╣
+║  监听地址: http://localhost:${PORT}              ║
+║  API 端点: http://localhost:${PORT}/v1/messages  ║
+╠════════════════════════════════════════════════╣
+║  配置说明:                                      ║
+║  • baseURL: "http://localhost:${PORT}"          ║
+║  • API Key: 任意字符串（不验证）                 ║
+║                                                 ║
+║  示例配置 (opencode/cursor):                    ║
+║  {                                              ║
+║    "baseURL": "http://localhost:${PORT}",       ║
+║    "apiKey": "sk-any-key-works"                 ║
+║  }                                              ║
+╚════════════════════════════════════════════════╝
+  `);
+});
+
+// 优雅退出
+process.on('SIGINT', () => {
+  console.log('\n正在关闭服务...');
+  server.close(() => {
+    console.log('服务已关闭');
+    process.exit(0);
+  });
+});

package/start.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+# Claude Local Proxy 启动脚本
+
+cd "$(dirname "$0")"
+
+# 检查 Claude Code 是否安装
+# 直接测试 claude 命令是否可用（支持 npm 和 native 安装）
+if ! claude --help &> /dev/null; then
+    echo "❌ 错误: Claude Code 未安装或不在 PATH 中"
+    echo ""
+    echo "安装方式："
+    echo "  1. npm 安装: npm install -g @anthropic-ai/claude-code"
+    echo "  2. 或确保 native 安装的 claude 在 PATH 中"
+    echo ""
+    echo "提示: 如果已安装但找不到，请检查 PATH 环境变量"
+    exit 1
+fi
+
+# 显示找到的 claude 路径
+CLAUDE_PATH=$(which claude 2>/dev/null || command -v claude 2>/dev/null || echo "claude")
+echo "✓ 找到 Claude Code: $CLAUDE_PATH"
+
+# 检查 Claude Code 环境变量
+if [ -z "$ANTHROPIC_BASE_URL" ]; then
+    echo "⚠️  提示: ANTHROPIC_BASE_URL 未设置"
+    echo "如需使用中转服务，请先设置环境变量:"
+    echo "  export ANTHROPIC_BASE_URL=\"https://your-relay-service.com/v1\""
+    echo "  export ANTHROPIC_API_KEY=\"your-api-key\""
+    echo ""
+fi
+
+echo "🚀 启动 Claude Local Proxy..."
+node server.js