Claude Code を使い始めて数ヶ月、気がつけば大量の会話ログが溜まっていました。ccusage コマンドで基本的な使用状況は確認できますが、もっと詳細な分析がしたい。そこで ClickHouse Local を使って、Claude の使用ログを分析するスクリプトを作成しました。
Claude Code は ~/.claude/projects/ ディレクトリ以下に、プロジェクトごとに JSONL（JSON Lines）形式でログを保存しています：
~/.claude/projects/
├── project-name-1/
│ ├── session-uuid-1.jsonl
│ ├── session-uuid-2.jsonl
│ └── ...
└── project-name-2/
└── ...
各 JSONL ファイルには、セッションごとのメッセージ、ツール使用状況、タイムスタンプなどが記録されています。
ClickHouse Local は、ClickHouse データベースのスタンドアロン版で、サーバーを起動することなくローカルファイルに対して SQL クエリを実行できます。特に JSON、CSV、Parquet などの構造化データの分析に優れています。
macOS の場合：
brew install clickhouse
作成した分析スクリプトは claude-usage-analyzer.sh に置いています。10種類の異なる観点から Claude の使用状況を分析します。
┏━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ type ┃ count ┃ distribution ┃
┡━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ assistant │ 14361 │ ██████████████████████████████████████████████████ │
│ user │ 11101 │ ██████████████████████████████████████████████████ │
│ system │ 3197 │ ███████████████▉ │
│ summary │ 600 │ ███ │
└───────────┴───────┴────────────────────────────────────────────────────┘
早朝（5-7時）と昼（11-12時）、夕方（15-16時）にピークがあることがわかります：
┏━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ hour ┃ activity ┃ pattern ┃
┡━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 5 │ 3053 │ ████████████████████████████████████████ │
│ 7 │ 1974 │ ███████████████████████████████████████▍ │
│ 11 │ 1990 │ ███████████████████████████████████████▊ │
└──────┴──────────┴──────────────────────────────────────────┘
最も活発なプロジェクトとブランチの組み合わせを確認できます：
┏━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ project ┃ branch ┃ messages ┃ assistant_msgs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ artemis/lunar-gateway │ main │ 4811 │ 2798 │
│ apollo/command-module │ HEAD │ 4770 │ 2151 │
│ apollo/lunar-lander │ HEAD │ 3408 │ 1732 │
└─────────────────────────┴───────────┴──────────┴────────────────┘
ClickHouse Local を使うことで、複雑な集計処理を SQL で簡潔に記述でき、大量のログファイルも高速に処理できました。Claude Code のようなツールの使用状況を定量的に把握することで、自分の開発パターンを客観的に理解できます。
このスクリプトは GitHub で公開していますので、ぜひご自身の Claude 使用状況の分析にお役立てください。
『ソフトウェア設計のトレードオフと誤り―プログラミングの際により良い選択をするには』という本があると思います。
いやでも冒頭から嘘です。この本は読んでません。
でも、この本のタイトルを見て、トレードオフという言葉を思い出しました。
トレードオフとは、何かを選択する際に、何かを犠牲にすることです。 ソフトウェアエンジニアリングに限らず、日々色んな場面でトレードオフを選択していると思います。
トレードオフについて意識しない（トレードオフが無いと思っている）ということは、何も犠牲にしていないのではなく、何もメリットを選択しなかったということです。
例）我々が MySQL を使っているのは何故だろう？（どんなトレードオフがあるだろう？） MySQL なんていうド直球の RDB を利用しているのはただ単に『我々がイケテナイ』からで、状況が許せばもっと別の Storage を利用すべきなんだろうか？ (TiDB?) その場合何が便利になって何が不便になるだろう？（全てが改善するんだろうか？）
= MySQL の Characteristic は何だろう？ つまり、MySQL は設計の中で何を犠牲にして何を得たのだろう？
こういう前書きはさておき、先日会社の忘年会で Most Review Awards という賞を頂きました。GitHub 上でのコードレビュー（正確にはコメントの数？ Approve の数？）が一番多かったからという事らしい。
去年に引き続き2年連続受賞です。ありがとうございます。 ちなみに Most Commit Awards というものはなかった、、、（という話しに続きます。）
去年（2023年12月）の2次会での出来事ですが
Matsuda さんって、他の方のコードレビューむっちゃされてるというこでしたけど、自分でコード書きたいとかって思わないんですか？
みたいなことを言われました。
部署的に遠い方だったので、コードを『書く』という意味の現場からは遠いところにいる、なんか偉い人だと思われたらしい。頂いたお言葉自体は別にそこが趣旨では無くて、お祝いのコメントだったのですが（ありがとうございます）、今回はこの部分にフォーカスしてみたいと思います。
前提にあるのは、Engineer のキャリアとして、ある程度のところまで行くと『コードレビューをするのか』『自分でコードを書くのか』選ばないといけない。みたいな所かなと思います。
いやまぁそもそも Most Review とか、そういう賞を出すこと自体が、コードを書くこととコードをレビューすることをトレードオフにしているような気します。普段はコードを『書く』ことが貢献だと思われているし目立ちがちだけど、普段見えないところでのコードレビューの方が重要なので光を当てよう、的な。
言い換えると、Management としてはコードレビューをすることが重要だということは承知で、でもメンバーにはその意識が無いかもしれないので、そういう賞を出すことで意識を高めよう、とか。
でもこの文章はメンバーの（同僚の）方向きです。いやただのポエムだけど。
コードレビューをすることとコードを書くことはトレードオフではない、というのがそもそもの自分の考えです。
『そうはいっても時間は有限だし、トレードオフがなかったらキャリアパス（Manager v.s. Individual Contributor）問題とか無いでしょ』みたいな話しもあるかもしれません。
IC 憧れますよね。格好いいし。『まねーじゃー』というちょっと古くさい言葉には無い、何かがある。でも、IC になるためにはコードレビューをすることが必要です。
IC はあたかも“個人で孤高 に黙々とコードを書いている”ようなイメージを持たれがちですが、実際にはまったく違います。Individual という言葉は「他者とコミュニケーションをしない」という意味ではなく、むしろ “自分の専門性を軸に、技術的な価値を周りに提供することが主たる役割である” ことを指します。言い換えると、誰かに頼らず（自律して） に専門性を発揮できる人、ということです。
こう聞いて、やっぱり一人で黙々とコードを書いているのが IC としてのあるべき姿だと思われたら、それは誤解です。『自律して専門性を発揮する』という部分が重要であって、誰と・どの様にというのは重要ではありません。
自律した専門性があれば、コードを書いても良いし、コードレビューをしても良いです。どちらも自分の専門性を発揮するための手段です。
自分は Individual のふんわりしたイメージを、『技術にふりまわされないようになる』ぐらいのイメージで捉えています。それは自分の思ったとおりに技術が動く、ということではなく、技術がどう動くかを理解して、それに対してどう対応するかを自分で決める、ということです。
Managerは極端に言えば会社の中での正解なので周りの活動を強制できます（売上が上がるかどうかはさておき）。しかし IC や Software Engineering はトランジスタや物理法則の奴隷です。トランジスタがどう動くかは自分で決められません。技術を学び対等に技術と向き合うと Individual になれます。
title: Kotlin’s inline class and jackson. permalink: kotlin-inline-class-and-jackson —
annotation class EnableInlineClassDeserialize
private class InlineClassDeserializer(
rawClass: Class<*>
) : JsonDeserializer<Any>() {
private val const = rawClass.kotlin.primaryConstructor.apply { this!!.isAccessible = true }!!
private val getter: (JsonParser) -> Any = when (const.parameters[0].type) {
Boolean::class.createType() -> JsonParser::getValueAsBoolean
Int::class.createType() -> JsonParser::getValueAsInt
Long::class.createType() -> JsonParser::getValueAsLong
Float::class.createType() -> JsonParser::getFloatValue
Double::class.createType() -> JsonParser::getValueAsDouble
else -> JsonParser::getValueAsString
}
override fun deserialize(p: JsonParser, ctxt: DeserializationContext): Any {
return const.call(getter(p))
}
}
private class InlineClassKeySerializer(
rawClass: Class<*>
) : KeyDeserializer() {
private val const = rawClass.kotlin.primaryConstructor.apply { this!!.isAccessible = true }!!
override fun deserializeKey(key: String?, ctxt: DeserializationContext?): Any {
return const.call(key)
}
}
class KotlinInlineClassModule : Module() {
override fun version() = Version.unknownVersion()
override fun getModuleName() = javaClass.name
override fun setupModule(context: Module.SetupContext) {
context.addKeyDeserializers(KeyDeserializers { type, _, _ ->
if (type.isInlineClass) {
return@KeyDeserializers InlineClassKeySerializer(type.rawClass)
}
null
})
context.addDeserializers(object : Deserializers.Base() {
override fun findBeanDeserializer(
type: JavaType,
config: DeserializationConfig?,
beanDesc: BeanDescription?
): JsonDeserializer<*>? {
if (type.isInlineClass) {
return InlineClassDeserializer(type.rawClass)
}
return null
}
})
}
private val JavaType.isInlineClass: Boolean
get() = rawClass.isAnnotationPresent(EnableInlineClassDeserialize::class.java)
}
これで以下は動く
@EnableInlineClassDeserialize
inline class MyStringId(
@get:JsonValue
val value: String
)
@EnableInlineClassDeserialize
inline class MyLongId(
@get:JsonValue
val value: Long
)
class InlineJackson {
companion object {
private val log = mu.KotlinLogging.logger {}
}
private val mapper = ObjectMapper().registerKotlinModule()
init {
mapper.registerModule(KotlinInlineClassModule())
}
@Test
fun testInlineSerialize() {
val ret = mapper.writeValueAsString(MyStringId("test"))
log.info { ret }
val readValue = mapper.readValue(ret, MyStringId::class.java)
val longValue = mapper.readValue("123", MyLongId::class.java)
val mapValue = mapper.readValue<Map<MyStringId, MyLongId>>("""{"key": 1}""")
val listValue = mapper.readValue<List<MyStringId>>("""["1","2"]""")
log.info { readValue }
log.info { longValue }
log.info { mapValue }
log.info { listValue }
}
}
03:01:08.002 [main] INFO - "test"
03:01:08.035 [main] INFO - MyStringId(value=test)
03:01:08.035 [main] INFO - MyLongId(value=123)
03:01:08.035 [main] INFO - {MyStringId(value=key)=MyLongId(value=1)}
03:01:08.036 [main] INFO - [MyStringId(value=1), MyStringId(value=2)]
https://assets.codeforces.com/rounds/997-998/main-contest-editorial.pdf
公式 Editorial が出ていた。
個人成績は
一番のアハ体験が、普通にやってると『CNOT って、Controlled bit > Target bit に制御をしてるから、Controlled bit には影響が無い（？）』ものだと思ってたら感違いで、もつれを作ってるから普通に『CNOT を適用 > Target を計測』の流れて Controlled の状態が収束してしまうことがある。
なぜか自宅に 『量子計算と量子情報の原理 (World Physics Selection)』があったので後から読んでいたら『CNOT = CNOT を逆方向にして前後 H で挟んだやつとおんなじやで』って書かれていて意味が分からなかったけどあー。って感じだ。
]]>]]>「悪い記憶も取り戻します。仮に、それで泣いたり、怒りで身が震えたりしてもです。人生を分かち合うとはそういうことではないでしょうか」