【推荐】GUACODE—傻瓜式一键配置CODEX/claude code/vs code第三方API中转

# guacode 🎃

一键把第三方中转 API Key 接入 Codex / Claude Code / VS Code 插件，顺便帮你盯着缓存命中率。

## 它能干什么

- **Profile 管理** — 保存多套 OpenAI / Claude 接入配置（key、base URL、默认模型），随时切换
- **一键写入** — 选好 profile，点一下就把配置写进 `~/.codex`、`~/.claude` 或 VS Code `settings.json`
- **本地代理** — 请求先过 guacode 本地代理再转发上游，key 不直接暴露给外部工具
- **缓存统计** — 实时监控每个 key / 模型的 prompt cache 命中率，miss 超过 40% 自动预警

## 支持的工具

| 工具 | 配置写入位置 | Profile 类型 |
|---|---|---|
| Codex CLI & VS Code Codex 插件 | `~/.codex/auth.json` + `config.toml` | OpenAI |
| Claude Code CLI & VS Code Claude Code 插件 | `~/.claude/settings.json` + `config.json` | Claude |
| VS Code ChatGPT 扩展 | VS Code `settings.json` | OpenAI |

## 下载安装

前往群文件：

| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon) | `guacode-x.x.x-arm64.dmg` |
| macOS (Intel) | `guacode-x.x.x-x64.dmg` |
| Windows | `guacode-x.x.x-setup.exe` |

> **macOS 用户注意：** 由于没有 Apple 开发者签名，首次打开时系统会拦截。  
> 请右键点击 app → 打开，或前往 **系统设置 → 隐私与安全性** → 点击"仍要打开"。

## 使用流程

1. 打开 guacode，在左侧 **Profile Vault** 保存你的接入配置（key + base URL）
2. 点右侧对应工具的 **接入** 按钮，配置会自动写入本地文件
3. 启动 **本地代理**，请求会通过 `127.0.0.1:4318` 转发到你的上游
4. 底部 **Cache Watch** 面板实时展示缓存命中率

## 代理端点

启动本地代理后，工具的请求会通过以下地址转发：

```
OpenAI 协议  →  http://127.0.0.1:4318/openai/v1
Anthropic 协议  →  http://127.0.0.1:4318/anthropic
```

## 技术栈

- **Electron** + **React** + **TypeScript** + **Vite**
- 跨平台：macOS / Windows
- 纯本地运行，零外部服务依赖

## License

MIT