Claude Code初期設定ガイド - CLAUDE.mdと設定ファイルの活用

1
2

cd your-project
claude

1

> /init

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# プロジェクト概要

このプロジェクトは、Next.js 15とTypeScriptで構築されたECサイトのフロントエンドです。

## 技術スタック

- フレームワーク: Next.js 15 (App Router)
- 言語: TypeScript 5.4
- スタイリング: Tailwind CSS 4.0
- 状態管理: Zustand
- テスト: Vitest + Testing Library

## よく使うコマンド

- `npm run dev` - 開発サーバー起動
- `npm run build` - プロダクションビルド
- `npm run test` - テスト実行
- `npm run lint` - ESLintによる静的解析
- `npm run type-check` - TypeScriptの型チェック

## コーディング規約

- コンポーネントはPascalCaseで命名する
- カスタムフックは`use`プレフィックスを付ける
- APIレスポンスの型は`src/types/api/`に定義する
- 定数は`src/constants/`に配置する

## ディレクトリ構造

~~~text
src/
├── app/           # App Routerのページ
├── components/    # 共通コンポーネント
├── features/      # 機能別モジュール
├── hooks/         # カスタムフック
├── lib/           # ユーティリティ
├── stores/        # Zustandストア
└── types/         # 型定義

1
2
3
4
5
6
7
8
9

## ビルドとデプロイ

- 本番ビルド: `npm run build`
- ステージング: `npm run build:staging`

## テスト

- ユニットテスト: `npm run test:unit`
- E2Eテスト: `npm run test:e2e`

1
2
3
4
5
6

プロジェクトの概要は@READMEを参照してください。
利用可能なnpmコマンドは@package.jsonを確認してください。

# 追加の指示
- Gitワークフロー: @docs/git-workflow.md
- APIドキュメント: @docs/api-spec.md

1
2

# 個人設定
- @~/.claude/my-project-instructions.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

your-project/
├── .claude/
│   ├── CLAUDE.md           # メインの指示
│   └── rules/
│       ├── code-style.md   # コーディング規約
│       ├── testing.md      # テスト規約
│       ├── security.md     # セキュリティ要件
│       └── frontend/
│           ├── react.md    # React固有のルール
│           └── styles.md   # スタイリング規約

1
2
3
4
5
6
7
8
9

---
paths: src/api/**/*.ts
---

# API開発ルール

- すべてのAPIエンドポイントには入力バリデーションを含める
- 標準のエラーレスポンス形式を使用する
- OpenAPIドキュメントコメントを含める

1
2
3
4
5
6
7
8

---
paths: src/**/*.{ts,tsx}, tests/**/*.test.ts
---

# TypeScript/Reactルール

- 型アノテーションは明示的に記述する
- any型の使用を避ける

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  },
  "model": "claude-sonnet-4-5-20250929",
  "language": "japanese"
}

1
2
3
4
5
6
7

{
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*",
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1"
  }
}

1
2
3

{
  "language": "japanese"
}

1
2
3
4
5
6

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: Claude <claude@anthropic.com>",
    "pr": ""
  }
}

1
2
3
4
5
6

{
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "WebFetch",
      "Bash(curl:*)",
      "Read(./.env)"
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
  "permissions": {
    "allow": [
      "Bash(npm run:*)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(sudo:*)"
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)"
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "permissions": {
    "allow": [
      "Edit(./src/**)",
      "Write(./src/**)"
    ],
    "deny": [
      "Edit(./package-lock.json)",
      "Write(./dist/**)"
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "permissions": {
    "allow": [
      "WebFetch(https://api.example.com/*)"
    ],
    "deny": [
      "WebFetch(https://internal.company.com/*)"
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./.env.local)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./.aws/**)",
      "Read(./.ssh/**)",
      "Read(./build)"
    ]
  }
}

1
2
3
4
5

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

1
2
3
4
5
6
7
8

{
  "permissions": {
    "additionalDirectories": [
      "../shared-lib/",
      "../docs/"
    ]
  }
}

1

> /allowed

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"],
    "network": {
      "allowUnixSockets": ["/var/run/docker.sock"],
      "allowLocalBinding": true
    }
  }
}

1

> /config

1

> /memory

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "language": "japanese",
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)"
    ]
  }
}

1
2
3
4
5

# 個人の開発スタイル

- コメントは日本語で記述する
- テストは必ずユニットテストから始める
- コミットメッセージはConventional Commitsに従う

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
  "permissions": {
    "allow": [
      "Bash(npm run:*)",
      "Bash(npx:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "NODE_ENV": "development"
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# プロジェクト開発ガイド

## コーディング規約
@docs/coding-standards.md

## APIドキュメント
@docs/api-spec.md

## よく使うコマンド
- 開発サーバー: `npm run dev`
- テスト: `npm run test`
- リント: `npm run lint`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "permissions": {
    "deny": [
      "Bash(curl:*)",
      "Bash(wget:*)",
      "WebFetch"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "forceLoginMethod": "console"
}

1

> /config

1

> /memory

1
2
3
4
5
6
7

# macOS / Linux
rm -rf ~/.claude
rm ~/.claude.json

# プロジェクト固有の設定
rm -rf .claude
rm -f CLAUDE.md CLAUDE.local.md