# codex-proxy

**Repository Path**: echo_love/codex-proxy

## Basic Information

- **Project Name**: codex-proxy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# openai-responses-chat-proxy

在本地提供 **OpenAI Responses API** 的 `POST /v1/responses`，并把请求转换成上游的 **`POST /v1/chat/completions`**（兼容常见 OpenAI 协议网关）。其它 `GET/POST .../v1/*` 会原样转发到同一上游基地址，便于 Codex / SDK 继续访问 `models` 等路径。

## 要求

- Node.js **18.18+**（内置 `fetch`）

## 安装

```bash
npm install -g openai-responses-chat-proxy
```

（若包名在 npm 上已被占用，请改用你发布后实际包名。）

## 启动

CMD：

```bat
set UPSTREAM_BASE=https://你的上游/v1
set UPSTREAM_API_KEY=可选-上游密钥
openai-responses-chat-proxy --port 8787
```

PowerShell：

```powershell
$env:UPSTREAM_BASE="https://你的上游/v1"
$env:UPSTREAM_API_KEY="可选"
openai-responses-chat-proxy --port 8787
```

或使用参数：

```bash
openai-responses-chat-proxy -u https://你的上游/v1 -p 8787 -k sk-可选
```

- **客户端**请求本服务时请在 `Authorization: Bearer <token>` 中带上密钥；若省略，则使用环境变量 `UPSTREAM_API_KEY`（或 `-k`）。
- `UPSTREAM_BASE` 推荐带 **`/v1`** 后缀（如 `https://api.example.com/v1`）。若只填源站（如 `https://api.example.com`），程序会为 Chat Completions 自动补上 `/v1/chat/completions`。

## Codex / 环境变量示例

将 `OPENAI_BASE_URL`（或你使用的工具里等价配置）指向：

`http://127.0.0.1:8787`

并照常设置 API Key（或由服务端 `-k` / `UPSTREAM_API_KEY` 注入）。

## 局限

- 仅实现 Codex 常用路径：**非流式 / 流式文本**、基础 **function tools** 的请求/响应映射；上游不支持的参数会被忽略或导致上游报错。
- **内置工具**（web_search、MCP 等）若上游不支持，需在上游侧处理或自行扩展。

## 开源协议

MIT