CC Manage — VS Code向け Claude/Codex API 設定統合管理拡張
概要
CC Manage は VS Code 内で Claude / Codex などの外部 AI API 接続設定を一元管理するサイドバー拡張です。複数の設定を作成・保存し、ワンクリックで設定を切り替えられるため、開発中に異なる API キーやモデル間を行き来する際の手間を大幅に削減します。設定はユーザーのホームディレクトリに存在する既存の設定ファイルへ自動同期でき、残高(使用量)のモニタリングや設定のインポート・エクスポート機能も備えています。TypeScript で実装され、VS Code の拡張 API を活用したシンプルかつ実務向けのツールです。
リポジトリの統計情報
- スター数: 6
- フォーク数: 0
- ウォッチャー数: 6
- コミット数: 4
- ファイル数: 14
- メインの言語: TypeScript
主な特徴
- サイドバーから複数の Claude/Codex API 設定を作成・保存・管理
- ワンクリックで設定を切り替え、既存の設定ファイルへ自動同期
- API 残高(利用状況)の監視機能により使用量を可視化
- 設定のインポート/エクスポートでチーム間共有やバックアップが容易
技術的なポイント
CC Manage は TypeScript で書かれ、VS Code の拡張ポイント(Extension API)を利用してサイドバー(Webview もしくは ViewProvider)に UI を提供します。拡張の典型的な構成として、activate 関数でコマンドとビューを登録し、ユーザー操作はコマンド経由で処理されます。設定データはローカルファイルシステムに保存/読み書きされ、ユーザーのホームディレクトリにある既存の設定ファイルへ自動同期する実装が読み取れます。ファイル入出力には Node の fs/path を用い、OS に依存するホームディレクトリ(process.env.HOME / os.homedir() など)への対応が行われる想定です。
残高監視など外部 API への問い合わせは fetch または axios 相当の HTTP クライアントで行い、非同期処理(Promise)で結果を受け取って UI を更新します。UI 側と拡張本体の間にはメッセージパッシング(postMessage/MessageHandler)やコマンド呼び出しがあり、非同期イベント(切替、保存、削除、同期)に応じたハンドリングが実装されています。TypeScript を採用することで型安全なコーディングが可能になり、ESLint 設定(.eslintrc.json)やワークスペース設定も含まれているため、コード品質の担保や開発時の統一が図られています。
セキュリティ面では API キーなど機密情報の取り扱いが課題です。現状のリポジトリ構成からはキー保護の詳細は読み取れませんが、実運用では OS のシークレットストア(keytar 等)や VS Code の SecretStorage を使って平文で保存しない設計が推奨されます。また、複数プロバイダやモデルを扱うため設定の拡張性(プロバイダ種別・エンドポイント・ヘッダ/パラメータの柔軟性)と、設定切り替え時の速やかな反映(プロセス環境変数への書き出しや設定ファイル上書き)を両立することが重要です。
開発・配布面では package.json による拡張定義(commands, activationEvents, contributes.views 等)と、.vscode 設定や ignore ファイル群が含まれており、VS Code Marketplace への公開やローカルでのデバッグが容易です。将来的な改善点としては、自動テスト(ユニット/統合)、API レート制御、設定変更時の差分プレビュー、及びチーム共有向けの暗号化エクスポート機能などが考えられます。
プロジェクトの構成
主要なファイルとディレクトリ:
- .eslintignore: file
- .eslintrc.json: file
- .gitignore: file
- .vscode: dir
- .vscodeignore: file
…他 9 ファイル
(リポジトリは比較的小規模で、TypeScript ソース、マニフェスト(package.json)、メディア資産、設定ファイル類が収められている構成です)
まとめ
VS Code 内で AI API 設定を簡潔に管理できる実用的な拡張。設定切り替えの手間を大幅に削減します(約50字)。
リポジトリ情報:
- 名前: cc-manage
- 説明: 统一管理 Claude/Codex API 配置,支持一键切换、余额监控和配置同步
- スター数: 6
- 言語: TypeScript
- URL: https://github.com/hxfeng1998/cc-manage
- オーナー: hxfeng1998
- アバター: https://avatars.githubusercontent.com/u/67862277?v=4
READMEの抜粋:
CC Manage VS Code Extension
一个用于在 VS Code 内统一管理 Claude/Codex 等 API 配置的侧边栏扩展
功能概览
✨ 核心功能
- 🔧 配置管理:在侧边栏新增、保存任意数量的 Claude/Codex 配置
- 🔄 一键切换:快速切换不同的 API 配置,自动同步到 `~/.cla…