--- title: ClaudeCode入門_VSCode_Ubuntu tags: #claudecode入門_vscode_ubuntu author: [Yukiko](https://docswell.com/user/yukiko_it) site: [Docswell](https://www.docswell.com/) thumbnail: https://bcdn.docswell.com/page/D7Y46K1GEM.jpg?width=480 description: ClaudeCode入門_VSCode_Ubuntu by Yukiko published: October 24, 26 canonical: https://docswell.com/s/yukiko_it/KGNY8N-2026-10-24-145434 --- # Page. 1 ![Page Image](https://bcdn.docswell.com/page/D7Y46K1GEM.jpg) 入門講座 ｜ Ubuntu 編 Claude Code VS Code で Claude Code 入門 Ubuntu に入れて、日本語でコードを直す・作る・説明 させる $ claude ここに日本語で頼む うさうさ研修工房 ｜ うさうさ先生 # Page. 2 ![Page Image](https://bcdn.docswell.com/page/VENYZR28J8.jpg) 講座の全体像：10セクション・約2時間25分 0 1 2 3 4 はじめに Claude Code とは Ubuntu の準備 Claude Code を入れ る VS Code 拡張機能 約7分 約18分 約13分 約17分 約16分 5 6 7 8 9 はじめての会話 ハンズオン 権限と安全 便利機能とトラブル まとめ 約18分 約24分 約15分 約13分 約3分 オレンジのセクションは手を動かすハンズオン VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 2 # Page. 3 ![Page Image](https://bcdn.docswell.com/page/Y79PZM1XE3.jpg) SECTION 0 はじめに この講座のゴールと進め方 0-1 この講座でできるようになること 約3分 0-2 対象・前提・費用 約2分 0-3 使う道具の全体図 約2分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 3 # Page. 4 ![Page Image](https://bcdn.docswell.com/page/G78D1L497D.jpg) Lecture 0-1 この講座でできるようになること 1 2 3 環境を作る 日本語で頼む 安全に使う Ubuntu に Claude Code を入れ、VS Code の拡張機能で使えるようにする コードの説明・バグ修正・機能追加 ・Git のコミットまでを任せる 承認・権限モード・巻き戻しで、AI の 作業を自分でコントロールする 練習題材：うさうさラーメン店の会計プログラム（Python）。「2杯以上で100円引き」のはずが…？ VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 4 # Page. 5 ![Page Image](https://bcdn.docswell.com/page/L7LMQL6MJR.jpg) Lecture 0-2 対象・前提・費用 こんな人におすすめ • AI にコードを書いてもらいたいが、始め方が分からない • Ubuntu（Linux）で開発環境を作りたい • チャット AI へのコピペ往復から卒業したい 使うもの 費用 Ubuntu 無料 VS Code 無料 Git / Python 無料 Claude Code 有料：Pro / Max / Team / Enterprise また は Console 前提 • Ubuntu 20.04 以上（講座の画面は 24.04 LTS） • メモリ 4GB 以上・インターネット接続 • ターミナルでコマンドを打った経験が少しある VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 claude.ai の無料プランでは Claude Code は使えません。料金は公式ページで最新を 確認してください。 5 # Page. 6 ![Page Image](https://bcdn.docswell.com/page/4EMY1M56EW.jpg) Lecture 0-3 使う道具の全体図 Ubuntu 24.04 LTS VS Code Claude（AI） チャットパネル 統合ターミナル 拡張機能「Claude Code」 差分を見ながら承認 claude コマンド（CLI） 同じ Claude Code 考える役。 ファイルの読み書きや コマンドの実行は、 あなたの PC 上で Claude Code が行う プロジェクトのフォルダ（usausa-ramen） ramen.py ・ test_ramen.py ・ CLAUDE.md VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 6 # Page. 7 ![Page Image](https://bcdn.docswell.com/page/PER9LV3NJ9.jpg) SECTION 1 Claude Code とは チャット AI との違いと、できること 1-1 Claude Code を4段で理解する 約5分 1-2 うさうさラーメン店で例えると 約4分 1-3 チャット AI との違い 約5分 1-4 できること・任せすぎないこと 約4分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 7 # Page. 8 ![Page Image](https://bcdn.docswell.com/page/P7XQWZ48EX.jpg) Lecture 1-1 Claude Code を4段で理解する 定義 ターミナルや VS Code で動く、Anthropic の AI コーディング助手 例え 厨房に入ってくれる腕のいい助っ人シェフ。レシピ帳（CLAUDE.md）を読み、包丁を使う前に店長に声をかける 詳細 ファイルを読む・編集する・コマンドを実行する道具を持つ。 編集やコマンドの前に、あなたの許可を求める（権限モードで調整） 一言 あなたのフォルダで、一緒に手を動かす AI VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 8 # Page. 9 ![Page Image](https://bcdn.docswell.com/page/37K9V8ZL7D.jpg) Lecture 1-2 うさうさラーメン店で例えると 店長 レシピ帳 助っ人シェフ 厨房 あなた CLAUDE.md Claude Code プロジェクトのフォル ダ 何を作るか決める 最後に味見する 店のルール・作り方 シェフが最初に読む 材料を見て 調理する ファイル・テスト Git ポイント 包丁や火（ファイルの編集・コマンドの実行）を使う前に、シェフは店長に「使っていいですか」と聞く。これが承認。最後に味見（動作確認） するのは店長のあなた。 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 9 # Page. 10 ![Page Image](https://bcdn.docswell.com/page/LJ3WM2D6J5.jpg) Lecture 1-3 チャット AI との違い ブラウザのチャット AI Claude Code コードの渡し方 コピーして貼り付け フォルダのファイルを直接読む 修正の反映 答えをコピーしてファイルに戻す ファイルを直接編集（差分を見て承認） 動作確認 人が実行して結果を貼る テストやコマンドを自分で実行して確かめる プロジェクトの理解 毎回説明し直す CLAUDE.md とファイルから把握する 人の役割 運び屋 頼む・承認する・最後に確かめる VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 10 # Page. 11 ![Page Image](https://bcdn.docswell.com/page/8JDK6ZPMEG.jpg) Lecture 1-4 できること・任せすぎないこと 得意なこと 人が決める・任せすぎないこと • コードを読んで説明する • 何を作るか・何を優先するか • エラーの原因を調べて直す • 最終的に正しいかの判断（動かして確かめる） • 機能を追加する・テストを書く • 本番環境・本番データへの操作 • テストやコマンドを実行して確かめる • パスワードや秘密鍵の扱い • Git のコミットメッセージを書く • 内容を読まずに承認すること • CLAUDE.md の下書きを作る（/init） VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 11 # Page. 12 ![Page Image](https://bcdn.docswell.com/page/VEPKYDNQ78.jpg) SECTION 2 Ubuntu の準備 バージョン確認と、Git・Python・VS Code 2-1 Ubuntu のバージョンを確認する 約3分 2-2 Git と Python を用意する 約4分 2-3 VS Code を入れる 約6分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 12 # Page. 13 ![Page Image](https://bcdn.docswell.com/page/27VVG1KP7Q.jpg) Lecture 2-1 Ubuntu のバージョンを確認する 1 ターミナルを開く（Ctrl+Alt+T）してバージョンを確認 cat /etc/os-release # PRETTY_NAME="Ubuntu 24.04 LTS" などと表示 2 Claude Code の動作条件 OS Ubuntu 20.04 以上 メモリ 4GB 以上 CPU x64 または ARM64 ネット 接続が必要 シェル Bash または Zsh CPU の種類とメモリを確認 uname -m free -h # x86_64 または aarch64 # Mem の total が 4GB 以上 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 13 # Page. 14 ![Page Image](https://bcdn.docswell.com/page/5JGL82QQ7L.jpg) Lecture 2-2 Git と Python を用意する 1 パッケージを更新して Git と curl を入れる sudo apt update sudo apt install -y git curl 2 Git に名前とメールを登録（初回のみ） なぜ Git が要るの？ • AI の変更を記録できる • 失敗しても前に戻せる • Claude Code がコミットメッセージまで 書いてくれる git config --global user.name "Usausa Taro" git config --global user.email "you@example.com" 3 確認する メールアドレスは自分のものに置き換える git --version python3 --version VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 14 # Page. 15 ![Page Image](https://bcdn.docswell.com/page/47QY9PKWEP.jpg) Lecture 2-3 VS Code を入れる 方法A：snap（いちばん簡単） sudo snap install code --classic 確認して、作業フォルダを開く code --version # 1.94 以上 mkdir -p ~/work && cd ~/work code . VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 方法B：公式サイトの .deb # code.visualstudio.com から .deb を取得 sudo apt install ./code_*.deb ポイント • Claude Code 拡張機能には VS Code 1.94 以上が必要 • ターミナルで code . と打つと、そのフォルダを VS Code で開 ける • 「このフォルダの作成者を信頼しますか」には、自分で作った フォルダなら「はい」 15 # Page. 16 ![Page Image](https://bcdn.docswell.com/page/KE4WXYP1J1.jpg) SECTION 3 Claude Code を入れる インストール・ログイン・更新 3-1 公式インストーラーで入れる 約5分 3-2 PATH と claude doctor 約4分 3-3 ログインと契約プラン 約4分 3-4 apt で入れる・更新・削除 約4分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 16 # Page. 17 ![Page Image](https://bcdn.docswell.com/page/L71YN695JG.jpg) Lecture 3-1 公式インストーラーで入れる 1 インストールする（Node.js は不要） curl -fsSL https://claude.ai/install.sh | bash 2 新しいターミナルを開いて確認 公式インストーラーの特長 • Node.js がいらない • バックグラウンドで自動更新 • 本体は ~/.local/bin/claude に入る • sudo は不要（自分のホームに入る） claude --version # 例：2.1.309 (Claude Code) ダウンロード中は何も表示されません 止まったように見えても、プロンプト（$）が戻るまで待つ。エラーが出たら次のレク チャーの手順で確認する。 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 17 # Page. 18 ![Page Image](https://bcdn.docswell.com/page/G7WG4WQWE2.jpg) Lecture 3-2 PATH と claude doctor 「claude: command not found」と出たら echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc claude --version PATH ってなに？ コマンドを探しにいくフォルダの一覧。 ラーメン店で言えば「道具の置き場所リスト」。 リストに ~/.local/bin が書いていないと、 claude という道具を見つけられない。 インストールと設定を診断する claude doctor セッションを始めずに、インストール状態・設定ファイルのエラー・警告と直し方を表示 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 18 # Page. 19 ![Page Image](https://bcdn.docswell.com/page/4JZL25W2E3.jpg) Lecture 3-3 ログインと契約プラン 1 作業フォルダで起動する cd ~/work claude 2 • Pro / Max • Team / Enterprise の席 • Console（API の従量課金） ブラウザでログイン → ターミナルに戻る # ブラウザが開かない → 表示された URL をコピーして開く 3 ログインに使えるアカウント claude.ai の無料プランでは使えません 終了するとき ログイン状態は /status で確認できる /exit # または Ctrl+D VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 19 # Page. 20 ![Page Image](https://bcdn.docswell.com/page/YE6WV9X6EV.jpg) Lecture 3-4 apt で入れる・更新・削除 apt で入れる（stable チャネル） sudo install -d -m 0755 /etc/apt/keyrings sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \ | sudo tee /etc/apt/sources.list.d/claude-code.list sudo apt update && sudo apt install claude-code やりたいこと 公式インストーラー apt で入れた場合 更新 自動（すぐなら claude update） sudo apt update && sudo apt upgrade claude-code 削除 rm -f ~/.local/bin/claude rm -rf ~/.local/share/claude sudo apt remove claude-code VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 20 # Page. 21 ![Page Image](https://bcdn.docswell.com/page/GE5MDNX5E4.jpg) SECTION 4 VS Code 拡張機能 画面の右側で Claude Code と会話する 4-1 拡張機能を入れてサインイン 約4分 4-2 画面の見方 約5分 4-3 パネルとターミナル、2つの入口 約4分 4-4 覚えておきたいショートカット 約3分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 21 # Page. 22 ![Page Image](https://bcdn.docswell.com/page/972985XGJR.jpg) Lecture 4-1 拡張機能を入れてサインイン 拡張機能ビューを開く 1 Claude Code Ctrl+Shift+X 「Claude Code」を検索してインストール 2 提供元が Anthropic のもの ファイルを開き、右上の Spark アイコン 3 ステータスバー右下の「✻ Claude Code」からも開ける $ claude Sign in → ブラウザでログイン 4 ここに日本語で頼む うまくいかないときは「Developer: Reload Window」 右側が Claude Code のパネル VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 22 # Page. 23 ![Page Image](https://bcdn.docswell.com/page/DJY46K8G7M.jpg) Lecture 4-2 画面の見方 Claude Code 会話 Claude の説明・実行した操作が流れる 入力欄 日本語で頼む。@ でファイルを指定 権限モード 入力欄の下。クリックで Manual / Plan などを切替 差分（diff） 編集前と後を左右に表示。許可・却下・ 指示し直し $ claude ここに日本語で頼む VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 23 # Page. 24 ![Page Image](https://bcdn.docswell.com/page/V7NYZRQ8E8.jpg) Lecture 4-3 パネルとターミナル、2つの入口 チャットパネル（拡張機能） 統合ターミナル（claude CLI） 開き方 Spark アイコン Ctrl+` でターミナル → claude 差分の確認 左右に並べて表示 ターミナル内に表示 向いている人 初心者・画面で確認したい人 サーバーでも同じ操作をしたい人 必要なもの 拡張機能（CLI 内蔵） セクション3で入れた CLI 設定・履歴 共通（同じ ~/.claude を使う） 共通 パネルを CLI 風にしたいとき：設定（Ctrl+,）→ Extensions › Claude Code → Use Terminal をオン VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 24 # Page. 25 ![Page Image](https://bcdn.docswell.com/page/YJ9PZMDX73.jpg) Lecture 4-4 覚えておきたいショートカット VS Code パネル Ctrl+Esc ターミナル（claude CLI） エディタ ⇔ Claude の入力欄 Esc Claude を途中で止める 選択した行を @ファイル#行 で渡す Esc を2回 空の入力欄で巻き戻しメニュー Ctrl+Shift+Esc 新しいタブで会話を開く Shift+Tab 権限モードを切り替える Ctrl+Shift+P コマンドパレット（Claude Code で検索） \ + Enter 改行（複数行で入力） ! で始める コマンドを直接実行する @ ファイル名を補完して指定 Alt+K VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 25 # Page. 26 ![Page Image](https://bcdn.docswell.com/page/GJ8D1L39JD.jpg) SECTION 5 はじめての会話 練習プロジェクトを開いて、CLAUDE.md を作る 5-1 練習プロジェクトを用意する 約4分 5-2 /init で CLAUDE.md を作る 約5分 5-3 コードを説明してもらう 約5分 5-4 伝わる頼み方のコツ 約4分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 26 # Page. 27 ![Page Image](https://bcdn.docswell.com/page/LJLMQLVMER.jpg) Lecture 5-1 練習プロジェクトを用意する 1 フォルダを置いて Git を始める ramen.py（教材） """うさうさラーメン店の会計計算""" cd ~/work/usausa-ramen git init && git add . && git commit -m "最初の版" code . 2 テストを実行してみる python3 -m unittest PRICES = {"しょうゆ": 800, "みそ": 900, "しお": 850} def total(menu, qty): """合計金額を返す。 2杯以上なら100円引き""" subtotal = PRICES[menu] * qty if qty > 2: subtotal -= 100 return subtotal 結果（抜粋） AssertionError: 1700 != 1600 Ran 3 tests ... FAILED (failures=1) VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 27 # Page. 28 ![Page Image](https://bcdn.docswell.com/page/47MY1MG67W.jpg) Lecture 5-2 /init で CLAUDE.md を作る CLAUDE.md の例（自分で書き足してよい） /init プロジェクトを調べて CLAUDE.md の下書きを作 る。すでにあれば改善案を出す # うさうさラーメン店 会計プログラム ## テスト - python3 -m unittest で全テストを実行する ## 決まりごと - 金額は int（円）で扱う - 変更したら必ずテストを実行して結果を報告する - 説明は日本語で、初心者にもわかる言葉で 置き場所 使える範囲 使いどころ ./CLAUDE.md このプロジェクト（チームで共有） テスト方法・決まりごと ~/.claude/CLAUDE.md 自分の全プロジェクト 自分の好み（説明は日本語で など） ./CLAUDE.local.md 自分だけ・このプロジェクト .gitignore に入れる個人メモ VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 28 # Page. 29 ![Page Image](https://bcdn.docswell.com/page/P7R9LVZNE9.jpg) Lecture 5-3 コードを説明してもらう あなた → Claude Code Claude の回答のイメージ 「@ramen.py を初心者向けに説明して。仕様と違うところがあ れば教えて。まだ直さないで」 ・PRICES に3種類の値段がある ・total() は 値段 × 杯数 を計算する ・仕様は「2杯以上で100円引き」だが、条件が qty > 2 なので、 2杯ちょうどのとき割引されない → 仕様とのズレを指摘してくれる ファイルの渡し方 @ramen.py @ のあとにファイル名（補完が出る） 行を選んで Alt+K @ramen.py#9-11 のように行番号付き 行を選ぶだけ 選択中の行は自動で Claude に見える VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 AI の回答は毎回少し変わります 29 # Page. 30 ![Page Image](https://bcdn.docswell.com/page/PJXQWZ987X.jpg) Lecture 5-4 伝わる頼み方のコツ 1 目的を伝える 2 範囲を絞る 何のために、何を直したいか 触ってよいファイル・触らないもの 「2杯ちょうどで割引されない問題を直して」 「ramen.py だけを変えて」 3 完了の条件 4 先に計画 どうなったら終わりか 大きな作業は計画を見てから 「python3 -m unittest が全部通ったら完了」 「まず計画だけ出して」（/plan） VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 30 # Page. 31 ![Page Image](https://bcdn.docswell.com/page/3JK9V8PLJD.jpg) SECTION 6 ハンズオン バグ修正 → 機能追加 → コミット → 巻き戻し 6-1 テストを実行させてバグを直す 約7分 6-2 プランモードで機能を追加する 約7分 6-3 Git にコミットしてもらう 約5分 6-4 失敗したら巻き戻す 約5分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 31 # Page. 32 ![Page Image](https://bcdn.docswell.com/page/LE3WM2X6E5.jpg) Lecture 6-1 テストを実行させてバグを直す 差分（diff） あなた → Claude Code 「python3 -m unittest を実行して、失敗の原因を説明して。 ramen.py だけを直して、テストが全部通ったら完了」 - if qty > 2: + if qty >= 2: 修正後のテスト結果 1 テストを実行 コマンド実行の許可を求められる 2 原因を説明 qty > 2 だと2杯ちょうどが対象外 3 差分を提案 左右に並べて表示 → 確認して許可 4 もう一度テスト OK を確認して報告 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 Ran 3 tests ... OK 許可する前に差分を読む。読めないときは「この変更の意味 を説明して」と聞いてから 32 # Page. 33 ![Page Image](https://bcdn.docswell.com/page/8EDK6Z2M7G.jpg) Lecture 6-2 プランモードで機能を追加する /plan 味玉トッピング（1杯150円）を 追加して。テストも足して 1 計画だけ作る ファイルを読むだけ。編集はしない 2 計画を読む 変えるファイル・関数・テスト内容を確認 3 承認して実装 差分を見ながら進む 4 テストで確認 新しいテストも含めて全部 OK VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 実装の一例（ramen.py） EGG_PRICE = 150 def total(menu, qty, egg=False): subtotal = PRICES[menu] * qty if egg: subtotal += EGG_PRICE * qty if qty >= 2: subtotal -= 100 return subtotal 確認：total("みそ", 2, egg=True) → 2000 33 # Page. 34 ![Page Image](https://bcdn.docswell.com/page/V7PKYD1QJ8.jpg) Lecture 6-3 Git にコミットしてもらう あなた → Claude Code 「変更内容を確認して、わかりやすい日本語のメッセージで コミットして。push はしないで」 自分で確認 git log --oneline コミットのルール Claude が実行するコマンドの例 git status git diff git add ramen.py test_ramen.py git commit -m "2杯ちょうどの割引を修正し、味玉トッピングを追加" VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 • テストが通ってからコミットする • 1つのコミットに1つの変更 • push・本番反映は自分で確認してから • メッセージの書き方は CLAUDE.md に書いておける 34 # Page. 35 ![Page Image](https://bcdn.docswell.com/page/2JVVG1YPJQ.jpg) Lecture 6-4 失敗したら巻き戻す VS Code パネル ターミナル（CLI） メッセージにマウスを乗せる → 巻き戻しボタン ここから会話を分岐 Fork conversation from here コードをここまで戻す Rewind code to here /rewind # または 空の入力欄で Esc を2回 2段構えで守る チェックポイント＝会話の中の小さな「元に戻す」 Git のコミット＝確実な保存ポイント 分岐してコードも戻す Fork conversation and rewind code 注意：コマンドで行った変更（ファイル削除・インストールなど）は巻き戻せないことがある。大事な節目は Git でコミットしておく VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 35 # Page. 36 ![Page Image](https://bcdn.docswell.com/page/5EGL829QJL.jpg) SECTION 7 権限と安全 任せる範囲を、自分で決める 7-1 権限モードを使い分ける 約5分 7-2 許可ルールと秘密ファイルの保護 約5分 7-3 安全に使うための4つのルール 約5分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 36 # Page. 37 ![Page Image](https://bcdn.docswell.com/page/4JQY9PWW7P.jpg) Lecture 7-1 権限モードを使い分ける モード 許可なしで進むこと 使いどころ Manual 読むだけ。編集・コマンドは毎回確認 入門・初めてのプロジェクト（おすすめ） Edit automatically ファイル編集と基本的なファイル操作 差分に慣れて、作業を速めたいとき Plan 読む・調べるだけ。計画を承認するまで編集しない 大きな変更の前 Auto ほぼすべて。別のモデルが裏で確認 対応プラン・モデルで、慣れてから Bypass permissions すべて。安全確認なし 隔離したコンテナや VM 専用 切り替え：VS Code は入力欄の下のモード表示をクリック ／ CLI は Shift+Tab VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 37 # Page. 38 ![Page Image](https://bcdn.docswell.com/page/K74WXYK1E1.jpg) Lecture 7-2 許可ルールと秘密ファイルの保護 .claude/settings.json の例 { "permissions": { "allow": [ "Bash(python3 -m unittest *)", "Bash(git status)" ], "deny": [ "Bash(git push *)", "Read(./.env)" ] } allow 確認なしで実行してよい deny 実行・読み込みを禁止 * そこから先は何でもよい } 置き場所 チームで共有：.claude/settings.json 自分だけ：.claude/settings.local.json 画面で編集：/permissions * はサブコマンドの後ろに置く（Bash(git *) は git の全コマンドを許可してしまう） VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 38 # Page. 39 ![Page Image](https://bcdn.docswell.com/page/LJ1YN6X5EG.jpg) Lecture 7-3 安全に使うための4つのルール 1 読んでから許可 差分・コマンドの内容を確認。分からなければ「説明して」と聞 く 3 Git でこまめに保存 動いたらコミット。巻き戻しと組み合わせて安心 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 2 秘密を渡さない パスワード・API キーは会話に貼らない。.env は deny で守る 4 本番は人が確認 push・デプロイ・本番データは最後に人が判断する 39 # Page. 40 ![Page Image](https://bcdn.docswell.com/page/GJWG4WNW72.jpg) SECTION 8 便利機能とトラブル よく使うコマンドと、困ったときの対処 8-1 よく使うスラッシュコマンド 約5分 8-2 会話の続きと文脈の管理 約4分 8-3 トラブルシューティング 約4分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 40 # Page. 41 ![Page Image](https://bcdn.docswell.com/page/4EZL253273.jpg) Lecture 8-1 よく使うスラッシュコマンド /init CLAUDE.md を作る・改善する /rewind 会話やコードを巻き戻す /permissions 許可・禁止ルールを管理 /memory CLAUDE.md を編集する /model AI モデルを切り替える /usage 利用状況・上限を見る /status バージョン・アカウントを確認 /mcp MCP（外部の道具）を管理 /help ヘルプとコマンド一覧 /plan 計画モードで始める 入力欄で / を打つと一覧が出る。全部覚えなくて大丈夫 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 41 # Page. 42 ![Page Image](https://bcdn.docswell.com/page/Y76WV9Z67V.jpg) Lecture 8-2 会話の続きと文脈の管理 コマンド 何をする いつ使う /clear 新しい会話を始める 話題が変わったとき /compact これまでの会話を要約して軽くする 同じ作業を続けたいとき /context コンテキストの使用量を色で表示 重くなってきたと感じたとき claude -c 前回の会話の続きから始める 翌日に再開するとき /resume 過去の会話を選んで再開 前の作業に戻るとき コツ：1つの会話＝1つの作業。終わったら /clear で気持ちよく次へ VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 42 # Page. 43 ![Page Image](https://bcdn.docswell.com/page/G75MDNW574.jpg) Lecture 8-3 トラブルシューティング 症状 よくある原因 対処 claude: command not found ~/.local/bin が PATH にない .bashrc に PATH を追加して source ログイン画面が開かない ブラウザが自動で開かない 表示された URL をコピーしてブラウザで開く 無料プランで使えない Claude Code は有料プラン向け Pro 以上か Console のアカウントで Spark アイコンが出ない ファイルを開いていない／読み込み前 ファイルを開く・Developer: Reload Window code . が使えない VS Code が PATH にない snap で入れ直す／VS Code から開く 何かおかしい 設定ファイルの誤り など claude doctor で診断する VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 43 # Page. 44 ![Page Image](https://bcdn.docswell.com/page/9J2985QGER.jpg) SECTION 9 まとめ できるようになったことと、次の一歩 9-1 振り返りと次の一歩 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 約3分 44 # Page. 45 ![Page Image](https://bcdn.docswell.com/page/DEY46KWGJM.jpg) Lecture 9-1 振り返りと次の一歩 到達チェック 次の一歩 自分のプロジェクトで Ubuntu に Claude Code を入れて claude doctor で確認できる 1 /init から始めて、CLAUDE.md を育てる VS Code の拡張機能でサインインして会話できる MCP で道具を増やす /init で CLAUDE.md を作り、書き足せる 2 ブラウザ操作（Playwright MCP）などをつなぐ 差分を読んでから許可できる 仕様から作らせる プランモードで計画を確認してから実装させられる 3 要件や仕様を書いてから、計画→実装の流れで コミットと巻き戻しで、変更を管理できる VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 45 # Page. 46 ![Page Image](https://bcdn.docswell.com/page/VJNYZR9878.jpg) おつかれさまでした 質問は Q&A へ。感想を聞かせてもらえるとうれしいです。 面白きこともなき世を面白く うさうさ研修工房 ｜ うさうさ先生 # Page. 47 ![Page Image](https://bcdn.docswell.com/page/YE9PZM2XJ3.jpg) 付録：講座で使うプロンプト集 5-3 @ramen.py を初心者向けに説明して。仕様と違うところがあれば教えて。まだ直さないで 6-1 python3 -m unittest を実行して、失敗の原因を説明して。ramen.py だけを直して、テストが全部通ったら完了 6-2 /plan 味玉トッピング（1杯150円）を追加して。テストも足して 6-3 変更内容を確認して、わかりやすい日本語のメッセージでコミットして。push はしないで 差分 この変更の意味を、初心者向けに説明して CLAUDE.md このプロジェクトで守ってほしいルールを CLAUDE.md に追記して：変更後は必ずテストを実行する VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 47 # Page. 48 ![Page Image](https://bcdn.docswell.com/page/GE8D1L59ED.jpg) 付録：確認クイズ No 問題 正解 1 Ubuntu で Claude Code を入れる公式のコマンドは？ curl -fsSL https://claude.ai/install.sh | bash 2 claude: command not found のとき PATH に足すフォルダは？ ~/.local/bin 3 インストールと設定を診断するコマンドは？ claude doctor 4 プロジェクトのルールを書いておくファイルと作成コマンドは？ CLAUDE.md ／ /init 5 編集の前に計画だけを作らせるモードは？ Plan（/plan） 6 CLI で権限モードを切り替えるキーは？ Shift+Tab 7 .env を読ませないための設定は？ deny に Read(./.env) 8 Claude の編集を元に戻すコマンドは？ /rewind（空の入力欄で Esc 2回） VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 48 # Page. 49 ![Page Image](https://bcdn.docswell.com/page/LELMQLYM7R.jpg) 講師用：レクチャー一覧 No レクチャー 0-1 この講座でできるようになること 0-2 分 No レクチャー 分 3 4-4 覚えておきたいショートカット 3 対象・前提・費用 2 5-1 練習プロジェクトを用意する 4 0-3 使う道具の全体図 2 5-2 /init で CLAUDE.md を作る 5 1-1 Claude Code を4段で理解する 5 5-3 コードを説明してもらう 5 1-2 うさうさラーメン店で例えると 4 5-4 伝わる頼み方のコツ 4 1-3 チャット AI との違い 5 6-1 テストを実行させてバグを直す 7 1-4 できること・任せすぎないこと 4 6-2 プランモードで機能を追加する 7 2-1 Ubuntu のバージョンを確認する 3 6-3 Git にコミットしてもらう 5 2-2 Git と Python を用意する 4 6-4 失敗したら巻き戻す 5 2-3 VS Code を入れる 6 7-1 権限モードを使い分ける 5 3-1 公式インストーラーで入れる 5 7-2 許可ルールと秘密ファイルの保護 5 3-2 PATH と claude doctor 4 7-3 安全に使うための4つのルール 5 3-3 ログインと契約プラン 4 8-1 よく使うスラッシュコマンド 5 3-4 apt で入れる・更新・削除 4 8-2 会話の続きと文脈の管理 4 4-1 拡張機能を入れてサインイン 4 8-3 トラブルシューティング 4 4-2 画面の見方 5 9-1 振り返りと次の一歩 3 4-3 パネルとターミナル、2つの入口 4 合計 33 レクチャー・約 2 時間 24 分 VS Code で Claude Code 入門（Ubuntu編）｜ うさうさ研修工房 49