ClaudeCodeの設定・カスタマイズ完全ガイド【おすすめ設定も紹介】

ClaudeCodeはインストールしてすぐ使えますが、設定をカスタマイズすることで格段に使いやすくなります。この記事では、ClaudeCodeの設定方法をCLAUDE.md・環境変数・MCPの3つの観点から解説します。

ClaudeCodeのインストールがまだの方は ClaudeCodeのインストール方法 を先にご確認ください。

---

ClaudeCodeの設定の全体像

ClaudeCodeには主に3種類の設定方法があります。

設定方法	何を設定するか	適用範囲
CLAUDE.md	AIへの指示・ルール・プロジェクト情報	プロジェクトごと or グローバル
環境変数	APIキー・動作オプション	システム全体
MCP設定	外部ツールとの連携	プロジェクトごと or グローバル

それぞれ順番に説明します。

---

CLAUDE.md の設定

CLAUDE.mdは、ClaudeCodeに「このプロジェクトについて知っておいてほしいこと」や「作業のルール」を書き込むファイルです。毎回同じことを説明する手間が省けます。

CLAUDE.mdを置く場所

CLAUDE.mdは2種類の場所に置けます。

1. プロジェクトフォルダのルート（プロジェクト固有の設定）

my-project/
  ├── CLAUDE.md   ← ここに置く
  ├── src/
  └── package.json

2. ホームディレクトリ（全プロジェクト共通の設定）

~/.claude/CLAUDE.md

グローバルな設定（あなたの好みや共通ルール）はホームディレクトリに、プロジェクト固有の情報はプロジェクトルートに書くのがベストプラクティスです。

CLAUDE.mdの書き方

CLAUDE.mdは普通のマークダウンファイルです。AIへの指示を自然な文章または箇条書きで書きます。

基本的なプロジェクト情報の例:

# プロジェクト概要

このプロジェクトはNext.jsで作られたWebアプリです。
Cloudflare Workersでホスティングし、D1データベースを使っています。

## 技術スタック
- フレームワーク: Next.js 15
- 言語: TypeScript
- スタイリング: Tailwind CSS
- データベース: Cloudflare D1

## コーディングルール
- コンポーネントはfunctionコンポーネントで書く
- 型定義は必ずTypeScriptの型を使う
- コメントは日本語で書く
- エラーハンドリングを必ず行う

## 注意事項
- APIキーは環境変数から読み取ること（直書き禁止）
- mainブランチへの直接pushは禁止

おすすめのCLAUDE.md設定項目

非エンジニア・初心者向けの便利な設定:

## 私について
私はプログラミング初心者です。
専門用語を使う場合は、括弧内に簡単な説明を加えてください。
コードを書いたり変更したりする際は、何をしているか日本語で説明してください。

## 作業スタイル
- 変更を加える前に、何をするか必ず説明してください
- エラーが発生した場合は、原因と対処法を分かりやすく教えてください
- 複数の方法がある場合は、一番シンプルな方法を選んでください

チーム開発向けの設定:

## ブランチ戦略
- 新機能: feature/機能名
- バグ修正: fix/バグ内容
- mainブランチへの直接pushは禁止

## コミットメッセージ規約
- feat: 新機能追加
- fix: バグ修正
- docs: ドキュメント変更
- refactor: リファクタリング

---

環境変数の設定

環境変数は、APIキーなどの秘密情報や動作オプションを設定するための仕組みです。ソースコードに直接書いてはいけない情報を安全に管理できます。

Anthropic APIキーの設定

ClaudeCodeを使うにはAnthropicのAPIキーが必要です。APIキーは環境変数として設定します。

Macの場合（.zshrcまたは.bashrcに追加）:

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"

設定後、ターミナルを再起動するか以下を実行します:

source ~/.zshrc

設定が正しくできているか確認:

echo $ANTHROPIC_API_KEY

APIキーが表示されれば設定完了です。

その他の便利な環境変数

# デフォルトで使用するモデルを指定
export ANTHROPIC_MODEL="claude-opus-4-5"

# 最大トークン数を設定（長い回答を生成させたい場合）
export CLAUDE_MAX_TOKENS=8192

# ターミナルの出力に色をつける
export FORCE_COLOR=1

.envファイルを使う方法

プロジェクトごとに環境変数を管理したい場合、.envファイルを使います。ただし、.envファイルは絶対にGitにコミットしないよう注意が必要です。

# .env ファイルの内容
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx

.gitignoreに必ず追加してください:

.env
.env.local
.env.*.local

---

MCP（Model Context Protocol）の設定

MCPは、ClaudeCodeが外部のツールやサービスと連携するための仕組みです。例えば、ブラウザを操作したり、データベースに直接アクセスしたり、Slackにメッセージを送ったりできるようになります。

MCPとは何か（わかりやすく説明）

MCPを使わない場合、ClaudeCodeはあなたのパソコンのファイルしか読み書きできません。MCPを使うと、外部のサービスやツールとClaudeCodeをつなぐ「橋」ができて、できることが大幅に広がります。

MCPの設定ファイルの場所

MCP設定は ~/.claude.json（グローバル）または プロジェクトの .claude/settings.json に書きます。

基本的なMCP設定の書き方

{
  "mcpServers": {
    "サーバー名": {
      "command": "実行コマンド",
      "args": ["引数1", "引数2"],
      "env": {
        "環境変数名": "値"
      }
    }
  }
}

おすすめのMCPサーバー設定例

ブラウザ操作（Playwright）:

ブラウザを自動操作して、Webスクレイピングや画面操作ができます。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

ファイルシステム操作の拡張:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/あなたのユーザー名/Documents"
      ]
    }
  }
}

GitHub連携:

GitHubのIssueやPull Requestを操作できるようになります。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

MCPの設定を確認する

ClaudeCodeを起動して以下を実行すると、設定されているMCPサーバーを確認できます:

claude mcp list

---

ClaudeCodeのコマンドラインオプション

よく使うオプションをまとめました。

オプション	説明	使用例
--model	使用するモデルを指定	claude --model claude-opus-4-5
--no-stream	ストリーミング出力を無効化	claude --no-stream "質問"
--print	出力をファイルに保存	claude --print "質問" > output.txt
--dangerously-skip-permissions	権限確認をスキップ（要注意）	自動化スクリプトで使用

---

おすすめのカスタマイズ設定まとめ

初心者向け・非エンジニア向けの最適設定

CLAUDE.mdに書く内容:

# 基本ルール

## 私について
- プログラミング初心者です
- 専門用語には必ず説明を加えてください
- 操作手順は細かく教えてください

## 作業のお願い
- コードを変更する前に、変更内容を必ず日本語で説明してください
- エラーが出たときは「何が起きているか」「どう直すか」を教えてください
- 複数の選択肢がある場合は、メリット・デメリットを比較してください

## やってはいけないこと
- APIキーやパスワードをコードに直接書かない
- 確認なしに大きな変更を加えない

生産性を上げる設定

エイリアスの設定（Macの場合 ~/.zshrcに追加）:

# よく使うClaudeCodeコマンドを短縮
alias cc="claude"
alias ccf="claude --dangerously-skip-permissions"

# プロジェクトを素早く開始
alias new-project="mkdir -p"

---

よくある設定ミスと対処法

CLAUDE.mdが反映されない

原因: ファイルの場所が間違っている可能性があります。

対処法: プロジェクトのルートディレクトリ（package.jsonやREADME.mdと同じ場所）にCLAUDE.mdを置いてください。

環境変数が読み込まれない

原因: ターミナルを再起動していない、またはシェルの設定ファイルが違う可能性があります。

対処法:

# zshを使っている場合
source ~/.zshrc

# bashを使っている場合
source ~/.bashrc

MCPサーバーが起動しない

原因: 必要なパッケージがインストールされていない可能性があります。

対処法:

# Node.jsとnpmが入っているか確認
node --version
npm --version

# MCPサーバーを手動でインストール
npm install -g @modelcontextprotocol/server-filesystem

---

まとめ

ClaudeCodeの設定方法を3つの観点で解説しました。

• CLAUDE.md: プロジェクト情報や作業ルールをAIに伝える最も重要な設定。まずここから始めましょう。
• 環境変数: APIキーなどの秘密情報を安全に管理するために必須。ソースコードには絶対書かないこと。
• MCP: ブラウザ操作・GitHub連携など外部ツールとの連携を実現する高度な設定。慣れてきたら試してみましょう。

特にCLAUDE.mdの設定は、毎回同じことを説明する手間が省けて作業効率が大幅に上がります。まずはCLAUDE.mdから設定を始めてみてください。

関連記事: ClaudeCodeのよくあるエラーと解決策 | ClaudeCodeとは？基本的な使い方