SHTUCodeProxy

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #rust #linux #nodejs #awesome #kubernetes #awesome-list #pytorch #mcp #ios #open-source

(★ 16)

上海科技大学校内 GenAI API 接入 Claude Code 和Codex的 Windows 及Linux图形化本地代理工具。

SHTUCodeProxy 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SHTUCodeProxy

让 Claude Code、Codex 及各种支持自定义 API 的工具与校园 GenAI API 真正连起来。

本地协议适配层，把模型路由、客户端配置、工具调用、多轮上下文和跨平台打包整合在一起，让校园 GenAI API 更容易进入日常研发和学习场景。

> **提示**：GPT 系列模型应使用 `responses` API 格式；GLM、Qwen、DeepSeek 等 Chat 模型可使用 `chat_completions`。

---

## 支持的客户端

| 客户端 | 协议 |
|--------|------|
| Claude Code | Anthropic Messages `/v1/messages` |
| Codex CLI / Desktop | OpenAI Responses `/v1/responses` |
| Claude Desktop | Anthropic Messages `/v1/messages` |
| 通用 API 客户端 | `/v1/responses` 或 `/v1/messages` |

本地代理运行在 `http://127.0.0.1:8082`，在客户端协议和上游模型格式之间自动转换。

## 截图

Claude CLI
<img width="1195" height="449" alt="Claude CLI" src="https://github.com/user-attachments/assets/7f9ffe47-b5c1-4a66-ab05-1b6c747335c8" />

Codex Desktop
<img width="946" height="764" alt="Codex Desktop" src="https://github.com/user-attachments/assets/421e1bba-9d29-4530-8178-2c299fa9d575" />

Claude Desktop
<img width="1200" height="800" alt="Claude Desktop" src="https://github.com/user-attachments/assets/61440724-7080-4c1e-b43c-d4022eda6abe" />

## 快速开始

### Windows（推荐 zip 包）

1. 从 [Releases](https://github.com/saberjack/SHTUCodeProxy/releases/latest) 下载 `SHTUCodeProxy-vX.X.X-windows-x64.zip`
2. 解压到任意目录，双击 `SHTUCodeProxy.exe` 运行
3. 在 GUI 中配置模型和 API Key，点击 **Start Proxy**
4. 打开 Claude Code / Codex 即可使用

> **为什么不推荐 exe？** 单文件 exe（onefile）在自动更新时可能被 Windows Defender 拦截 DLL 加载。zip 包（onedir）包含 `_internal/` 目录，自动更新更可靠。如需单文件 exe，仍可从 Release 页面下载，手动双击运行不受影响。

### Linux (GUI)

```bash
tar xf SHTUCodeProxy-vX.X.X-linux-x86_64-python-launcher.tar.xz
cd SHTUCodeProxy
./SHTUCodeProxy
```

### Linux (Headless CLI)

```bash
unzip SHTUCodeProxy-vX.X.X-linux-x86_64-headless-cli.zip
cd SHTUCodeProxy-vX.X.X-linux-x86_64-headless-cli
chmod +x shtucodeproxyctl-vX.X.X-linux-x86_64
nano config.json                          # 填入 API Key
./shtucodeproxyctl-vX.X.X-linux-x86_64 apply-config config.json --write-claude --write-codex --start
./shtucodeproxyctl-vX.X.X-linux-x86_64 status
```

## 自动更新

GUI 底部栏提供 **检查更新** 按钮，检测到新版本后一键下载并重启。更新流程：

1. 检测 GitHub Release 最新版本
2. 下载对应平台的更新包（Windows: zip, Linux: tar.xz）
3. 替换可执行文件，启动新版本
4. 新版本自动清理旧文件（`.old` 备份、临时目录）
5. 新版本启动失败时自动回滚到旧版本

> v4.7.16 之前的版本自动更新使用 exe 格式，可能被 Windows Defender 拦截。如遇 `Failed to load Python DLL` 错误，请手动下载 zip 包安装。

## 配置说明

`config.json` 核心字段：

- `models`：定义模型路由。`model_id` 是客户端请求的本地名称，`upstream_model` 是上游真实模型名，`api_format` 为 `responses` 或 `chat_completions`
- `default_model_id`：未指定模型时的默认路由
- `codex_model_id`：写入 Codex `config.toml` 的模型
- `default_stream`：请求省略 `stream` 时的默认行为
- `model_env.ANTHROPIC_MODEL`：Claude Code 主模型

切换模型：`./shtucodeproxyctl use-model MODEL_ID`

## 源码运行

```powershell
python app.py          # GUI
python cli.py serve    # 仅代理（无 GUI）
```

## 已知限制

- **Qwen 推理模式**：Qwen-instruct 有时进入推理模式，实际输出在 `reasoning` 字段，代理会自动提取到 `content`，但展示的是原始推理过程
- **Token 用量为估算**：上游 Chat Completions 模型不返回精确 token 数，代理按字符数估算
- **图片/多模态为 best-effort**：仅部分模型支持图片输入，输出图片不可用
- **仅适用于校园 GenAI API**：未对第三方 API 做兼容性测试

## 常见问题

| 问题 | 解决方案 |
|------|----------|
| `ConnectionRefused` | 确认代理已启动（GUI 中点击 Start Proxy） |
| Claude Code 端口不对 | 检查 `~/.claude/settings.json` 中 `ANTHROPIC_BASE_URL` 为 `http://127.0.0.1:8082` |
| 模型不存在 | 检查 model ID、API Key、上游模型是否有效 |
| 自动更新报 `Failed to load Python DLL` | Windows Defender 拦截了 onefile exe 的 DLL 解压，请手动下载 zip 包安装 |
| Claude Code 输出乱码 | 升级到 v4.7.8+ 已修复 reasoning 代码块格式问题 |

## Credits

Created by **sunyb**, ShanghaiTech University Library and Information Center.

## License

MIT License. See `LICENSE`.

SHTUCodeProxy

SHTUCodeProxy 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

SHTUCodeProxy

SHTUCodeProxy 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README