claude-code-relay 0.0.4 → 0.0.8

package/README.md

@@ -0,0 +1,199 @@
+# claude-code-relay
+
+Local proxy that exposes Claude CLI as an OpenAI-compatible API server.
+
+Use your existing Claude CLI installation with any OpenAI-compatible client.
+
+## Why?
+
+- You already have Claude CLI working with your subscription
+- You want to use tools that expect OpenAI API format
+- No separate API key needed - uses your local Claude CLI
+
+## Installation
+
+### Node.js / Bun
+
+```bash
+npx claude-code-relay serve
+# or
+bunx claude-code-relay serve
+# or install globally
+npm install -g claude-code-relay
+```
+
+### Python
+
+```bash
+pip install claude-code-relay
+```
+
+## Usage
+
+### Start the server
+
+```bash
+# Node
+npx claude-code-relay serve --port 52014
+
+# Python
+claude-code-relay serve --port 52014
+```
+
+### Use with OpenAI SDK
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="http://localhost:52014/v1",
+    api_key="not-needed"
+)
+
+response = client.chat.completions.create(
+    model="sonnet",  # or "opus", "haiku"
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+print(response.choices[0].message.content)
+```
+
+```typescript
+import OpenAI from "openai";
+
+const client = new OpenAI({
+  baseURL: "http://localhost:52014/v1",
+  apiKey: "not-needed",
+});
+
+const response = await client.chat.completions.create({
+  model: "sonnet",
+  messages: [{ role: "user", content: "Hello!" }],
+});
+```
+
+### Use with LiteLLM
+
+```python
+from litellm import completion
+
+response = completion(
+    model="openai/sonnet",
+    api_base="http://localhost:52014/v1",
+    api_key="not-needed",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Use with Vercel AI SDK
+
+```typescript
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { generateText } from "ai";
+
+const claude = createOpenAICompatible({
+  name: "claude-code-relay",
+  baseURL: "http://localhost:52014/v1",
+  apiKey: "not-needed",
+});
+
+const { text } = await generateText({
+  model: claude.chatModel("sonnet"),
+  prompt: "Hello!",
+});
+```
+
+## API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/v1/chat/completions` | POST | Chat completions (streaming supported) |
+| `/v1/models` | GET | List available models |
+| `/health` | GET | Health check |
+
+## OpenAI API Compatibility
+
+### Supported Features
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| `model` | Supported | `sonnet`, `opus`, `haiku` (+ aliases below) |
+| `messages` | Supported | `system`, `user`, `assistant` roles |
+| `stream` | Supported | SSE streaming |
+| System prompts | Supported | Via `system` role in messages |
+
+### Model Aliases
+
+These model names are normalized to Claude CLI format:
+
+| Input | Maps to |
+|-------|---------|
+| `sonnet` | `sonnet` |
+| `opus` | `opus` |
+| `haiku` | `haiku` |
+| `claude-3-sonnet` | `sonnet` |
+| `claude-3-opus` | `opus` |
+| `claude-3-haiku` | `haiku` |
+| `claude-sonnet-4` | `sonnet` |
+| `claude-opus-4` | `opus` |
+
+### Not Supported
+
+These parameters are accepted but **ignored** (not passed to Claude CLI):
+
+| Parameter | Status |
+|-----------|--------|
+| `temperature` | Ignored |
+| `max_tokens` | Ignored |
+| `top_p` | Ignored |
+| `stop` | Ignored |
+| `n` | Not supported |
+| `presence_penalty` | Not supported |
+| `frequency_penalty` | Not supported |
+| `logit_bias` | Not supported |
+| `response_format` | Not supported |
+| `tools` / `functions` | Not supported |
+| `tool_choice` | Not supported |
+| `seed` | Not supported |
+| `logprobs` | Not supported |
+| `user` | Not supported |
+
+### Response Limitations
+
+- `usage` tokens are always `0` (not tracked by Claude CLI)
+- `finish_reason` is always `"stop"` (no length/tool_calls detection)
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CLAUDE_CODE_RELAY_PORT` | `52014` | Server port (Python only) |
+| `CLAUDE_CODE_RELAY_HOST` | `127.0.0.1` | Host to bind (Python only) |
+| `CLAUDE_CLI_PATH` | `claude` | Path to Claude CLI binary |
+| `CLAUDE_CODE_RELAY_TIMEOUT` | `300` | Request timeout in seconds |
+| `CLAUDE_CODE_RELAY_VERBOSE` | `false` | Enable verbose logging (`1` or `true`) |
+
+### CLI Options
+
+```
+claude-code-relay serve [options]
+
+Options:
+  --port, -p <port>      Server port (default: 52014)
+  --host <host>          Host to bind (default: 127.0.0.1)
+  --claude-path <path>   Path to Claude CLI
+  --timeout <seconds>    Request timeout (default: 300)
+  --verbose, -v          Enable verbose logging
+```
+
+## Requirements
+
+- Claude CLI installed and authenticated
+- Python 3.10+ or Node.js 18+
+
+## License
+
+MIT - see [LICENSE](LICENSE)
+
+**Disclaimer**: Unofficial community project. Users are responsible for compliance with Anthropic's Terms of Service.

package/dist/cjs/cli-wrapper.js

@@ -110,8 +110,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -125,6 +127,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -145,18 +151,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -164,12 +182,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {

package/dist/cjs/cli.js

@@ -99,8 +99,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -114,6 +116,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -134,18 +140,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -153,12 +171,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {
@@ -171,6 +198,13 @@ var ClaudeCLI = class {
 };
 
 // src/server.ts
+var _verbose = false;
+function log(...args) {
+  if (_verbose) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    console.log(`[${timestamp}]`, ...args);
+  }
+}
 var _cli = null;
 function sendJson(res, data, status = 200) {
   const body = JSON.stringify(data);
@@ -241,6 +275,9 @@ async function handleRequest(req, res) {
     }
     const chatId = generateId("chatcmpl");
     const created = Math.floor(Date.now() / 1e3);
+    const msgCount = request.messages?.length ?? 0;
+    const lastMsg = request.messages?.[msgCount - 1]?.content?.slice(0, 30) ?? "";
+    log(`\u2192 POST /v1/chat/completions model=${request.model} stream=${!!request.stream} msgs=${msgCount} "${lastMsg}${lastMsg.length >= 30 ? "..." : ""}"`);
     if (request.stream) {
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -257,8 +294,10 @@ async function handleRequest(req, res) {
         choices: [{ index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }]
       };
       sendSSEChunk(res, JSON.stringify(initial));
+      let totalLen = 0;
       try {
         for await (const text of _cli.stream(request.messages, request.model)) {
+          totalLen += text.length;
           const chunk = {
             id: chatId,
             object: "chat.completion.chunk",
@@ -268,7 +307,9 @@ async function handleRequest(req, res) {
           };
           sendSSEChunk(res, JSON.stringify(chunk));
         }
+        log(`\u2190 stream complete, total length=${totalLen}`);
       } catch (err) {
+        log(`\u2190 stream error: ${err}`);
         sendSSEChunk(res, JSON.stringify({ error: { message: String(err), type: "server_error" } }));
       }
       const final = {
@@ -285,6 +326,7 @@ async function handleRequest(req, res) {
     }
     try {
       const content = await _cli.complete(request.messages, request.model);
+      log(`\u2190 response complete, length=${content.length}`);
       const response = {
         id: chatId,
         object: "chat.completion",
@@ -295,6 +337,7 @@ async function handleRequest(req, res) {
       };
       sendJson(res, response);
     } catch (err) {
+      log(`\u2190 error: ${err}`);
       sendError(res, String(err));
     }
     return;
@@ -302,8 +345,9 @@ async function handleRequest(req, res) {
   sendError(res, "Not found", 404);
 }
 function createApp(config) {
+  _verbose = config?.verbose ?? process.env.CLAUDE_CODE_RELAY_VERBOSE === "1";
   try {
-    _cli = new ClaudeCLI(config?.cli);
+    _cli = new ClaudeCLI({ ...config?.cli, verbose: _verbose });
   } catch (err) {
     console.error(`Failed to initialize Claude CLI: ${err}`);
     _cli = null;
@@ -376,11 +420,13 @@ if (command === "serve") {
   console.log(`  Port: ${port}`);
   console.log(`  Claude CLI: ${claudePath}`);
   console.log(`  Timeout: ${timeout}s`);
+  console.log(`  Verbose: ${verbose}`);
   console.log();
   console.log(`API endpoint: http://${host}:${port}/v1/chat/completions`);
   console.log();
   runServer(host, port, {
-    cli: { cliPath: claudePath, timeout, verbose }
+    cli: { cliPath: claudePath, timeout, verbose },
+    verbose
   });
 } else if (command === "check") {
   console.log("Checking Claude CLI...");

package/dist/cjs/index.js

@@ -121,8 +121,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -136,6 +138,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -156,18 +162,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -175,12 +193,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {
@@ -193,6 +220,13 @@ var ClaudeCLI = class {
 };
 
 // src/server.ts
+var _verbose = false;
+function log(...args) {
+  if (_verbose) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    console.log(`[${timestamp}]`, ...args);
+  }
+}
 var _cli = null;
 function sendJson(res, data, status = 200) {
   const body = JSON.stringify(data);
@@ -263,6 +297,9 @@ async function handleRequest(req, res) {
     }
     const chatId = generateId("chatcmpl");
     const created = Math.floor(Date.now() / 1e3);
+    const msgCount = request.messages?.length ?? 0;
+    const lastMsg = request.messages?.[msgCount - 1]?.content?.slice(0, 30) ?? "";
+    log(`\u2192 POST /v1/chat/completions model=${request.model} stream=${!!request.stream} msgs=${msgCount} "${lastMsg}${lastMsg.length >= 30 ? "..." : ""}"`);
     if (request.stream) {
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -279,8 +316,10 @@ async function handleRequest(req, res) {
         choices: [{ index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }]
       };
       sendSSEChunk(res, JSON.stringify(initial));
+      let totalLen = 0;
       try {
         for await (const text of _cli.stream(request.messages, request.model)) {
+          totalLen += text.length;
           const chunk = {
             id: chatId,
             object: "chat.completion.chunk",
@@ -290,7 +329,9 @@ async function handleRequest(req, res) {
           };
           sendSSEChunk(res, JSON.stringify(chunk));
         }
+        log(`\u2190 stream complete, total length=${totalLen}`);
       } catch (err) {
+        log(`\u2190 stream error: ${err}`);
         sendSSEChunk(res, JSON.stringify({ error: { message: String(err), type: "server_error" } }));
       }
       const final = {
@@ -307,6 +348,7 @@ async function handleRequest(req, res) {
     }
     try {
       const content = await _cli.complete(request.messages, request.model);
+      log(`\u2190 response complete, length=${content.length}`);
       const response = {
         id: chatId,
         object: "chat.completion",
@@ -317,6 +359,7 @@ async function handleRequest(req, res) {
       };
       sendJson(res, response);
     } catch (err) {
+      log(`\u2190 error: ${err}`);
       sendError(res, String(err));
     }
     return;
@@ -324,8 +367,9 @@ async function handleRequest(req, res) {
   sendError(res, "Not found", 404);
 }
 function createApp(config) {
+  _verbose = config?.verbose ?? process.env.CLAUDE_CODE_RELAY_VERBOSE === "1";
   try {
-    _cli = new ClaudeCLI(config?.cli);
+    _cli = new ClaudeCLI({ ...config?.cli, verbose: _verbose });
   } catch (err) {
     console.error(`Failed to initialize Claude CLI: ${err}`);
     _cli = null;

package/dist/cjs/server.js

@@ -118,8 +118,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -133,6 +135,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -153,18 +159,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = (0, import_node_child_process2.spawn)(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -172,12 +190,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {
@@ -190,6 +217,13 @@ var ClaudeCLI = class {
 };
 
 // src/server.ts
+var _verbose = false;
+function log(...args) {
+  if (_verbose) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    console.log(`[${timestamp}]`, ...args);
+  }
+}
 var _cli = null;
 function sendJson(res, data, status = 200) {
   const body = JSON.stringify(data);
@@ -260,6 +294,9 @@ async function handleRequest(req, res) {
     }
     const chatId = generateId("chatcmpl");
     const created = Math.floor(Date.now() / 1e3);
+    const msgCount = request.messages?.length ?? 0;
+    const lastMsg = request.messages?.[msgCount - 1]?.content?.slice(0, 30) ?? "";
+    log(`\u2192 POST /v1/chat/completions model=${request.model} stream=${!!request.stream} msgs=${msgCount} "${lastMsg}${lastMsg.length >= 30 ? "..." : ""}"`);
     if (request.stream) {
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -276,8 +313,10 @@ async function handleRequest(req, res) {
         choices: [{ index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }]
       };
       sendSSEChunk(res, JSON.stringify(initial));
+      let totalLen = 0;
       try {
         for await (const text of _cli.stream(request.messages, request.model)) {
+          totalLen += text.length;
           const chunk = {
             id: chatId,
             object: "chat.completion.chunk",
@@ -287,7 +326,9 @@ async function handleRequest(req, res) {
           };
           sendSSEChunk(res, JSON.stringify(chunk));
         }
+        log(`\u2190 stream complete, total length=${totalLen}`);
       } catch (err) {
+        log(`\u2190 stream error: ${err}`);
         sendSSEChunk(res, JSON.stringify({ error: { message: String(err), type: "server_error" } }));
       }
       const final = {
@@ -304,6 +345,7 @@ async function handleRequest(req, res) {
     }
     try {
       const content = await _cli.complete(request.messages, request.model);
+      log(`\u2190 response complete, length=${content.length}`);
       const response = {
         id: chatId,
         object: "chat.completion",
@@ -314,6 +356,7 @@ async function handleRequest(req, res) {
       };
       sendJson(res, response);
     } catch (err) {
+      log(`\u2190 error: ${err}`);
       sendError(res, String(err));
     }
     return;
@@ -321,8 +364,9 @@ async function handleRequest(req, res) {
   sendError(res, "Not found", 404);
 }
 function createApp(config) {
+  _verbose = config?.verbose ?? process.env.CLAUDE_CODE_RELAY_VERBOSE === "1";
   try {
-    _cli = new ClaudeCLI(config?.cli);
+    _cli = new ClaudeCLI({ ...config?.cli, verbose: _verbose });
   } catch (err) {
     console.error(`Failed to initialize Claude CLI: ${err}`);
     _cli = null;

package/dist/esm/cli-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-wrapper.d.ts","sourceRoot":"","sources":["../../src/cli-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAUvC,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IA4Bb,QAAQ,CACZ,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,SAAW,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAkDX,MAAM,CACX,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,SAAW,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;CAiDzC"}
+{"version":3,"file":"cli-wrapper.d.ts","sourceRoot":"","sources":["../../src/cli-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAUvC,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IA4Bb,QAAQ,CACZ,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,SAAW,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAwDX,MAAM,CACX,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,SAAW,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;CAyEzC"}

package/dist/esm/cli-wrapper.js

@@ -86,8 +86,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = spawn(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -101,6 +103,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -121,18 +127,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = spawn(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -140,12 +158,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {

package/dist/esm/cli.js

@@ -98,8 +98,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = spawn(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -113,6 +115,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -133,18 +139,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = spawn(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -152,12 +170,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {
@@ -170,6 +197,13 @@ var ClaudeCLI = class {
 };
 
 // src/server.ts
+var _verbose = false;
+function log(...args) {
+  if (_verbose) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    console.log(`[${timestamp}]`, ...args);
+  }
+}
 var _cli = null;
 function sendJson(res, data, status = 200) {
   const body = JSON.stringify(data);
@@ -240,6 +274,9 @@ async function handleRequest(req, res) {
     }
     const chatId = generateId("chatcmpl");
     const created = Math.floor(Date.now() / 1e3);
+    const msgCount = request.messages?.length ?? 0;
+    const lastMsg = request.messages?.[msgCount - 1]?.content?.slice(0, 30) ?? "";
+    log(`\u2192 POST /v1/chat/completions model=${request.model} stream=${!!request.stream} msgs=${msgCount} "${lastMsg}${lastMsg.length >= 30 ? "..." : ""}"`);
     if (request.stream) {
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -256,8 +293,10 @@ async function handleRequest(req, res) {
         choices: [{ index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }]
       };
       sendSSEChunk(res, JSON.stringify(initial));
+      let totalLen = 0;
       try {
         for await (const text of _cli.stream(request.messages, request.model)) {
+          totalLen += text.length;
           const chunk = {
             id: chatId,
             object: "chat.completion.chunk",
@@ -267,7 +306,9 @@ async function handleRequest(req, res) {
           };
           sendSSEChunk(res, JSON.stringify(chunk));
         }
+        log(`\u2190 stream complete, total length=${totalLen}`);
       } catch (err) {
+        log(`\u2190 stream error: ${err}`);
         sendSSEChunk(res, JSON.stringify({ error: { message: String(err), type: "server_error" } }));
       }
       const final = {
@@ -284,6 +325,7 @@ async function handleRequest(req, res) {
     }
     try {
       const content = await _cli.complete(request.messages, request.model);
+      log(`\u2190 response complete, length=${content.length}`);
       const response = {
         id: chatId,
         object: "chat.completion",
@@ -294,6 +336,7 @@ async function handleRequest(req, res) {
       };
       sendJson(res, response);
     } catch (err) {
+      log(`\u2190 error: ${err}`);
       sendError(res, String(err));
     }
     return;
@@ -301,8 +344,9 @@ async function handleRequest(req, res) {
   sendError(res, "Not found", 404);
 }
 function createApp(config) {
+  _verbose = config?.verbose ?? process.env.CLAUDE_CODE_RELAY_VERBOSE === "1";
   try {
-    _cli = new ClaudeCLI(config?.cli);
+    _cli = new ClaudeCLI({ ...config?.cli, verbose: _verbose });
   } catch (err) {
     console.error(`Failed to initialize Claude CLI: ${err}`);
     _cli = null;
@@ -375,11 +419,13 @@ if (command === "serve") {
   console.log(`  Port: ${port}`);
   console.log(`  Claude CLI: ${claudePath}`);
   console.log(`  Timeout: ${timeout}s`);
+  console.log(`  Verbose: ${verbose}`);
   console.log();
   console.log(`API endpoint: http://${host}:${port}/v1/chat/completions`);
   console.log();
   runServer(host, port, {
-    cli: { cliPath: claudePath, timeout, verbose }
+    cli: { cliPath: claudePath, timeout, verbose },
+    verbose
   });
 } else if (command === "check") {
   console.log("Checking Claude CLI...");

package/dist/esm/index.js

@@ -93,8 +93,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = spawn(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -108,6 +110,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -128,18 +134,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = spawn(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -147,12 +165,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {
@@ -165,6 +192,13 @@ var ClaudeCLI = class {
 };
 
 // src/server.ts
+var _verbose = false;
+function log(...args) {
+  if (_verbose) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    console.log(`[${timestamp}]`, ...args);
+  }
+}
 var _cli = null;
 function sendJson(res, data, status = 200) {
   const body = JSON.stringify(data);
@@ -235,6 +269,9 @@ async function handleRequest(req, res) {
     }
     const chatId = generateId("chatcmpl");
     const created = Math.floor(Date.now() / 1e3);
+    const msgCount = request.messages?.length ?? 0;
+    const lastMsg = request.messages?.[msgCount - 1]?.content?.slice(0, 30) ?? "";
+    log(`\u2192 POST /v1/chat/completions model=${request.model} stream=${!!request.stream} msgs=${msgCount} "${lastMsg}${lastMsg.length >= 30 ? "..." : ""}"`);
     if (request.stream) {
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -251,8 +288,10 @@ async function handleRequest(req, res) {
         choices: [{ index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }]
       };
       sendSSEChunk(res, JSON.stringify(initial));
+      let totalLen = 0;
       try {
         for await (const text of _cli.stream(request.messages, request.model)) {
+          totalLen += text.length;
           const chunk = {
             id: chatId,
             object: "chat.completion.chunk",
@@ -262,7 +301,9 @@ async function handleRequest(req, res) {
           };
           sendSSEChunk(res, JSON.stringify(chunk));
         }
+        log(`\u2190 stream complete, total length=${totalLen}`);
       } catch (err) {
+        log(`\u2190 stream error: ${err}`);
         sendSSEChunk(res, JSON.stringify({ error: { message: String(err), type: "server_error" } }));
       }
       const final = {
@@ -279,6 +320,7 @@ async function handleRequest(req, res) {
     }
     try {
       const content = await _cli.complete(request.messages, request.model);
+      log(`\u2190 response complete, length=${content.length}`);
       const response = {
         id: chatId,
         object: "chat.completion",
@@ -289,6 +331,7 @@ async function handleRequest(req, res) {
       };
       sendJson(res, response);
     } catch (err) {
+      log(`\u2190 error: ${err}`);
       sendError(res, String(err));
     }
     return;
@@ -296,8 +339,9 @@ async function handleRequest(req, res) {
   sendError(res, "Not found", 404);
 }
 function createApp(config) {
+  _verbose = config?.verbose ?? process.env.CLAUDE_CODE_RELAY_VERBOSE === "1";
   try {
-    _cli = new ClaudeCLI(config?.cli);
+    _cli = new ClaudeCLI({ ...config?.cli, verbose: _verbose });
   } catch (err) {
     console.error(`Failed to initialize Claude CLI: ${err}`);
     _cli = null;

package/dist/esm/server.d.ts

@@ -5,6 +5,7 @@ import { IncomingMessage, ServerResponse } from "node:http";
 import { type CLIConfig } from "./cli-wrapper.js";
 export interface AppConfig {
     cli?: Partial<CLIConfig>;
+    verbose?: boolean;
 }
 export declare function createApp(config?: AppConfig): import("node:http").Server<typeof IncomingMessage, typeof ServerResponse>;
 export declare function runServer(host?: string, port?: number, config?: AppConfig): void;

package/dist/esm/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAS7D,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1B;AA6JD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,6EAc3C;AAED,wBAAgB,SAAS,CAAC,IAAI,SAAc,EAAE,IAAI,SAAQ,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAKpF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAS7D,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA+KD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,6EAgB3C;AAED,wBAAgB,SAAS,CAAC,IAAI,SAAc,EAAE,IAAI,SAAQ,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAKpF"}

package/dist/esm/server.js

@@ -93,8 +93,10 @@ var ClaudeCLI = class {
     const normalizedModel = this.normalizeModel(model);
     return new Promise((resolve, reject) => {
       const args = ["-p", "--model", normalizedModel, "--output-format", "text"];
+      const startTime = Date.now();
       if (this.config.verbose) {
-        console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] spawning: ${this.config.cliPath} ${args.join(" ")}`);
+        console.log(`[claude] prompt length: ${prompt.length} chars`);
       }
       const proc = spawn(this.config.cliPath, args, {
         stdio: ["pipe", "pipe", "pipe"]
@@ -108,6 +110,10 @@ var ClaudeCLI = class {
         stderr += data.toString();
       });
       proc.on("close", (code) => {
+        const elapsed = Date.now() - startTime;
+        if (this.config.verbose) {
+          console.log(`[claude] process exited code=${code} elapsed=${elapsed}ms output=${stdout.length} chars`);
+        }
         if (code !== 0) {
           reject(new Error(`Claude CLI failed: ${stderr}`));
         } else {
@@ -128,18 +134,30 @@ var ClaudeCLI = class {
   async *stream(messages, model = "sonnet", systemPrompt) {
     const prompt = this.buildPrompt(messages, systemPrompt);
     const normalizedModel = this.normalizeModel(model);
-    const args = ["-p", "--model", normalizedModel, "--output-format", "stream-json"];
+    const startTime = Date.now();
+    const args = ["-p", "--verbose", "--model", normalizedModel, "--output-format", "stream-json"];
     if (this.config.verbose) {
-      console.log(`Running: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] spawning stream: ${this.config.cliPath} ${args.join(" ")}`);
+      console.log(`[claude] prompt length: ${prompt.length} chars`);
     }
     const proc = spawn(this.config.cliPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    proc.on("close", (code) => {
+      if (this.config.verbose) {
+        const elapsed = Date.now() - startTime;
+        console.log(`[claude] stream process exited code=${code} elapsed=${elapsed}ms`);
+      }
+    });
     proc.stdin.write(prompt);
     proc.stdin.end();
     let buffer = "";
     for await (const chunk of proc.stdout) {
-      buffer += chunk.toString();
+      const chunkStr = chunk.toString();
+      buffer += chunkStr;
+      if (this.config.verbose) {
+        console.log(`[claude] stdout chunk: ${chunkStr.length} bytes`);
+      }
       while (buffer.includes("\n")) {
         const [line, rest] = buffer.split("\n", 2);
         buffer = rest ?? "";
@@ -147,12 +165,21 @@ var ClaudeCLI = class {
         if (!trimmed) continue;
         try {
           const data = JSON.parse(trimmed);
-          if (data.content) {
+          if (this.config.verbose) {
+            console.log(`[claude] parsed type=${data.type}`);
+          }
+          if (data.type === "assistant" && data.message?.content) {
+            for (const block of data.message.content) {
+              if (block.type === "text" && block.text) {
+                yield block.text;
+              }
+            }
+          } else if (data.type === "content_block_delta" && data.delta?.text) {
+            yield data.delta.text;
+          } else if (data.content) {
             yield data.content;
           } else if (data.text) {
             yield data.text;
-          } else if (data.delta?.text) {
-            yield data.delta.text;
           }
         } catch {
           if (!trimmed.startsWith("{")) {
@@ -165,6 +192,13 @@ var ClaudeCLI = class {
 };
 
 // src/server.ts
+var _verbose = false;
+function log(...args) {
+  if (_verbose) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
+    console.log(`[${timestamp}]`, ...args);
+  }
+}
 var _cli = null;
 function sendJson(res, data, status = 200) {
   const body = JSON.stringify(data);
@@ -235,6 +269,9 @@ async function handleRequest(req, res) {
     }
     const chatId = generateId("chatcmpl");
     const created = Math.floor(Date.now() / 1e3);
+    const msgCount = request.messages?.length ?? 0;
+    const lastMsg = request.messages?.[msgCount - 1]?.content?.slice(0, 30) ?? "";
+    log(`\u2192 POST /v1/chat/completions model=${request.model} stream=${!!request.stream} msgs=${msgCount} "${lastMsg}${lastMsg.length >= 30 ? "..." : ""}"`);
     if (request.stream) {
       res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -251,8 +288,10 @@ async function handleRequest(req, res) {
         choices: [{ index: 0, delta: { role: "assistant", content: "" }, finish_reason: null }]
       };
       sendSSEChunk(res, JSON.stringify(initial));
+      let totalLen = 0;
       try {
         for await (const text of _cli.stream(request.messages, request.model)) {
+          totalLen += text.length;
           const chunk = {
             id: chatId,
             object: "chat.completion.chunk",
@@ -262,7 +301,9 @@ async function handleRequest(req, res) {
           };
           sendSSEChunk(res, JSON.stringify(chunk));
         }
+        log(`\u2190 stream complete, total length=${totalLen}`);
       } catch (err) {
+        log(`\u2190 stream error: ${err}`);
         sendSSEChunk(res, JSON.stringify({ error: { message: String(err), type: "server_error" } }));
       }
       const final = {
@@ -279,6 +320,7 @@ async function handleRequest(req, res) {
     }
     try {
       const content = await _cli.complete(request.messages, request.model);
+      log(`\u2190 response complete, length=${content.length}`);
       const response = {
         id: chatId,
         object: "chat.completion",
@@ -289,6 +331,7 @@ async function handleRequest(req, res) {
       };
       sendJson(res, response);
     } catch (err) {
+      log(`\u2190 error: ${err}`);
       sendError(res, String(err));
     }
     return;
@@ -296,8 +339,9 @@ async function handleRequest(req, res) {
   sendError(res, "Not found", 404);
 }
 function createApp(config) {
+  _verbose = config?.verbose ?? process.env.CLAUDE_CODE_RELAY_VERBOSE === "1";
   try {
-    _cli = new ClaudeCLI(config?.cli);
+    _cli = new ClaudeCLI({ ...config?.cli, verbose: _verbose });
   } catch (err) {
     console.error(`Failed to initialize Claude CLI: ${err}`);
     _cli = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-relay",
-  "version": "0.0.4",
+  "version": "0.0.8",
   "description": "Local proxy that exposes Claude CLI as an OpenAI-compatible API server",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -60,5 +60,8 @@
     "esbuild": "^0.27.2",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"
+  },
+  "optionalDependencies": {
+    "@rollup/rollup-linux-x64-gnu": "^4.55.1"
   }
 }