Protocol Direct Gateway · Issue No. 05

把 CodeBuddy / WorkBuddy
变成 /v1.

同一套账号，管理台切换国内 / 国际、CodeBuddy / WorkBuddy。 变成任何 OpenAI 客户端都能直连的 /v1 渠道。Go 原生单文件，OAuth 后协议直连，不需要 codebuddy --serve。
下载最新发布 本地控制台
默认端点 127.0.0.1:32126 · 协议层直通 · 本地安全落盘
01 /
Capabilities

一件事做到位.

不是多厂商聚合，也不是代理池转发。这个项目只做一件事：把 CodeBuddy / WorkBuddy 账号转为标准 OpenAI 兼容接口。

协议直连架构

PROT-01

默认 protocol_direct。OAuth 授权完成后直接向上游通讯（CodeBuddy CLI 或 WorkBuddy IDE），不再挂起本地 codebuddy --serve 进程，也不依赖任何外部浏览器扩展或 Cookie 嗅探插件。

标准 OpenAI 形状

SPEC-02

完整支持 GET /v1/models、GET /v1/model/info 与 POST /v1/chat/completions。流式与非流式调用双向兼容，轻松对接入 NewAPI、Cursor、Claude Code 与 OpenCode。

智能号池与自动熔断自愈

POOL-03

号池按区域隔离轮询。上游 429 时将该账号冷却 2 分钟（111xx 为 5 分钟，部分 5xx 为 30 秒），冷却期内不参与轮询；同区全冷却时选最早恢复者继续服务，避免整体不可用。

直读官网真实 Credits

CRED-04

管理控制台直接对接官方用量接口，实时拉取并展示「剩余 / 总额」真实数值。剩余额度一目了然，绝无虚标伪造状态。

国内与国际双区精准调度

ROUT-05

请求调度端点严格以账号自身注册区域为基准，不依赖反代宿主机的出口 IP，确保国内凭证走腾讯云通道，国际凭证直达海外节点。

CodeBuddy 与 WorkBuddy 产品切换

PROD-06

与站点正交：同一套 OAuth token，管理台一键切 CodeBuddy（CLI 头）或 WorkBuddy（IDE 头）。模型目录随产品切换，无需重新登录。

Token 计量与 Reasoning 思考链

THNK-07

流式响应收尾补发真实 usage chunk 与缓存命中度统计；原生透传 reasoning_effort 思考档位参数，完整支持 Claude 3.7 Thinking 与 DeepSeek R1 思考过程输出。

02 /
Client Integration

一行命令，即刻连接.

下游工具链只认 Base URL 与 API Key。网关在本地单文件内静默完成协议翻译，安全落盘。 


              

                
              

            

          

        

      

    


    
    

      

        

          
03 /

          
Distribution

          
单文件即用，无需安装.

          

            下载对应平台可执行文件，直接双击或终端运行。首次启动自动生成 API Key 并安全写入同目录 .env。
          

        


        

          

            
              

                平台架构 / Platform
                发布二进制 / Binary Asset
              

            
            
              

                Windows 64 位 (x64)
                
                  codebuddy-proxy-windows-x64.exe
                   (或 windows-amd64.exe)
                
              

              

                Linux 64 位 (amd64)
                
                  codebuddy-proxy-linux-amd64
                
              

              

                macOS Apple 芯片 (Apple Silicon arm64)
                
                  codebuddy-proxy-darwin-arm64
                
              

              

                macOS Intel 芯片 (x86_64 amd64)
                
                  codebuddy-proxy-darwin-amd64
                
              

            
          


          

            环境模板配置文件：.env.example
            · 完整校验哈希表：SHA256SUMS.txt
          

        

      

    


    
    

      

        

          
04 /

          
Getting Started

          
三步跑起来.

        


        

          

            
01 /

            
运行二进制程序

            
从 Releases 下载对应架构的文件，双击或在终端启动。程序自动读取同目录配置并打印出专属 API Key。

          

          

            
02 /

            
进入控制台完成 OAuth

            
在浏览器打开 http://127.0.0.1:32126/direct-admin/，点击「开始认证」一键完成微信/企微或海外授权，账号自动入池。

          

          

            
03 /

            
配置下游工具使用

            
在你的编程助手（如 Cursor、Claude Code、OpenCode）中填入 Base URL http://127.0.0.1:32126/v1 与 API Key 即可。

          

        

      

    


    
    

      

        

          
05 /

          
Compliance & Notice

          
使用前请阅知这一节.

        


        

          

            
它是什么

            
一个自行托管、跑在你本机上的协议翻译工具。不提供模型中继，不代理第三方服务，不托管任何用户账号——所有流量均从你自己的机器直发你所选的上游（CodeBuddy 或 WorkBuddy）。

          

          

            
你的责任

            
请仅对拥有合法授权、且符合其服务条款的账号使用。是否允许此类协议调用，由你与该服务的协议决定——我们无法代为背书，也不对账号受限承担任何连带责任。

          

          

            
我们不提供

            
不提供商用账号或代充额度，不架设公共代理节点，不收集任何用户凭据。软件按开源「原样」免费提供，不保证上游协议持续兼容。

          

        

      

    


    
    

      

        

          把 CodeBuddy / WorkBuddy 接到你的工具链.
        

        

          控制台完成 OAuth，客户端只认 Base URL 和 API Key。纯 Go 单文件极简运行，零冗余开销。
        

        

          访问 GitHub 仓库
          查阅完整 README
        

      

    

  


  
  

  
已复制代码到剪贴板