Claude Code の Skills が会話ごとにずれる原因は auto-memory だった — 1行で直す方法

Tue, 21 Apr 2026 00:00:00 +0000

Claude Code の Skills を使い込むうちに「あれ、前と挙動が違う……」と感じたことはないだろうか。~/.claude/settings.json に 1 行追記するだけで解決できる。原因は auto-memory だ。

Claude Code の auto-memory が Skills の挙動を変える仕組み

Claude Code は会話のたびに学習内容を Memory（~/.claude/projects/.../memory/MEMORY.md）へ自動で書き込む機能（auto-memory）を持っている。問題はこの Memory の内容が次の会話でコンテキストウィンドウに自動挿入される点だ。これにより、Skills に記述した指示と競合し、設計どおりの挙動から少しずつずれていく。

会話を重ねるほど症状が顕著になるため、原因の特定に時間がかかりやすい。

解決策：`autoMemoryEnabled: false`

~/.claude/settings.json に 1 行追記するだけで解決する。ファイルが存在しない場合は新規作成し、既存の設定がある場合は {} 内に追記する。

1
2
3


{
 "autoMemoryEnabled": false
}

これで Memory への自動書き込み・読み込みが停止し、auto-memory 機能全体が無効化される。

影響範囲

機能	`autoMemoryEnabled: false` にしたときの変化
Memory への自動書き込み・読み込み	停止
`CLAUDE.md` の読み込み	変化なし（従来どおり動作）
Skills に書いたルールの適用	変化なし（従来どおり動作）

CLAUDE.md や Skills の設定はそのまま有効なので、プロジェクト固有のルールが失われる心配はない。

Claude Code スキル活用の知見：Anthropic 社内での実践から学んだこと

Tue, 17 Mar 2026 00:00:00 +0000

Anthropic で Claude Code を開発している Thariq が、社内での大規模なスキル活用から得た知見をまとめたノートが公開された。スキルは Claude Code の最も使われる拡張ポイントの一つであり、柔軟で作りやすく配布もしやすい。しかしその柔軟性ゆえに「何が正解か」を判断しにくいという問題もある。本記事はそのノートの内容を日本語でまとめたものだ。

スキルとは何か

スキルは「ただの Markdown ファイル」という誤解が多いが、実際にはスクリプト・アセット・データなどを含むフォルダー全体がスキルだ。Claude Code では動的なフックの登録など多彩な設定オプションも提供されている。

最も面白いスキルは、こうした設定オプションやフォルダー構造をクリエイティブに活用しているものだ。

スキルの 9 つのカテゴリ

社内のスキルを棚卸ししたところ、いくつかのカテゴリに分類できた。最も優れたスキルは一つのカテゴリに綺麗に収まる。自組織でどのカテゴリが欠けているかを確認するのに役立つ。

1. ライブラリ・API リファレンス

ライブラリ、CLI、SDK の正しい使い方を説明するスキル。内部ライブラリや Claude Code が苦手とする一般的なライブラリを対象にする。参照コードスニペットのフォルダーや、Claude が避けるべき「落とし穴（gotchas）」リストを含めることが多い。

例:

billing-lib — 社内課金ライブラリのエッジケースや注意点
internal-platform-cli — 社内 CLI の全サブコマンドと使用例
frontend-design — 自社デザインシステムに Claude を合わせる

2. プロダクト検証

コードが正しく動作しているかをテスト・検証するスキル。Playwright や tmux などの外部ツールと組み合わせることが多い。検証スキルは Claude のアウトプットの正確性を担保するために極めて有用で、エンジニアが 1 週間かけて磨き上げる価値がある。

出力の動画録画や各ステップでのプログラムによるアサーションなどの手法も有効だ。

例:

signup-flow-driver — サインアップ → メール確認 → オンボーディングをヘッドレスブラウザで実行
checkout-verifier — Stripe テストカードでチェックアウト UI を操作し、請求書の状態を確認
tmux-cli-driver — TTY が必要なインタラクティブ CLI テスト用

3. データ取得・分析

データ・監視スタックに接続するスキル。認証情報付きでデータを取得するライブラリ、特定のダッシュボード ID、一般的なワークフローの手順などを含む。

スキル on hdknr blog