昨日のブログで、Claude Codeを試してみると書きました。まずは何者かを調べるところから。セミナーも受けて、だいぶ輪郭が見えてきたので、今日はその記録です。
そもそもClaude Codeって何?(自分なりの解釈)
一言でいうと、「AIに実際の作業を代行させるツール」です。
私がふだん使っているClaude.aiは、チャット形式で1対1の相談相手のようなもの。「こんなこと考えているんだけど、どう思う?」「この文章をどう直す?」という使い方です。
Claude Codeはそれとは少し違います。チャットで考えを整理するだけでなく、実際にファイルを作ったり、フォルダを整えたり、システムを動かしたりする。いわば「相談相手」から「実行部隊」に変わるイメージです。
Claude.ai 相談・アイデア出し
- チャットで1対1の対話
- プロンプトを一緒に考える
- アイデアの整理・壁打ち
- 文章の校正・改善
Claude Code 開発・実行・改修
- 実際の作業を代行
- ファイル・フォルダの操作
- 軽微な依頼・改修
- 仕組みづくりを一緒に組む
合ってるかどうかはわかりませんが、自分はそう理解しました。まず動かしてみて、ズレていたら直していきます。
税理士の仕事に使えそうなこと(ざっくりイメージ)
具体的に何ができるのか、「らしい」を意識しながら書きます。まだ試していない段階なので断言はしません。
- ファイルの命名ルールをAIに考えてもらう…らしい
- フォルダ構成の整理を頼む…らしい
- タスク管理の仕組みをAIと一緒に組み立てる…らしい
- ドキュメント作成ができる…らしい
- 社内システム開発ができる…らしい
- 経営アドバイザリーをしてくれる…らしい
これが本当にできるのか、これから試します。
一方でこれらをやろうと思うとデータがとても大事です。データがあること、また言語化できていることが成否を握ってくるように見えました。
あとは人間が使いやすいようなデザインディレクションも必要になってくるとのこと。これは特にwebサイト作成や社内システムの開発、ツールを作るときのデザインでUIが悪いということが発生する可能性が高まります。
実際の運用はVSCodeで行う
導入の仕方も設定の仕方も、全部Claude.aiに聞きながら進めるつもりです。エンジニアでも技術者でもない人間が試したらどうなるか、それを記録していきます。
実際の運用はVSCode(テキストエディタのようなもの)を使い、Claude Codeのプラグインをインストールして動かしていく予定です。エラーやよくわからない画面が出たらすぐにキャプチャを撮って、Claude.aiに貼り付けて聞く。そういうやり方でやっていきます。
ClaudeCodeはmd=Markdown形式との相性がとても良いらしく、VSCodeはMarkdown形式のテキストエディタでkindle本の製作にも使っていたので私には比較的身近なツールです。
わからないことはその場でキャプチャを撮ってClaude.aiに聞く。それだけで大抵は解決できる、とセミナーで教えてもらいました。
「Claude.md」というルールブックが重要だと知った
セミナーで一番「なるほど」と思ったのがこれです。
Claude.mdとは、いわばルールブック。Claude Codeが作業するたびに毎回読み込まれる指示書にあたるものです。これを最初にきちんと作っておくことで、コンテキスト(私は税理士事務所を運営している税理士です、とか)が持続し、行動ルールが固定され、品質が安定するとのこと。
CLAUDE.mdに書くべき内容
- このプロジェクトの目的・背景
- ファイル・フォルダの構成ルール
- 作業の進め方のルール
- 禁止事項(削除禁止のファイル、勝手な判断をさせないなど)
- よく使うコマンドやツール
そしてこのClaude.md自体も、最初はClaude.aiに「命令・禁止形で書いて」と頼んで作ってもらえばよい、という話でした。
作業が増えてきたらProgress.mdという別ファイルに作業状態を書き出して、Claude.mdからそこを参照させる方法も使えるそうです。
機密情報(APIキーやパスワード)は書かないこと、指示を矛盾させないこと、端的に書くこと、という注意点も教えてもらいました。
セッションとGitも頭に入れておく
もう少し知識として整理しておきます。
セッションとは、Claude Codeが一連の作業として記憶を保持している状態のことです。セッションが切れると前提から指示し直す必要が出てくるので、Claude.mdとProgress.mdで対応するのが基本の考え方です。
APIはサービスが他のサービスに向けて提供している共通の接続手段。MCPはAPIを含めてAI利用を前提に使い方があらかじめ設定されている機能で、コードを書かなくても使えるのが特徴です。Slack・Notion・Google系と組み合わせると便利らしい。
Gitはファイルの変更履歴を自動的に記録していつでも過去の状態に戻せる仕組みです。要はバックアップ。Claude Codeを使う上でGitを一緒に運用しておくと安心、という話でした。個人利用なのでGoogleドライブでよさそうです。
このあとやってみることとして実際にインストールして、最初の画面を見るところまでやってみます。5/6の動画でその様子を流す予定です。うまくいかなかった話もそのまま記録します。