Communitygithub.com

gitduk/ccs

Claude Code 的多提供者 API 代理,支援 Anthropic ↔ OpenAI 格式轉換及 TUI 管理。

ccs 是什麼?

此技能作為 Claude Code 的多提供者 API 代理,可將 Anthropic 格式的請求轉換為 OpenAI 格式,並支援多種後端提供者(如 OpenAI、Google Vertex AI、Amazon Bedrock 等)。它透過文字使用者介面(TUI)簡化 API 金鑰管理、路由選擇及端點配置,讓開發者能靈活切換不同 AI 模型來源,無需修改程式碼。主要支援 Claude Code 平台,適合需要繞過單一供應商限制或進行模型比較的場景。使用者可透過互動式選單選擇提供者、管理金鑰,並檢視即時日誌與用量統計。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add gitduk/ccs

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ccs 是做什麼的?

Claude Code 的多提供者 API 代理,支援 Anthropic ↔ OpenAI 格式轉換及 TUI 管理。

功能

  • 多提供者支援:可連接 OpenAI、Anthropic、Google Vertex AI、Amazon Bedrock 等眾多 API 提供者。
  • 格式轉換:自動將 Anthropic 格式的請求轉換為目標提供者所需的格式(例如 OpenAI 格式)。
  • TUI 管理介面:透過直觀的文字使用者介面管理 API 金鑰、路由規則及提供者設定。
  • 代理端點:提供一個本地代理伺服器,Claude Code 可直接連線,無需修改現有設定。
  • 金鑰管理:安全儲存並管理多個 API 金鑰,支援不同提供者的憑證。
  • 路由規則:可設定基於請求解的目標提供者路由規則。

安裝與使用

# 使用 npm 全域安裝(或透過專案安裝)
npm install -g @gitduk/ccs

# 啟動 TUI
ccs tui

# 啟動代理伺服器(預設埠 8080)
ccs proxy

環境變數

變數名稱說明必要
CCS_PORT代理伺服器監聽埠(預設 8080)否
CCS_CONFIG_DIR設定檔目錄路徑(預設 ~/.config/ccs)否

設定範例

以下為 ~/.config/ccs/config.yaml 的範例設定:

providers:
  - name: openai
    type: openai
    api_key: ${OPENAI_API_KEY}
    models:
      - gpt-4
      - gpt-3.5-turbo
  - name: anthropic
    type: anthropic
    api_key: ${ANTHROPIC_API_KEY}
    models:
      - claude-3-opus-20240229
      - claude-3-sonnet-20240229
  - name: vertex
    type: vertex
    project_id: my-gcp-project
    location: us-central1
    models:
      - claude-3-haiku@20240307

routes:
  - match:
      model: claude-*
    provider: anthropic
  - match:
      model: gpt-*
    provider: openai

貢獻指南

歡迎提交合併請求或問題回報。請參考 CONTRIBUTING.md 取得詳細資訊。

授權條款

本專案採用 MIT 授權條款。詳見 LICENSE 檔案。

相關技能