msw - Provider 配置統一管理 是做什麼的?
統一管理 Claude Code、Codex、OpenCode 的 provider 設定。
簡介
JackFGreen/msw 提供一個集中的方法,用來管理多個 AI 編碼工具(Claude Code、Codex、OpenCode)的 provider 設定。透過此技能,您可以定義一次 provider 組態(例如 API 端點、金鑰、模型等),然後讓這些工具自動套用,避免重複設定與設定不一致的問題。
支援的工具
- Claude Code - Anthropic 的指令列 AI 助手
- Codex - GitHub 的 AI 編碼工具
- OpenCode - 開源的 AI 編碼替代方案
使用方法
安裝
將此技能加入您的專案中,請參考各工具的技能安裝說明。通常可以透過以下方式:
# 對於 Claude Code
codex skill install JackFGreen/msw
# 對於 Codex
codex skill install JackFGreen/msw
# 對於 OpenCode
opencode skill install JackFGreen/msw
設定
在專案根目錄建立一個 msw.config.yaml(或 .msw.json)檔案:
# msw.config.yaml
providers:
openai:
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1"
default_model: "gpt-4o"
anthropic:
api_key: "${ANTHROPIC_API_KEY}"
base_url: "https://api.anthropic.com"
default_model: "claude-sonnet-4-20250514"
google:
api_key: "${GOOGLE_API_KEY}"
base_url: "https://generativelanguage.googleapis.com"
default_model: "gemini-2.0-flash"
注意:
\${VARIABLE}語法會從環境變數中讀取值,請將您的 API 金鑰放在環境變數中而非直接寫入設定檔。
執行
技能啟動後,會自動讀取設定檔並將對應的環境變數注入至各工具的工作階段。您不需要手動執行任何額外指令。
如何運作
- 技能初始化時,會尋找專案根目錄下的
msw.config.yaml或.msw.json - 解析檔案中的 provider 組態,並將變數取代為環境變數的值
- 動態設定各工具所需的環境變數(例如
OPENAI_API_KEY、ANTHROPIC_API_KEY等) - 工具即可透過這些環境變數直接使用已設定的 provider
常見問題
問:我可以自訂設定檔的路徑嗎?
答:目前支援在專案根目錄放置 msw.config.yaml、.msw.yaml 或 .msw.json。若有其他需求,請參考進階設定的 config_path 選項(如有)。
問:我的金鑰安全嗎?
答:建議永遠使用環境變數來管理金鑰,避免將敏感資訊提交至版本控制。設定檔中的 ${VARIABLE} 語法只會在執行時期讀取環境變數。
貢獻
歡迎提交 Pull Request 或開啟 Issue 來改進此技能。