cc-trading — 極簡取引ログ解析CLI

Tool

概要

cc-tradingは、取引(開倉・決済)を対話的に記録し、出力したログをもとにリスク評価やパフォーマンス分析を行う極めてシンプルなCLIツールです。データはJSONLで保存され、データベース不要で運用可能。複数アカウント管理、フィルタによる柔軟な検索、強制的な損切・利確入力、未決済ポジションの選択式決済など、日常的なトレード記録業務を効率化します。また、Claude Codeと連携してトレード履歴を解析し、リスクとパフォーマンスに関するインサイトを自動生成できます。クロスプラットフォームの単一バイナリ配布を想定しているため、環境依存の敷居も低い点が特徴です。

GitHub

リポジトリの統計情報

  • スター数: 3
  • フォーク数: 0
  • ウォッチャー数: 3
  • コミット数: 5
  • ファイル数: 12
  • メインの言語: Go

主な特徴

  • シンプルな交互式CLIでの開倉・平倉記録(プロンプト主体で操作)
  • JSONL形式での軽量ストレージ(データベース不要、行単位で追加)
  • 強制リスク管理(開倉時に必須の止損・利確を要求)
  • Claude Code連携による自動リスク評価・パフォーマンス分析

技術的なポイント

cc-tradingは「単一実行ファイルで動く軽量な取引ログ管理ツール」を目指してGoで実装されており、設計はシンプルさと可搬性を重視しています。データ保存にはJSONL(各行が独立したJSONオブジェクト)を採用しており、追記操作が容易でテキストエディタでも直接確認・修正が可能です。この方式によりデータベース導入のコストを排し、バックアップやバージョン管理も容易になります。

CLIは対話的プロンプトを中心に、開倉時は必ず止損と利確を入力させるなど強制的なリスクルールが組み込まれています。平倉は未決済ポジションの選択式で行われ、自動的に損益を計算して記録するため、日次・累計のパフォーマンス把握が行いやすい設計です。表示する指標は「アカウント損益(実損益)」と「証拠金ROI(資金効率)」の二軸で、トレードの成果と資金効率を同時に評価できます。

分析面ではAnthropicのClaude Codeを統合しており、保存したトレードログを送信してリスク評価や改善点のサマリを得られます。外部モデル連携により、単純な統計だけでなく自然言語での洞察出力が可能になる点が特徴です。実装上はAPIキー等の設定とネットワークアクセスが必要ですが、分析結果はログと併せて保存・表示されます。

クロスコンパイルや単一バイナリ配布を想定したビルド構成により、Windows/Mac/Linuxで同一の操作感を提供。シンプルなアーキテクチャのため、拡張やカスタマイズ(カスタムフィールド追加、他サービス連携など)も比較的容易です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .claude: dir
  • .gitignore: file
  • .kiro: dir
  • CLAUDE.md: file
  • EXAMPLES.md: file

…他 7 ファイル

(リポジトリは小規模で、CLI本体・ドキュメント・設定関連のファイルで構成されています)

まとめ

シンプルかつ実用的な取引ログCLI。分析連携が特徴。

リポジトリ情報:

READMEの抜粋:

交易日志 CLI 系统

一个基于 Go 的命令行工具,用于记录和管理交易操作(开仓、平仓),并通过 Claude Code 进行风险评估和交易优化分析。

特性

  • 💼 多账户管理 - 支持管理多个交易账户(如黄金账户、BTC账户)
  • 📊 交互式开仓记录 - 通过友好的提示界面记录新仓位
  • 📉 智能平仓管理 - 选择未平仓位并记录平仓信息,自动计算盈亏
  • 🔍 灵活查询筛选 - 按状态、品种、市场类型、账户、日期范围筛选交易记录
  • 💰 双重盈亏指标 - 同时显示账户盈亏比(真实收益)和保证金ROI(资金效率)
  • ⚠️ 强制风险管理 - 开仓时必须设置止损和止盈
  • 📈 数据分析 - 通过 Claude Code 进行风险评估和表现分析
  • 💾 简单存储 - JSONL 文件存储,无需数据库
  • 🚀 跨平台支持 - 编译为单一可执行文件,支持 Windows/Mac/Linux

安装

从源码编译

# 克隆仓库
git clone <reposi...