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

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

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

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

Claude CLI

Codex Desktop

Claude Desktop

1. 从 Releases 下载 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 页面下载，手动双击运行不受影响。

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

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

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

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

Created by sunyb, ShanghaiTech University Library and Information Center.

MIT License. See LICENSE.