使い方ガイド
AtoLogs (アトログズ) は、コーディングエージェント（Claude Code 等）の使用量をお手軽に可視化し、仲間と共有できるツールです。
1. 30秒で始める
初期化コマンドを実行するだけで、すぐに開始できます。お使いのターミナルで以下のコマンドを実行してください：
CCCLUB_API_URL=https://api.atologs.com npx ccclub init
コピーしました！
このコマンドだけで以下が自動で行われます：
- 表示名（ユーザー名）を
git configから自動検出（変更可能） - 6文字のグループ招待コードを新規発行
- Claude Code / Codex などのログを自動検出してバックグラウンド同期を設定
2. 2つの始め方
ご利用環境に合わせて、以下の2つのいずれかの方法でセットアップを開始できます。
すでに起動している Claude Code やコーディングAIチャットに、以下のプロンプトをそのまま貼り付けてください。AIが自動的にガイドを読み取り、セットアップコマンドを実行します。
Read https://api.atologs.com/llms-full.txt and run init command
コピーしました！
手動で一つずつ確認しながら導入したい場合は、お使いのターミナルで以下のコマンドを実行してください。
CCCLUB_API_URL=https://api.atologs.com npx ccclub init
コピーしました！
3. データを見る
セットアップが完了すると、自動的にWebダッシュボードが生成され、以下のデータ項目をいつでもブラウザから確認できます。
主要指標カード
「今日のトークン量」「推定コスト」「会話セッション数」「稼働しているメンバー数」をトップに要約表示します。
活動タイムライン（ヒートマップ）
いつ誰がアクティブにコードを書いたかを時間帯別に可視化します。※このグラフはプライベートなグループ内のみで共有され、グローバルランキング（/g/global）には非表示になります。
リーダーボード テーブル
メンバーのアバターや名前と合わせて、使用エージェント比率（Claude Code / Codex 等）や会話量別の順位表を表示します。
活用ログ共有切り替え
ダッシュボードからワンクリックで、自分がグループ内のランキングに参加するか、一時的に非表示にするかを切り替えることができます。
4. 仲間を招待する
AtoLogs の真価はチーム全体で使うことで発揮されます。招待手順は以下の通りです：
- ダッシュボード上部にある「招待リンク」をコピーします。
- 招待リンク（例：
https://api.atologs.com/invite/YHAW6P）を Slack や Discord、LINE 等に貼り付けます。（自動的にリッチなプレビュー画像が生成されます） - 招待された側は、リンク内にある「参加コマンド」をコピーしてお使いのターミナルで実行するだけで完了です。
5. プライバシー
AtoLogs はセキュリティとプライバシーを第一に設計されており、開発データや会話内容は一切収集しません。
私たちの言葉ではなく、コードそのものを読んでご判断ください。
→ https://github.com/nagiworkshop/ccclub-jp
❌ 送信されないもの（非収集）
- ユーザープロンプトや入力されたテキスト
- AIエージェントからの回答テキスト
- 開発中のソースコードやファイルの中身
- ファイルの絶対パスやプロジェクトフォルダー名
- 会話された詳細履歴そのもの
✅ 送信されるもの
- トークン数（入力、出力、推論）
- 使用されたAIモデル名
- 会話セッション数（エージェント起動回数）
- 集計タイムスタンプ（30分単位にまとめて送信）
どのようなデータが送信されるかご自身の目で直接監査できます。ターミナルで以下のコマンドを実行してください：
CCCLUB_API_URL=https://api.atologs.com npx ccclub show-data
6. コマンド一覧
よく使用する基本的な CLI コマンドです：
| コマンド | 説明 |
|---|---|
| ccclub init | グループを作成して開始（初回セットアップ） |
| ccclub join <コード> | 招待コードを使用してグループに参加 |
| ccclub | 本日のリーダーボードを表示 |
| ccclub profile --name "..." | 表示名を変更 |
| ccclub show-data | アップロードされる生データをプレビュー |
| ccclub leave <コード> | グループから脱退 |
すべてのコマンド一覧を表示
ccclub create — 新たなグループを作成する
ccclub sync — 手動同期（通常は自動でバックグラウンド実行）
ccclub sync --force — ローカルログを再スキャンしてすべて再アップロード
ccclub profile --avatar <URL> — カスタムアバター画像を設定
ccclub profile --public — グローバルランキングに公開する（公開）
ccclub profile --private — グローバルランキングから非公開にする（非公開・デフォルト）
※ 全ての CLI オプションは llms-full.txt より確認いただけます。
7. 困ったときは
Q. ダッシュボードにデータが表示されません
CCCLUB_API_URL=https://api.atologs.com npx ccclub sync --force
Q. Codex などのエージェントを使っているのに反映されません
CODEX_HOME にログフォルダーの絶対パスを設定してから同期をお試しください。
Q. 複数のPC / マシンで同じ自分を集計したいです
~/.ccclub/config.json に記録されている userToken の値をもう一方のマシンの設定ファイルに上書きコピーすることで、データを同一ユーザーのアクティビティとして統合できます。
Q. グループの名前を変更したいです
ccclub create）いただき、改めてメンバーを招待してください。
Q. データを全部サーバーから削除したいです
ccclub leave）を実行し、マシンのローカルに存在する設定フォルダー ~/.ccclub/ を削除してください。サーバー上の古いデータは一定期間後に自動消滅します。
Q. Windows 環境でうまく起動しません
cross-env パッケージを使用してコマンドを実行してください：
npx cross-env CCCLUB_API_URL=https://api.atologs.com npx ccclub init
Q. 表示される料金（コスト）が請求金額と合いません
8. このサイトについて
AtoLogs について ── AtoLogs は、AIエージェントを活用した開発プロセスの跡を記録し、チーム内での学びの共有とモチベーション向上をサポートするツールです。開発者の Nagi が個人で開発・運用を行っています。
オープンソースへの感謝 ── 本サイトは、オープンソースプロジェクトである mazzzystar/ccclub をベースにした、日本向けローカライズフォーク（Fork）版です。多大なるオリジナルの開発者に敬意と感謝を表します。MIT Licenseの下で配布されています。
フィードバック・お問い合わせ ── バグ報告、ご提案、質問などがございましたら、お気軽に GitHub Issues までお寄せください。