@codeproxy/core

English → README.md

@codeproxy/core 是一个零依赖的 TypeScript 库，将上游 LLM 的 Chat Completions 或 Anthropic Messages 格式转换为 OpenAI Responses API 格式，让 Codex、Claude Code 等 AI 编码代理能够直接调用任意语言模型。

目标：让任何语言模型都能直接在 Codex 或 Claude Code 中使用，无论上游提供商使用什么 API 格式。

快速开始

import OpenAI from 'openai';
import { createResponsesFetch } from '@codeproxy/core';

const client = new OpenAI({
  fetch: createResponsesFetch({
    upstreamFormat: 'openai-chat',
    baseUrl: 'https://api.deepseek.com/v1',
    defaultHeaders: {
      authorization: `Bearer ${process.env.DEEPSEEK_API_KEY}`,
    },
  }),
});

const response = await client.responses.create({
  model: 'deepseek-v4-flash',
  input: 'Hello!',
});

工作原理

上游 API (Chat Completions / Anthropic Messages)
        │
        ▼  createResponsesFetch 自动转换
        │
OpenAI Responses API ←── 供 Codex / Claude Code 消费

CLI → @codeproxy/cli — 本地代理服务器，让 Codex / Claude Code 使用任意模型

安装

npm install @codeproxy/core

API

createResponsesFetch(options)

创建一个 fetch 包装器，自动将 Responses API 流量转换到配置的上游格式。

| 参数 | 类型 | 说明 | |---|---|---| | upstreamFormat | 'anthropic' | 'openai-chat' | 上游 API 格式（省略时从 baseUrl 推断） | | baseUrl | string | 上游端点 URL | | apiVersion | string | 覆盖 Anthropic 版本头 | | model | string | 为所有请求覆盖模型名 | | defaultHeaders | Record<string, string> | 发送给上游的额外请求头 | | dropImages | boolean | 从消息中移除图片部分（纯文本模型） | | timeoutMs | number | 上游请求超时 | | onCacheStats | (stats) => void | 接收缓存使用统计 | | fallbackUpstream | object | 当 dropImages: true 且请求包含图片时，自动切换到该上游（如支持视觉的模型） |

转换器

底层转换器也按命名空间导出：

• anthropic.translateRequest / anthropic.translateResponse / anthropic.translateStream
• openai.translateRequest / openai.translateResponse / openai.translateStream
• translate.* — 统一重新导出

类型

所有 Responses API、Anthropic 和 OpenAI Chat 类型均从包根目录导出。

工具函数

• parseSseStream(stream) — 消费 ReadableStream → 解析后的 SSE 消息
• encodeSseEvent(event, data) — 序列化 SSE 事件为线格式
• makeId(prefix) — 生成单调递增的 ID

协议

MIT