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 など
データポリシー (学習利用等)
コンプライアンス

システム要件

項目	要件
OS	macOS 13.0+ / Ubuntu 20.04+ / Debian 10+ / Windows 10+（WSL 1・2 または Git for Windows）
RAM	4 GB 以上
ネットワーク	インターネット接続必須
シェル	Bash または Zsh 推奨
利用可能地域	Anthoropicサポート国

デフォルト動作について

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

1. コンテキストの収集

2. アクションの実行

3. 結果の検証

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

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

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

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

拡張機能	説明
Skills	Claude の知識・ワークフローを拡張。これ毎回やってるなーとかの提携作業をSkillsとして切り出すと便利
MCP	外部サービス（Notion / Figma / DB 等）と接続
Hooks	シェルコマンドを登録してワークフローを自動化
Subagents	タスクを独立したコンテキストウィンドウにオフロード
Agent teams	複数エージェントを協調して動作させることで1つのチームとして動かす、みたいなことができたりする
Plugins / Marketplace	プラグインエコシステム

その他、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`	インタラクティブモードを開始
`claude "task"`	1回限りのタスクを実行	`claude "fix the build error"`
`claude -p "query"`	1回限りのクエリを実行して終了	`claude -p "explain this function"`
`claude -r`	前の会話を再開	`claude -r`以外に `claude -c`で最新の会話セッションを続行できます
`claude mcp add`	MCPサーバーの追加
`exit`または`Ctrl+C`	終了

ショートカット

ショートカット	機能
`?`	利用可能なキーボードショートカットを表示
`/`	スラッシュコマンドを表示。 `/help`:ヘルプ `/hook`:フックの使用 `/clear`:会話履歴をクリア `/model`:モデルの切り替えなど
`Shift + Tab`	権限モード切替
`Esc`	途中停止（コンテキストは保持）
`Esc × 2`または `/rewind`	以前の状態に巻き戻し
`Ctrl + G`	設定したIDEを開く（後述）

ここまでが基本です。

カスタム

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

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

`/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フックだけでなく、他にもあります。

イベント	タイミング	主な用途
PreToolUse	ツール実行前	危険コマンド禁止・権限チェック
PostToolUse	ツール実行後（成功時）	自動整形・lint・ログ
PostToolUseFailure	ツール実行後（失敗時）	エラー通知・リカバリ
Stop	エージェントが一区切りした時	最終コミット・CI トリガー

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

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

/btw <question>

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

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

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

#!/bin/sh

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

if [ -n "$COMMIT_SOURCE" ]; then exit 0; fi

DIFF=$(git diff --cached)
if [ -z "$DIFF" ]; then exit 0; fi

if ! command -v claude >/dev/null 2>&1; then exit 0; fi

MSG=$(echo "$DIFF" | claude --no-session-persistence \
  --model claude-haiku-4-5-20251001 --print -p \
  "以下のgit diffを見て、コミットメッセージを1行で生成してください。
プレフィックスはfeat/fix/docs/style/refactor/perf/test/choreから選択してください。
フォーマット: <prefix>: <内容>（日本語）
メッセージのみ出力し、他の文章は一切含めないでください。
$(cat)")

if [ -n "$MSG" ]; then
  echo "$MSG" > "$COMMIT_MSG_FILE"
fi

権限付与

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

~/.gitconfigに追記

[core]
    hooksPath = ~/.git-hooks

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

コマンド	実行内容
`git commit`	Claude がメッセージを自動生成。エディタで確認・編集してコミット
`git commit -m "msg"`	フックをスキップしていつも通り使えます。指定メッセージでコミット
`git co`	Claude Code の `/commit` スキルを呼び出し

音声入力

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

/voiceで利用できます。

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

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

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

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

おわりに

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

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

HTNCode

おーたに