# ccclub — クロードコード & コーディングエージェント リーダーボード > チームや仲間内のクロードコード (Claude Code) などのコーディングエージェント利用状況リーダーボード。トークン数、費用、アクティブ状況、使用エージェントを可視化します。アカウント登録や設定は一切不要。 ウェブサイト: https://api.atologs.com GitHub: https://github.com/nagiworkshop/ccclub-jp Discord: https://discord.gg/6QbGWJUVHq --- ## クイックスタート ```bash # 1. 初期化 (グループを作成し、自動同期を有効にします) npx cross-env CCCLUB_API_URL=https://api.atologs.com npx ccclub init # 2. 招待リンクを仲間に共有する # (初期化後に表示されます — 例: https://api.atologs.com/invite/YHAW6P) # 3. リーダーボードを表示する ccclub ``` --- ## インストールとセットアップ ```bash npx cross-env CCCLUB_API_URL=https://api.atologs.com npx ccclub init ``` この1つのコマンドで以下が実行されます： - 表示名の入力（git config から自動検出も可能） - 6文字の招待コードを持つグループの作成 - マシン上の対応コーディングエージェントのログの検出 - 自動同期の設定 - `ccclub` コマンドをグローバルにインストールし、次回から `npx` なしで実行可能にする --- ## 対応コーディングエージェント ccclub は以下のデフォルトのログ保存場所から自動的に使用データを検出します： | エージェント | デフォルトのログ保存場所 | |-------|------------------| | Claude Code | `~/.config/claude/projects`, `~/.claude/projects` | | Codex | `~/.codex/sessions` | | OpenCode | `~/.local/share/opencode` | | Amp | `~/.local/share/amp/threads` | | pi-agent | `~/.pi/agent/sessions` | デフォルトの場所を使用している場合は、設定は不要です。カスタムの場所を使用している場合は、環境変数 `CLAUDE_CONFIG_DIR`, `CODEX_HOME`, `OPENCODE_DATA_DIR`, `AMP_DATA_DIR`, `PI_AGENT_DIR` で指定可能です。 --- ## 仲間の招待 初期化後、以下のような招待リンクが作成されます： https://api.atologs.com/invite/YHAW6P This link should be shared on Slack, Discord, LINE, iMessage, etc. Opening this link displays: - Group name and member count - One-command join instructions - Rich social cards (OGP) when shared on chat apps 招待された仲間は、以下のコマンドを実行して参加します： ```bash npx cross-env CCCLUB_API_URL=https://api.atologs.com npx ccclub join YHAW6P ``` --- ## リーダーボードの表示 ### コマンドライン (CLI) ```bash ccclub # 本日のリーダーボードを表示 (デフォルト) ccclub -d 1 # 昨日のデータ ccclub -d 7 # 過去7日間 ccclub -d 30 # 過去30日間 ccclub -d all # 全期間 ccclub --global # グローバル公開リーダーボードを表示 ccclub --all # アクティビティのないメンバーを含む全員を表示 ccclub -g XYZABC # 指定したグループを表示 ``` ### ウェブダッシュボード すべてのグループは、以下のURLでウェブダッシュボードを閲覧できます： https://api.atologs.com/g/YHAW6P 機能： - 料金、トークン、会話回数、会話単価、エージェント割合を含むリアルタイムリーダーボード - サブスクリプションプランを設定しているメンバーの月間ROI算出 - アクティビティの時間推移を示すグラフ - アクティブ状態のインジケーター - 期間セレクター（今日、昨日、7日間、30日間、全期間） ### グローバルリーダーボード 公開プロフィールに設定したユーザーは、グローバルリーダーボードに表示されます： https://api.atologs.com/g/global --- ## コマンド一覧 | コマンド | 説明 | |---------|-------------| | `ccclub init` | グループを作成して開始（初回セットアップ） | | `ccclub join <コード>` | 6文字の招待コードを使用してグループに参加 | | `ccclub` | 本日のリーダーボードを表示 | | `ccclub -d 1\|7\|30\|all` | 集計期間 of specified period (Yesterday / 7 Days / 30 Days / All Time) | | `ccclub --global` | グローバル公開リーダーボードを表示 | | `ccclub --all` | アクティビティのないメンバーを含む全員を表示 | | `ccclub create` | 追加のグループを作成 | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub leave [コード]` | グループから脱退 | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub sync` | 手動でデータを同期（通常は自動でバックグラウンド実行されます） | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub sync --force` | ローカルログを再スキャンしてすべて再アップロード | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile` | プロフィールの表示 | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --name <名前>` | 表示名の変更 | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --avatar ` | アバター画像のURLを設定 | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --public` | グローバルランキングに表示する（公開） | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --private` | グローバルランキングに表示しない（非公開） | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --plan pro\|max100\|max200\|api` | 契約中のサブスクリプションプランを設定（ROI計算用） | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --url ` | 表示名にリンクするURLを設定 | | `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub show-data` | アップロードされる生データをプレビュー（プライバシー確認用） | --- ## プロフィールとプラン設定 サブスクリプションプランを設定すると、リーダーボードで月間ROI（投資対効果）が表示されます： ```bash npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --plan max200 # Claude Maxプラン ($200/月) npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --plan max100 # Claude Maxプラン ($100/月) npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --plan pro # Claude Proプラン ($20/月) npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --plan api # API利用ユーザー ``` ROIは支払ったサブスク料金に対してどれだけ価値を得られたかを示します：`$200/1610%` は、$200のプランに対して $3,220 相当のエージェント利用を行ったことを意味します。 その他のプロフィールオプション： ```bash npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --public # グローバルリーダーボードに参加する npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --url https://github.com/ユーザー名 npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --avatar https://example.com/photo.jpg ``` --- ## プライバシーについて ccclub は、エージェント名、トークン数、見積もり費用、モデル名、および実行回数のみをローカルログ（Claude Code、Codex、OpenCode、Amp、pi-agent）から読み取ります。 AtoLogs のソースコードは GitHub で公開されています。 私たちの言葉ではなく、コードそのものを読んでご判断ください。 → https://github.com/nagiworkshop/ccclub-jp **アップロードされない情報（絶対に送信されません）：** - プロンプトや入力内容 - エージェントからの回答 - ソースコードやファイルの中身 - ファイルパスやプロジェクト名 - 会話ログ `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub show-data` を実行することで、アップロードされるデータを正確に確認できます。 --- ## 同期の仕組み - **自動同期**: `ccclub init` を実行すると、Claude Code のセッション終了フックと、その他のエージェント用の軽量なバックグラウンド同期が設定されます。 - **手動同期**: `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub sync` コマンドでいつでも同期できます。 - **フルスキャン**: `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub sync --force` でローカルログを再スキャンできます。 - アップロード前に使用データは30分ごとのブロックに集計されます。 --- ## 複数グループへの参加 複数のグループに同時に参加することができます： ```bash ccclub create # 新たなグループを作成する ccclub join XYZABC # 仲間のグループに参加する ccclub -g XYZABC # 特定のグループのリーダーボードを表示する npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub leave XYZABC # グループから脱退する ``` `ccclub` を引数なしで実行すると、参加しているすべてのグループのリーダーボードが一度に表示されます。 --- ## ウェブ機能一覧 | URL | 説明 | |-----|-------------| | `ccclub.dev` | ランディングページ（このページ） | | `ccclub.dev/g/` | グループダッシュボード（リアルタイムリーダーボード & グラフ） | | `ccclub.dev/g/global` | グローバル公開リーダーボード | | `ccclub.dev/invite/` | 招待ページ（仲間へ共有するリンク） | --- ## よくある質問 (FAQ) **Q: ccclub はソースコードやプロンプトを読み取りますか？** A: いいえ。対応しているコーディングエージェントの利用統計データ（トークン数、費用、モデル名等）のみをローカルログから読み取ります。 **Q: アカウント作成は必要ですか？** A: 不要です。npx cross-env CCCLUB_API_URL=https://api.atologs.com npx ccclub init を実行するだけです。メールアドレスやパスワードの設定は不要です。 **Q: 自動同期はどのように動作しますか？** A: Claude Code の終了時フックと、その他のエージェント用のバックグラウンドプロセスが自動同期します。手動での同期も可能です。 **Q: 各エージェントごとに個別設定は必要ですか？** A: 不要です。デフォルトの保存先から自動的に検出されます。カスタムの場所にある場合のみ指定してください。 **Q: 複数のグループに参加できますか？** A: はい。`ccclub create` または `ccclub join <コード>` で自由に追加できます。 **Q: 月間ROIとは何ですか？** A: プラン（例: `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --plan max200`）を設定すると、支払っている月額料金に対してどれだけの金額分のエージェント利用を行ったかをパーセンテージで表示します。1610% は約16倍使ったことを意味します。 **Q: グローバルリーダーボードに表示するにはどうすればよいですか？** A: `npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub profile --public` を実行します。使用データが ccclub.dev/g/global に公開されます。 **Q: データを削除するには？** A: 全てのグループから脱退（`npx cross-env CCCLUB_API_URL=https://api.atologs.com ccclub leave`）し、ローカルの `~/.ccclub/` ディレクトリを削除してください。サーバー上のデータは一定期間後に失効し削除されます。 --- MIT License · https://github.com/nagiworkshop/ccclub-jp