MAXeaglet/commandcode-proxy

解決的問題

Command Code 的自有 API 是專有的，且與其 CLI 綁定。本專案提供一個輕量級反向代理，將該協定轉換為廣泛使用的 OpenAI Chat Completions 與 Anthropic Messages 格式，因此任何支援這些標準的工具（Python SDK、Cursor、OpenCode）皆可無需自訂程式碼呼叫 Command Code 模型。

工作原理

此代理是無外部依賴的單一 Node.js 檔案。它透過觀察官方 CLI 的網路流量來複製 Command Code 請求協定。在每次請求中，它執行設備指紋與生命週期預請求，建構 CLI 風格的封包（config、memory、taste、skills、permission mode、params），並轉送至 Command Code API。隨後，它將回應轉換回 OpenAI 或 Anthropic 格式，包含串流 Server-Sent Events、工具呼叫、多模態影像輸入、推理努力映射與快取命中使用指標。它也隱藏反偵測信號：定期更新的每密鑰設備指紋、隨機化會話到期、從 npm 自動取得的版本標頭，以及 OpenTelemetry traceparent 標頭。穩健性功能包括：客戶端中斷時中止上游請求、零輸出與連續逾時重試回傳 HTTP 429，以及 100 MB 請求主體限制。

適用對象

訂閱 Command Code 並希望透過現有的 OpenAI 或 Anthropic 兼容工具（如使用官方 SDK 的 Python 程式碼、Cursor 自訂提供者或 OpenCode）使用其模型的開發者。本專案僅限個人與教育用途，與 Command Code 無關。

主要亮點

• 兩個相容性端點：OpenAI Chat Completions（/v1/chat/completions）與 Anthropic Messages（/v1/messages），皆支援串流與非串流。
• 自動協定轉換：Anthropic 系統提示、tool_result 區塊、input_schema、tool_choice 與思考預算皆映射至 OpenAI 等效項目。
• 透過 /v1/models 提供動態模型清單，5 分鐘快取並帶有硬編碼回退。
• 設備指紋偽裝與生命週期模擬，以模仿正常 CLI 流量。
• 零輸出與閒置逾時檢測回傳 HTTP 429，使 SDK 自動重試，避免錯誤計費。
• 無需依賴的單一檔案執行；已發布 amd64 與 arm64 的 Docker 映像至 GHCR。