Claude CodeとGit・Obsidianを連携させるまでの全記録【詰まったところも全部書く】

正直に言う。

「Git？Obsidian？Claude Code？」という状態から始まったし

最初はターミナルの黒い画面を開いただけで意味がわからなかったし、少し怖かった。

でも全部やってみた。詰まったところも全部ここに書く。

・・・とその前に、なぜこの環境を最初に整える必要があるのかの説明から。

理由はシンプルだ。

AI副業を本気でやるなら、 毎回同じ説明をClaudeに繰り返す時間がもったいない。

この環境を整えると、Claudeが前回の作業を 引き継いだ状態でスタートしてくれる。

つまり、限られた1日1時間の副業時間を 無駄なく使えるようになる。

設定は必須と言わざるを得ない。

同じように「やってみたいけど何から始めればいいかわからない」という人の参考になれば嬉しい。

---

そもそもClaude Code・Git・Obsidianって何？

Claude Codeとは

ブラウザで使うClaudeを、パソコンの黒い画面（ターミナル）から使えるようにしたものだ。

何が違うかというと、自分のパソコンのファイルを直接読んだり書いたりできる。ブラウザ版は「会話するだけ」だが、Claude Codeは「ファイルを操作しながら作業できる」。

Gitとは

ファイルの変更を記録しておく仕組みだ。

わかりやすく言うとゲームのセーブデータだ。「この時点の状態に戻したい」という時に使える。間違えても怖くない。

Obsidianとは

メモアプリだ。ただし普通のメモアプリと違って、データが自分のパソコンの中に保存される。クラウドに上がらないので安心して何でも書ける。

3つをつなげると何が起きるのか

Obsidian    → 作業記録・タスクを書く場所
Git         → その記録をバックアップする仕組み
Claude Code → 記録を読んでから作業を始めてくれるAI

毎回「前回どこまでやったっけ」をClaudeに説明しなくてよくなる。記録を読んで、続きから始めてくれる。

---

実際に詰まったところ【正直に全部書く】

詰まり①：Gitが入っていなかった

ターミナルで確認したらエラーが出た。

xcrun: error: invalid active developer path

解決策はこれだけ

bash

xcode-select --install

画面に出てくる「インストール」をクリックして待つだけ。5〜10分で終わる。

詰まり②：Claude Codeをインストールしようとしたら「権限がない」と言われた

npm error code EACCES

解決策はこれだけ

bash

sudo npm install -g @anthropic-ai/claude-code

最初に sudo をつけるだけ。パスワードを聞かれたら入力する（画面には何も表示されないが正常）。

詰まり③：GitHubにデータを送ろうとしたら弾かれた

remote: Write access to repository not granted.

原因と解決策

GitHubのパスワード代わりに使う「トークン」の権限が足りなかった。トークンを作る時に**「repo」という項目の大きなチェックボックス**にチェックを入れることで解決した。

詰まり④：ターミナルのコマンドをClaude Codeに打ち込んでしまった

完全な凡ミスだ 笑

Claude Codeを起動したまま、ターミナル用のコマンドを打ってしまった。

解決策：exit と打てばClaude Codeが終了する。その後ターミナルでコマンドを打てばOK。

---

ターミナルの開き方（Macの場合）

ターミナルとはパソコンに文字で命令を送る画面のことだ。

開き方はかんたん。

1. キーボードの Command + スペース を押す
2. 「ターミナル」と入力する
3. Enterを押す

黒い画面が開いたらOKだ。怖くない。

もしそれでも出ない場合はMacの場合右上の日付・時刻の左側に虫眼鏡マークがあるのでそちらをクリックするとSpotlightという文字入力画面がでてくるのでそちらに「ターミナル」と入力してEnterを押してください。

---

セットアップの手順【順番通りにやるだけ】

以下のコードは意味がわからなくても大丈夫だ。そのままコピーしてターミナルに貼り付けてEnterを押すだけでOK。

コードをターミナルに貼り付ける時は Command + V でペーストできる。

Step1：Gitが入っているか確認する

bash

git --version

数字が表示されればOK。エラーが出たら xcode-select --install を実行。

Step2：Node.jsが入っているか確認する

bash

node -v

数字が表示されればOK。入っていない場合はNode.js公式サイトからダウンロード。

Step3：Claude Codeを入れる

bash

sudo npm install -g @anthropic-ai/claude-code

Step4：Obsidianを入れる

obsidian.md から無料でダウンロードできる。

Step5：ObsidianのフォルダをGitに登録する

bash

cd ~/Documents/Obsidian\ Vault
git init

git init は「このフォルダをGitで管理します」という宣言だ。

Step6：不要なファイルをGit管理から外す

bash

cat > .gitignore << 'EOF'
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.trash/
.DS_Store
EOF

Step7：CLAUDE.mdを作る

これが一番大事だ。

CLAUDE.mdとはClaudeへのメモBだ。「私はこういう人間で、こういう作業をしています」と書いておくと、Claude Codeが毎回読んでから作業を始めてくれる。

bash

cat > CLAUDE.md << 'EOF'
# 自分のプロフィールや進行中の作業をここに書く
EOF

Step8：GitHubにバックアップする

GitHubで新しいリポジトリを作って（Privateで）、以下を実行。

bash

git add .
git commit -m "最初の保存"
git remote add origin https://github.com/ユーザー名/リポジトリ名.git
git branch -M main
git push -u origin main

Step9：Claude Codeを起動する

bash

cd ~/Documents/Obsidian\ Vault
claude

これだけ。CLAUDE.mdを読んだ状態でClaudeと話せる。

---

CLAUDE.mdに何を書けばいいのか

当ブログのCLAUDE.mdにはこんなことを書いている。

• このブログのコンセプト
• 今週のタスク
• 記事の投稿スケジュール
• 文章を書く時のルール

作業が終わるたびに「今日の作業をCLAUDE.mdに追記して」と指示するだけで自動で更新してくれる。

---

まとめ：黒い画面は怖くない

最初はターミナルを見ただけで怖かった。

でも順番通りにやれば誰でもできる。詰まってもエラーメッセージをそのままClaudeに貼れば解決策を教えてくれる。

この環境を一度整えてしまえば、毎回ゼロから説明しなくてよくなる。

AI副業を本気でやるなら、一度だけ頑張って環境を整えておく価値は十分ある。

この作業は本当に最初だけだから、がんばろう！

この環境が整ったら、次はブログの立ち上げを開始しよう。

まずはここから読んでください。