Claude Code 導入・機能ガイド

この記事は私がClaude Codeをプライベートで導入する際に、人力でメモしていたものをClaudeCodeでまとめ、それをさらに人力で書き直したものです（結局ほぼ書き直したのでもう人力ですw）。

Claude Code触ったことない！とりあえず触ってみたい！という方の参考になれば幸いです。

参考にしたもの

• 本記事のもとになったメモの参考にさせていただいた方々の記事です。いつも参考にさせていただいています。感謝。
• その他、公式ドキュメントも参照しながらメモを書き溜めていました。
  • Claude Code ベストプラクティスまとめ | みのるん＠minorun365さん
  • Claude Code のリモートコントロールとスマホ通知の始め方 | ぬこぬこさん
  • 【2026年最新版】Claude Codeで行うべきセキュリティ設定 10選 | mirukyさん
  • Claude Codeの使用率がステータスラインに表示できるようになったので表示用のスクリプトを作った話 | 逆瀬川ちゃんさん

Claude Codeとは

• ここはもう語る必要ないかもですが、Claude CodeはAnthropicが提供するターミナルベースの AI アシスタントです。コーディング向けとして出たものですが、コーディングだけにとどまらず、いろんな用途で使うことができます。
• ターミナル / iOS アプリ / デスクトップアプリ / VSCode / JetBrains IDE / GitHub Actions / GitLab CI/CD / Slack / Chrome など幅広い環境で利用可能。
• エンタープライズ向けには Anthropic 公式に加え、Amazon Bedrock・Google Vertex AI・Microsoft Foundryからも利用可能ですが、Bedrock / Vertex AIではメトリクスのクラウド送信が行われないため、LiteLLM の利用等を別途検討する必要があります。

エンタープライズ向けをご検討の方に

私が普段務めている会社はやっとこれから導入・・・という状況なのですが、その時役に立てばなと思って記録していたものを載せておきます。

• エンタープライズデプロイメント概要
• セキュリティ周り (SOC 2 Type 2 / ISO 27001 など
• データポリシー (学習利用等)
• コンプライアンス

システム要件

デフォルト動作について

Claude Code は以下の 3 フェーズ（コア agentic ループ）で動作します。

1. コンテキストの収集

2. アクションの実行

3. 結果の検証

また、デフォルトの組み込みツールも備えています。

• ファイル操作
• 検索
• ウェブ参照
• コードインテリジェンス
  ※型エラー表示・定義へジャンプ・参照検索・LSP（Language Server Protocol。専用プラグイン必要）

Claudeが利用可能なツール一覧

なお、組み込みツールはあくまで基盤的存在であり、以下の拡張でさらに強力に利用できます。

その他、gh・aws・gcloudなどの外部 CLI と連携設定も可能です。

権限・モード

• デフォルト: ファイル編集・シェルコマンドの前に毎回承認を求める
• 自動受け入れ編集: ファイル編集は自動、コマンドは確認あり
• Plan Mode: 読み取り専用ツールのみ使用。実行前にプランを作成して承認できる
• Delegate Mode: agent teammates を通じてのみ作業を調整（agent team がアクティブな場合のみ）

なお、2026/3/12〜 プレビューとしてauto-modeもリリースされました。権限決定を Claude が自動処理するモードで、 --dangerously-skip-permissionsより安全な代替手段とされています。

claude --enable-auto-modeで実行できます。トークン使用量・コスト・遅延がわずかに増加するのと、こちらも当たり前ですが、隔離された環境でのみ使用が推奨されています。

Plan Mode でセッションを開始する場合

以下コマンドを実行。

claude --permission-mode plan

Plan Mode をデフォルトにする場合（.claude/settings.json）

{
  "permissions": {
    "defaultMode": "plan"
  }
}

拡張思考（思考モード）

デフォルトで有効になっています。Opus 4.6 では適応的推論なるものが導入されており、固定の思考トークン予算の代わりに effort level設定に基づいて思考を動的に割り当てます。

委譲の考え方

• 指示するのではなく委譲する。有能な同僚に委譲するようにコンテキストと方向を与え、細部は Claude に任せる。
• どのファイルを読むか・どのコマンドを実行するかを指定する必要はない（まあ実際のところ、当然ながら時と場合によります）

インストール・起動方法

公式ドキュメントに沿ってインストール後、使いたいプロジェクトのディレクトリ内で以下を実行するだけです。

claude

※仮想環境上で使いたい場合は、仮想環境に入ってから claude コマンドを実行すればOKです。

初期設定

/config コマンドを実行

まずはこれから。

/config

参考ドキュメント：

permission等の設定

実行を許可しておきたいものはあとから追加していけばいいですが、許可したくないものの設定や、読まれなくないものなどは特に、使う前に設定しておくことをお勧めします。

参考ドキュメント：

※私が2026/3/21現在設定している settings.jsonは以下です。随時追加していってます。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Write",
      "WebSearch",
      "WebFetch(domain:support.google.com)",
      "Bash(git status *)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git show *)",
      "Bash(git branch *)",
      "Bash(git stash *)",
      "Bash(git ls-files *)",
      "Bash(git rev-parse *)",
      "Bash(git fetch *)",
      "Bash(git remote -v)",
      "Bash(git tag *)",
      "Bash(claude *)",
      "Bash(python *)",
      "Bash(node *)",
      "Bash(npm run *)",
      "Bash(pnpm run *)",
      "Bash(npm test *)",
      "Bash(pnpm test *)",
      "Bash(npx *)",
      "Bash(cat *)",
      "Bash(ls *)",
      "Bash(find *)",
      "Bash(grep *)",
      "Bash(head *)",
      "Bash(tail *)",
      "Bash(wc *)",
      "Bash(mkdir *)",
      "Bash(pwd)",
      "Bash(which *)",
      "Bash(sort *)",
      "Bash(sed *)",
      "Bash(awk *)",
      "mcp__いろいろ",
      "Bash(python3:*)",
      "WebFetch(domain:qiita.com)"
    ],
    "deny": [
      "NotebookEdit",
      "NotebookRead",
      "Bash(git push *)",
      "Bash(git commit *)",
      "Bash(git merge *)",
      "Bash(git rebase *)",
      "Bash(git reset --hard *)",
      "Bash(git clean *)",
      "Bash(git add . *)",
      "Bash(git add -A *)",
      "Bash(git add --all *)",
      "Bash(git checkout *)",
      "Bash(git -C *)",
      "Bash(git --git-dir *)",
      "Bash(git --work-tree *)",
      "Bash(echo *)",
      "Bash(bash -c *)",
      "Bash(cd *)",
      "Bash(rm -rf *)",
      "Bash(rm -r *)",
      "Bash(sudo *)",
      "Bash(dd *)",
      "Bash(mkfs *)",
      "Bash(chmod -R 777 *)",
      "Bash(nc * | bash)",
      "Bash(ncat * | bash)",
      "Bash(telnet * | bash)",
      "Bash(curl * | bash)",
      "Bash(curl * | sh)",
      "Bash(wget * | bash)",
      "Bash(wget * | sh)",
      "Bash(pip *)",
      "Bash(wrangler deploy *)",
      "Bash(wrangler pages *)",
      "Bash(npx wrangler deploy *)",
      "Bash(npx wrangler pages *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(**/*.pem)",
      "Read(**/*.key)"
    ],
    "ask": [
      "Bash(git checkout *)",
      "Bash(git switch *)",
      "Bash(npm install *)",
      "Bash(pnpm install *)",
      "Bash(npm ci *)",
      "Bash(pnpm ci *)"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "env": {
    "EDITOR": "code --wait",
    "VISUAL": "code --wait"
  },
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false,
    "filesystem": {
      "denyRead": ["~/.aws/credentials", "~/.ssh"]
    },
    "network": {
      "allowedDomains": [
        "github.com",
        "*.githubusercontent.com",
        "*.npmjs.org",
        "registry.yarnpkg.com",
        "pypi.org"
      ]
    }
  },
  "enableAllProjectMcpServers": false,
  "language": "Japanese",
  "alwaysThinkingEnabled": false,
  "autoUpdatesChannel": "latest",
  "remoteControlAtStartup": true,
  "voiceEnabled": true,
  "statusLine": {
    "type": "command",
    "command": "python ~/.claude/statusline.py"
  }
}

※上記のうち、statusLineの表示の設定は逆瀬川ちゃんさんの記事を参考にさせていただきました！便利なのでぜひ。

よく使う基本コマンド

完全なリストはCLI リファレンスをご参照ください。

ショートカット

ここまでが基本です。

カスタム

すべては到底書ききれないので、私が普段使ってる中で便利だなーと思っているものをいくつかピックアップしてご紹介します。

CLAUDE.mdの設定

セッション間で Claude に記憶させたい情報を記述するファイル。LLM に生成させると品質低下するとの論文もあったりするので、今のところ手動で記述してます。

ここについては冒頭にご紹介したみのるんさんの記事をご参照ください。とってもわかりやすくまとめてくれています。

Skillsの設定

.claude/skills/<skill-name>/SKILL.md に配置することで /skill-name として呼び出せるようになります。

SKILL.mdの書き方

私はお恥ずかしながら、まだ自作したことはありません。

勉強会などでお話伺うと、こういうのをスキル化すれば便利よ、みたいなのをよくお聞きするので、これ毎回やってるよね、というのが見つかったら自分でぜひ作ってみてください。

https://code.claude.com/docs/ja/skills

忘れがちなやつ

自作したものでないやつは、定期的にアップデートかけましょう。

以下でアップデートできます。

npx skills update

（追記）# ghを導入している方は以下
gh skill update --all

/keybindingsでカスタムキーバインド定義

• 分割キーボードとか使ってる方とかは特に重宝しそうですね。
• ~/.claude/keybindings.json に設定が追加されて、カスタムキーバインドを定義できます。

Ctrl+G で VSCode を開く設定

• 特にこれが便利で使う頻度多いです。ターミナルのみでいいときはいいけど、じっくり集中して触ったりしたい時。

• ~/.claude/keybindings.jsonと~/.claude/settings.jsonのenvセクションに以下を設定すると、VSCodeが開きます。もちろん設定によって他のものも設定可。

~/.claude/keybindings.json

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+g": "chat:externalEditor"
      }
    }
  ]
}

~/.claude/settings.json

{
  "env": {
    "EDITOR": "code --wait",
    "VISUAL": "code --wait"
  }
}

PostToolUse フックを使った自動フォーマット

.claude/settings.jsonに以下を設定。

{

  "hooks": {

    "PostToolUse": [

      {

        "matcher": "Write|Edit|MultiEdit",

        "hooks": [

          {

            "type": "command",

            "command": "npx prettier --write \"$CLAUDE_PROJECT_DIR/$(jq -r '.tool_input.file_path' -)\" || true"

          }

        ]

      }

    ]

  }

}

PostToolUseフックだけでなく、他にもあります。

ちょっとした質問を推論途中で挟みたい時

以下で質問できます。話の本筋をずらしたくない時にでも。

/btw <question>

git commit メッセージを Claude に自動生成させる

コミットメッセージ考えるの面倒だな・・・長すぎず、的確に・・・。これが使えます。文章下手な私にはぴったり。

~/.git-hooks/prepare-commit-msg を作成して実行権限を付与

※2026/3/28 01:08修正：うまくコミットメッセージが生成しきらないケースがあったため、修正しました。

#!/bin/sh
# prepare-commit-msg hook: Claude Code でコミットメッセージを自動生成する
#
# 動作条件:
#   - コミットメッセージが空のとき（通常の git commit）
#   - -m オプション付き / --amend / merge コミットのときはスキップ

COMMIT_MSG_FILE="$1"
COMMIT_SOURCE="$2"

# -m, --amend, merge, squash など既にメッセージがある場合はスキップ
if [ -n "$COMMIT_SOURCE" ]; then
  exit 0
fi

# staged の diff が空ならスキップ
if [ -z "$(git diff --cached --name-only)" ]; then
  exit 0
fi

# claude コマンドが存在しない場合はスキップ
if ! command -v claude >/dev/null 2>&1; then
  exit 0
fi

echo "[Claude] コミットメッセージを生成中..." >&2

# 一時ファイルにdiffとプロンプトを書き込む
TMPFILE=$(mktemp)
trap 'rm -f "$TMPFILE"' EXIT

cat > "$TMPFILE" << &apos;PROMPT_EOF&apos;
以下のgit diffを分析して、コミットメッセージを厳密に1行だけ出力してください。

ルール:
- 出力は必ず「<prefix>: <内容>」の形式1行のみ
- prefixはfeat/fix/docs/style/refactor/perf/test/choreのいずれか
- 内容は日本語の短文
- 説明文・前置き・改行・記号装飾は一切禁止

例: feat: ユーザー認証機能を追加

diff:
PROMPT_EOF

git diff --cached >> "$TMPFILE"

MSG=$(claude --no-session-persistence --model claude-haiku-4-5-20251001 --print < "$TMPFILE" 2>/dev/null)

if [ -n "$MSG" ]; then
  FIRST_LINE=$(echo "$MSG" | head -n 1)
  echo "$FIRST_LINE" > "$COMMIT_MSG_FILE"
  echo "[Claude] メッセージを設定しました: $FIRST_LINE" >&2
fi

権限付与

chmod +x ~/.git-hooks/prepare-commit-msg

~/.gitconfigに追記

[core]
    hooksPath = ~/.git-hooks

これで以下のように使えます。

音声入力

Proプラン以上で利用可。順次展開中とのことでしたが、先日私のところにもきました！便利。

/voiceで利用できます。

リモートコントロールとスマホ通知

スマホ通知までは私はやってませんが、ここの話はぬこぬこさんの記事をご参照ください。

デフォルトで、remote-contorolを有効にしておいて、PCつけっぱにしておけば、外出しても外からスマホで操作できてかなり便利です。
スマホすら手放して（ポッケに入れて）、Bluetoothイヤホンのみで操作したくてちょっと遊んでみたりもしました。ゴミが増えたけど、楽しかったです笑

remote-contorolでQRコード表示などが行えます。

おわりに

ほんとここ1、2年で環境が激変しましたね。。
こういう新しい技術もしっかり使いこなせるようになって、新しい仕事のあり方、仕方を身に着けていきたいと思います。

ということで、来週末、お勉強に行ってきます！ご参加される方よろしくお願いいたします！
（非公開イベントって書いてたので一応掲載控えました）

HTNCode

おーたに