Token Proxy：本地 AI API 网关

项目简介

Token Proxy 是运行在本机的 AI API 网关，面向需要统一管理 OpenAI、Gemini、Anthropic 等上游的开发者。它把请求转发到本机端口，默认 9208（debug 构建为 19208），并用 SQLite 记录请求与 token 统计。项目提供 Tauri 桌面界面，也包含 Rust CLI，适合为 Claude Code、Codex 等客户端做本地接入与多上游调度。

主要功能

• 多 provider 支持：openai、openai-response、anthropic、gemini、kiro、codex、xai。
• 以 upstream 为调度单位：优先级、代理、启停、可用模型、凭据都绑定在每条 upstream 上；在 Upstreams 页面用 Add Account 登录或导入 Kiro / Codex / xAI。
• 可选格式转换：OpenAI Chat ⇄ Responses、Anthropic Messages ↔ OpenAI、Gemini ↔ OpenAI/Anthropic，支持 SSE、tools、images。
• 模型别名映射：精确匹配、prefix* 前缀、* 通配，响应回显原始别名。
• 本地访问密钥与上游凭据注入，支持请求头回退。
• SQLite 仪表盘：请求数、tokens、缓存 tokens、延迟、最近请求。
• macOS 托盘实时 token 速率（可选）。
• 提供 Claude Code / Codex 一键配置。

安装与使用

macOS：将 Token Proxy.app 放入 /Applications；若被系统拦截，可运行：

xattr -cr '/Applications/Token Proxy.app'

启动应用后代理会自动运行。打开 Config File 标签编辑并保存 config.jsonc，填入上游 API key；运行中的代理会自动重载，必要时重启。可用 curl 调用 http://127.0.0.1:9208/v1/chat/completions 或 /v1/messages。

也可以使用 Rust CLI：

cargo run -p token_proxy_cli -- serve

CLI 默认读取 ./config.jsonc，可用 --config 指定路径。

注意事项

• 配置文件为 config.jsonc，允许注释和尾逗号。
• Kiro / Codex / xAI 必须使用 credential.type = "account"；删除账户型 upstream 会级联删除账户凭据，且禁止复制。
• 格式转换由 upstreams[].convert_from_map 控制，没有全局开关；未允许转换时，缺少对应 provider 的上游不会被选中。
• release 构建日志级别强制为 silent；max_request_body_bytes 默认 100 MiB。
• 默认监听 127.0.0.1:9208，端口冲突可在配置中修改。

本作品整理自 GitHub 开源项目 mxyhi/token_proxy，原作者 @mxyhi，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。