Giới thiệu
sotatek-proxy là một daemon nhẹ chạy trong nền trên máy tính của bạn, đóng vai trò cầu nối minh bạch giữa các AI CLI (Claude Code, claude-cli, v.v.) và Sotatek Bifrost gateway, đồng thời bổ sung metadata attribution về tiến trình và git vào mỗi request.
Tại sao cần sotatek-proxy?
Phần tiêu đề “Tại sao cần sotatek-proxy?”Không có proxy, các request từ AI CLI đến Bifrost không mang theo bất kỳ ngữ cảnh cục bộ nào — không có cách nào biết developer nào đang gửi request, hay request đó xuất phát từ repository nào.
sotatek-proxy giải quyết điều này một cách âm thầm, không cần thay đổi gì trong CLI workflow của bạn:
- Chặn các request trên loopback interface (
127.0.0.1:3817) - Xác định thư mục làm việc của tiến trình đang gọi
- Tìm thư mục
.git/gần nhất và đọcgit remote -v - Inject header
X-Git-Remote(base64-encoded) trước khi forward lên Bifrost - Stream response về CLI của bạn theo thời gian thực
Tính năng chính
Phần tiêu đề “Tính năng chính”| Tính năng | Chi tiết |
|---|---|
| Chỉ loopback | Bind 127.0.0.1:3817 — không bao giờ lộ ra LAN |
| SSE / streaming | Flush từng chunk, không buffer — streaming token tức thì |
| Git attribution | Inject header X-Git-Remote vào mỗi request |
| TTL cache | Cache PID → git-remote, kiểm tra CWD an toàn (TOCTOU-safe) |
| Đa nền tảng | macOS (arm64 / amd64), Linux (amd64 / arm64), Windows (amd64) |
| Quản lý daemon | launchd · systemd · Windows SCM — tự khởi động khi login / boot |
| Bảo mật | Auth header không bao giờ được log; client không thể giả mạo attribution |
Bắt đầu
Phần tiêu đề “Bắt đầu” Cài đặt trên macOS launchd user agent, không cần quyền admin
Cài đặt trên Linux systemd user unit, tự khởi động khi boot
Cài đặt trên Windows Windows Service dưới LocalSystem, cần quyền admin
Sau khi cài đặt, xem hướng dẫn Cấu hình CLI để trỏ Claude Code đến proxy.