top of page

Claude Code 導入・安全設定・使い方ガイド

11 時間前
読了時間: 10分

Claude Codeを業務で安全に使い始めるための研修資料「Claude Code 導入・安全設定・使い方ガイド」の内容を、記事として読みやすくまとめました。インストールから権限モード・サンドボックス・日々の使い方まで、安全に始めるための実践ガイドです。

※内容は2026年11月時点の公式ドキュメント(code.claude.com/docs)に基づきます。



1. 導入

Claude Code とは

コードを読み、ファイルを編集し、コマンドを実行して開発を進める、Anthropic のエージェント型コーディングツールです。

  • ターミナル(CLI):最も機能が揃う基本形。どのOSでも同じ操作

  • IDE 拡張:VS Code・JetBrains から使える。差分をエディタで確認

  • デスクトップアプリ:ターミナルなしで使えるGUI版

  • Web:claude.ai/code。Anthropic管理の隔離VMで実行

できることが多い = 「どこまで任せるか」を決めることが安全の第一歩。この記事はターミナル版を中心に説明しますが、権限やサンドボックスの考え方は共通です。

導入前のチェック

  • OS:macOS 13.0 以上 / Windows 10 1809 以上・Server 2019 以上 / Ubuntu 20.04 以上 / Debian 10 以上 / Alpine 3.19 以上

  • ハードウェア:RAM 4GB 以上、x64 または ARM64 プロセッサ

  • ネットワーク:インターネット接続が必須(社内プロキシ環境は事前に確認)

  • アカウント:Pro・Max・Team・Enterprise・Console のいずれか(無料プランは対象外)

  • Windows:ネイティブ(サンドボックス非対応)か WSL 2(サンドボックス対応)を選ぶ。ネイティブでは Git for Windows を推奨

インストール:推奨は公式ネイティブ版

# macOS・Linux・WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  • Homebrew:brew install --cask claude-code(自動更新なし。定期的に upgrade)

  • WinGet:winget install Anthropic.ClaudeCode(自動更新なし。定期的に upgrade)

  • 確認:claude --version / claude doctor(doctor は設定エラーも診断)

ネイティブ版はバックグラウンドで自動更新されるため最新のセキュリティ修正が入ります。npm版も残っていますが、v2.1.198以降はNode.js 22以上が必要です。

安全な導入の5原則

  • 1. 公式の入手先だけを使う:claude.ai の公式スクリプト・Homebrew・WinGet・署名付き apt / dnf / apk。検索広告や非公式ミラーのスクリプトは実行しない

  • 2. 管理者権限で入れない:ネイティブ版は管理者権限不要。sudo npm install -g は禁止(権限問題とセキュリティリスクの原因)

  • 3. 署名を確かめる:macOS は codesign --verify、Windows は Get-AuthenticodeSignature。各リリースの manifest.json は GPG 署名付き

  • 4. 更新を止めない:業務PCは安定版チャネル "stable"(約1週間遅れ、大きな不具合のある版をスキップ)がおすすめ

  • 5. インストールは1つだけ:npm 版とネイティブ版の併存は競合の元。claude doctor で状態を確認し、不要な方を削除

インストールスクリプトをパイプで実行する方式は、入手先が正しいことが前提です。必ず公式ドキュメントからコピーしてください。チャネルは /config の自動更新チャネル、または settings.json の autoUpdatesChannel で設定します。

初回起動と認証

  • STEP 1 フォルダへ移動(cd my-project):ホームディレクトリ直下では起動しない(信頼設定が保存されず毎回確認になる)

  • STEP 2 起動してログイン(claude):ブラウザで認証。APIキーを使う場合は最初に1回承認を求められる

  • STEP 3 信頼を判断する(Trust this folder?):初めてのコードベースと新しいMCPサーバーには信頼確認が出る。中身を知らないリポジトリは信頼しない

  • STEP 4 状態を確認(/permissions):現在の許可ルールを確認。迷ったら claude doctor で診断

認証情報は、macOS はキーチェーン、Windows・Linux はファイル権限で保護されます。

2. 安全な設定

設定ファイルは5階層:上ほど強い

  • Managed(組織):最優先。ユーザーもプロジェクトも上書きできない

  • コマンドライン引数:そのセッションだけの一時設定

  • ローカル .claude/settings.local.json:個人用・Git 管理外(自動で無視設定される)

  • プロジェクト .claude/settings.json:チームで共有・Git にコミット

  • ユーザー ~/.claude/settings.json:自分の全プロジェクトに適用

権限ルールは“合算”:一般の設定値は上の階層が優先しますが、権限ルールは上書きではなく全階層のルールがまとめて効きます。画面では /config で各種設定、/permissions でルールを管理できます。プロジェクト共有設定はリポジトリから来るため、そのallowルールはワークスペースの信頼確認を経てから有効になります。

権限モード:6種類を使い分ける

  • default(Manual):確認なしで動くのは読み取りのみ。機密性の高い作業、初めてのコードに

  • acceptEdits:読み取り+ファイル編集+mkdir・mv・cp など。差分を見ながらの反復作業に

  • plan:読み取り(計画を承認するまで編集しない)。変更前の調査・設計の相談に

  • auto:ほぼすべて(分類器が実行前にチェック)。長いタスク、承認疲れの軽減に

  • dontAsk:事前に許可したツールだけ(他は拒否)。CI・スクリプトでの自動実行に

  • bypassPermissions:すべて(安全確認を省略)。隔離したコンテナ・VM 内のみ

切り替えは Shift+Tab(default → acceptEdits → plan)、起動時の --permission-mode、既定値は permissions.defaultMode で設定します。

重要:Pro・Max・Team では、初期モードが auto

auto は、別のモデル(分類器)が実行前に操作をレビューし、危険な操作を止める仕組みです。便利ですが「自分で全部確認する」モードではありません。

慣れるまでは Manual で始める:~/.claude/settings.json に "defaultMode": "default"

分類器が既定で止める例:

  • curl | bash のようなダウンロード&実行

  • 外部への機密データ送信

  • 本番へのデプロイ・マイグレーション

  • force push、git reset --hard など未コミット変更の破棄

  • IAM・リポジトリ権限の付与

ターミナル版でv2.1.228以降(ネイティブWindowsはv2.1.233以降)、Pro・Max・Teamプランの組み込み開始モードはautoです。EnterpriseとConsoleのAPIキーはManualで始まります。プロジェクト設定ではautoを既定にできません。

許可ルール:deny → ask → allow の順で判定

  • deny(拒否):最優先。一致したら必ずブロック。bypassPermissions でも止まる

  • ask(毎回確認):一致したらどのモードでも確認を求める

  • allow(自動許可):確認なしで実行。ただし安全チェックは先に走る

書き方の例:

  • **Bash(npm run test *)**:npm run test で始まるコマンド

  • Read(./.env):.env ファイルの読み取り

  • WebFetch(domain:docs.example.com):特定ドメインからの取得

  • **Bash(git push *)**:git push 全般

curl・wget などネット取得系は既定で毎回確認になります。また、.git・.vscode・.claude などの保護パスへの書き込みは allow ルールでも自動承認されません。

おすすめの初期設定(~/.claude/settings.json)

{
  "permissions": {
    "defaultMode": "default",
    "deny": [
      "Read(./.env)", "Read(./.env.*)",
      "Read(./secrets/**)", "Read(~/.ssh/**)",
      "Bash(git push --force *)"
    ],
    "ask": ["Bash(git push *)"],
    "allow": ["Bash(npm run lint)", "Bash(npm run test *)"]
  },
  "sandbox": { "enabled": true },
  "autoUpdatesChannel": "stable"
}
  • 1. defaultMode: default:慣れるまでは毎回確認して動きを学ぶ

  • 2. deny:秘密情報の読み取りと force push を封じる

  • 3. ask:push は必ず人が目で確認

  • 4. sandbox・stable:OS レベルの隔離と安定版チャネル

※ Read の deny は Claude のファイルツールに効きます。Bash 経由まで塞ぐにはサンドボックスを併用します(macOS・Linux・WSL2)。これは個人PC向けの出発点です。プロジェクト固有の秘密フォルダはプロジェクトの .claude/settings.json に追加し、テストやLintのコマンド名は自分のプロジェクトに合わせて書き換えてください。

サンドボックス:OS レベルで“できる範囲”を囲う

  • ファイルシステム分離:作業フォルダ外への書き込みをブロック

  • ネットワーク分離:許可したドメインだけに接続。新しいドメインは確認を求める

対応環境:

  • macOS:Seatbelt(追加インストール不要)— 対応

  • Linux・WSL 2:bubblewrap — 対応

  • WSL 1・Windows ネイティブ:非対応

有効化は、セッション内で /sandbox を実行し、自動許可か通常の確認かを選びます。境界内のコマンドは確認なしで動かせるため、承認疲れを減らしながら安全性を保てます。

注意:囲われるのは Bash コマンドのみ。ファイルツール・MCP・hooks まで隔離したいなら Dev Container・Docker・VM でプロセス全体を隔離します。

プロンプトインジェクションと MCP への備え

Web ページ・Issue・README などに仕込まれた指示で AI を操ろうとする攻撃です。仕組みとしての防御に、使う人の習慣を重ねます。

組み込みの防御:

  • 機密操作は明示的な承認が必要

  • Web 取得は別のコンテキストで処理

  • 疑わしいコマンドは許可済みでも再確認

  • ルールに一致しないコマンドは承認待ち(フェイルクローズ)

利用者の心得:

  • 承認前にコマンドと差分を必ず読む

  • 信頼できない内容を Claude に直接パイプしない

  • 外部サービスと連携するスクリプトは VM で実行

  • MCP サーバーは自作か信頼できる提供元のみ

  • 怪しい挙動は /feedback で報告

Anthropic は Directory 掲載前にコネクタを審査しますが、MCP サーバーのセキュリティ監査や管理は行いません(公式ドキュメントより)。

チーム・組織で守るための統制

  • Managed settings:Team・Enterprise は管理コンソール(Admin Settings › Claude Code › Managed settings)から一括配布。MDM やファイル配布も可。ユーザーは上書き不可

  • 危険なモードを封じる:"disableBypassPermissionsMode": "disable" で --dangerously-skip-permissions を無効化。必要なら "disableAutoMode": "disable"(いずれも permissions の中に書く)

  • バージョンを揃える:autoUpdatesChannel で更新チャネルを統一。requiredMinimumVersion で古い版の起動を防ぐ

  • 監視と監査:OpenTelemetry で利用状況を監視。ConfigChange hooks でセッション中の設定変更を監査・ブロック

管理設定ファイルの配置先:macOS /Library/Application Support/ClaudeCode/ ・ Linux/WSL /etc/claude-code/ ・ Windows C:\Program Files\ClaudeCode\

3. 使い方

基本の使い方:5ステップ

  • 1. /init:プロジェクトを読ませて CLAUDE.md を作成

  • 2. plan で相談:Shift+Tab で plan に切り替え、変更前に計画を出させる

  • 3. 計画を承認:内容を読み、直したい点はフィードバック。Ctrl+G で計画を直接編集

  • 4. 実行と確認:表示されるコマンドと差分を確かめながら進める

  • 5. テスト→コミット:テストを通し、git diff を自分の目で確認してから

頼み方のコツ:目的・対象ファイル・完了条件(例:「テストがすべて通ること」)を最初に1回で伝える。

CLAUDE.md:プロジェクトの取扱説明書

# プロジェクト概要
社内向け見積もりアプリ(Next.js)

# コマンド
- テスト: npm test
- Lint: npm run lint

# ルール
- .env と secrets/ には触れない
- 本番DBへの接続は禁止
- 変更後は必ずテストを実行

置き場所:

  • ~/.claude/CLAUDE.md:全プロジェクト共通の自分ルール

  • CLAUDE.md(プロジェクト直下):チームで共有、Git にコミット

  • CLAUDE.local.md:個人用のメモ

CLAUDE.mdは /init で下書きを作り、/memory で編集できます。ただし起動時に読み込まれる“お願い”で強制力はないため、確実に止めたいことは deny ルールで設定します。

よく使うコマンドとキー

スラッシュコマンド:

  • /init:CLAUDE.md を作成

  • /permissions:許可ルールの確認・編集

  • /sandbox:サンドボックスの設定

  • /config:設定画面を開く

  • /model:モデルを切り替え

  • /context:コンテキスト使用量を確認

  • /compact:会話を要約して軽くする

  • /clear:会話をリセット

  • /mcp:MCP サーバーの管理

キー・起動オプション:

  • Shift+Tab:権限モードを切り替え

  • Esc:作業を中断

  • Esc ×2:以前の時点へ巻き戻し

  • Ctrl+G:計画をエディタで編集

  • claude -c:直前の会話を再開

  • claude -r:過去の会話を選んで再開

  • claude -p "…":1回だけ非対話で実行

  • claude doctor:インストールと設定を診断

  • claude update:今すぐ更新

4. まとめ

やってはいけない 6つのこと

  • 普段の PC で --dangerously-skip-permissions:すべての確認が外れる。使うのは隔離したコンテナ・VM だけ

  • sudo で npm インストール:権限トラブルとリスクの元。公式ネイティブ版を使う

  • 知らないリポジトリをすぐ信頼:まず中身を確認。ホーム直下でも起動しない

  • 中身を読まずに Yes を連打:承認疲れは事故の入口。sandbox や allow ルールで確認を減らす

  • .env や鍵を無防備に置く:deny ルールとサンドボックスで読めないようにする

  • 出所不明の MCP サーバーを接続:自作か信頼できる提供元のものだけを使う

導入チェックリスト

  • 公式手順でネイティブ版をインストールした

  • claude --version と claude doctor で確認した

  • 自動更新が有効(業務 PC は stable)

  • 初期の権限モードを決めた(慣れるまで Manual)

  • .env・秘密鍵・認証情報を deny に入れた

  • /sandbox を有効にした(macOS・Linux・WSL2)

  • プロジェクトに CLAUDE.md を用意した

  • 組織は managed settings で bypass を無効化した

仕様は頻繁に更新されるため、運用前に公式ドキュメントで最新情報を確認してください。

公式ドキュメント(日本語)

コメント


bottom of page