claude-code-guide

Claude Code 上級開発ガイド

Claude Code の基礎から上級まで、すべての主要な概念、ツールの使用方法、開発ワークフロー、ベストプラクティスを網羅した総合的な学習ガイドです。

このスキルを使用するタイミング

次のようなサポートが必要なときに、このスキルを使用してください：

• Claude Code の主要な機能とツールを学ぶ
• REPL 環境の高度な使い方を習得する
• 開発ワークフローとタスク管理を理解する
• MCP を使用して外部システムと連携する
• 高度な開発パターンを実装する
• Claude Code のベストプラクティスを適用する
• よくある問題やエラーを解決する
• 大きなファイルを分析して処理する

クイックリファレンス

Claude Code の主要ツール（7つ）

1. REPL - JavaScript ランタイム環境

   • ES6+ を完全サポート
   • プリロード済みライブラリ：D3.js, MathJS, Lodash, Papaparse, SheetJS
   • async/await, BigInt, WebAssembly をサポート
   • ファイルの読み込み：window.fs.readFile()

2. Artifacts - ビジュアル出力

   • React, Three.js, グラフライブラリ
   • HTML/SVG のレンダリング
   • インタラクティブなコンポーネント

3. Web Search - ウェブ検索

   • 米国でのみ利用可能
   • ドメインフィルターをサポート

4. Web Fetch - ウェブページのコンテンツを取得

   • HTML を Markdown に変換
   • コンテンツの抽出と分析

5. Conversation Search - 会話の検索

   • 過去の会話を検索
   • コンテキストを検索

6. Recent Chats - 最近の会話

   • 最近のセッションにアクセス
   • 会話履歴

7. End Conversation - 会話を終了

   • クリーンアップと要約
   • セッション管理

大きなファイルの分析ワークフロー

# 阶段 1：定量评估
wc -l filename.md    # 行数统计
wc -w filename.md    # 词数统计
wc -c filename.md    # 字符数统计

# 阶段 2：结构分析
grep "^#{1,6} " filename.md  # 提取标题层次
grep "```" filename.md       # 识别代码块
grep -c "keyword" filename.md # 关键词频率

# 阶段 3：内容提取
Read filename.md offset=0 limit=50      # 文件开头
Read filename.md offset=N limit=100     # 目标部分
Read filename.md offset=-50 limit=50    # 文件结尾

REPL の高度な使い方

// 数据处理
const data = [1, 2, 3, 4, 5];
const sum = data.reduce((a, b) => a + b, 0);

// 使用预加载库
// Lodash
_.chunk([1, 2, 3, 4], 2);  // [[1,2], [3,4]]

// MathJS
math.sqrt(16);  // 4

// D3.js
d3.range(10);  // [0,1,2,3,4,5,6,7,8,9]

// 读取文件
const content = await window.fs.readFile('path/to/file');

// 异步操作
const result = await fetch('https://api.example.com/data');
const json = await result.json();

スラッシュコマンドシステム

組み込みコマンド：

• /help - ヘルプを表示
• /clear - 会話をクリア
• /plugin - プラグインを管理
• /settings - 設定を構成

カスタムコマンド： .claude/commands/mycommand.md を作成します：

根据需求执行特定任务的指令

使用方法：/mycommand

開発ワークフローのパターン

1. ファイル分析ワークフロー

# 探索 → 理解 → 实现
ls -la                  # 列出文件
Read file.py            # 读取内容
grep "function" file.py # 搜索模式
# 然后实现修改

2. アルゴリズム検証ワークフロー

# 设计 → 验证 → 实现
# 1. 在 REPL 中测试逻辑
# 2. 验证边界情况
# 3. 实现到代码

3. データ探索ワークフロー

# 检查 → 分析 → 可视化
# 1. 读取数据文件
# 2. REPL 中分析
# 3. Artifacts 可视化

主要な概念

ツール権限システム

自動的に権限が付与されるツール：

• REPL
• Artifacts
• Web Search/Fetch
• Conversation Search

承認が必要なツール：

• Bash（ファイルシステムの読み取り／書き込み）
• Edit（ファイルの変更）
• Write（ファイルの作成）

プロジェクトのコンテキスト

Claude は次の情報を自動的に認識します：

• Git リポジトリの状態
• プログラミング言語（ファイル拡張子から）
• プロジェクト構造
• 依存関係の設定

メモリシステム

会話メモリ：

• 現在のセッションに保存
• 200K token のウィンドウ
• コンテキストを自動管理

永続メモリ（実験的）：

• セッションをまたいで保存
• ユーザーの好みを記憶
• プロジェクトのコンテキストを保持

MCP 連携

MCP とは？

Model Context Protocol - Claude を外部システムに接続するプロトコルです。

MCP サーバーの設定

設定ファイル：~/.config/claude/mcp_config.json

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["path/to/server.js"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

MCP ツールの使用

Claude は MCP ツールを自動的に検出し、会話の中で使用します：

"使用 my-server 工具获取数据"

フックシステム

フックの種類

.claude/settings.json で設定します：

{
  "hooks": {
    "tool-pre-use": "echo 'About to use tool'",
    "tool-post-use": "echo 'Tool used'",
    "user-prompt-submit": "echo 'Processing prompt'"
  }
}

よくあるフックの用途

• コードの自動フォーマット
• テストの実行
• Git コミットのチェック
• ログの記録
• 通知の送信

高度なパターン

複数エージェントの連携

Task ツールを使用してサブエージェントを起動します：

"启动一个专门的代理来优化这个算法"

サブエージェントの特徴：

• 独立したコンテキスト
• 単一のタスクに集中
• 結果をメインエージェントに返す

スマートなタスク管理

TodoWrite ツールを使用します：

"创建任务列表来跟踪这个项目"

タスクの状態：

• pending - 保留中
• in_progress - 進行中
• completed - 完了

コード生成パターン

段階的な開発：

1. 基本構造を生成する
2. コア機能を追加する
3. 詳細を実装する
4. テストして最適化する

検証駆動：

1. テストケースを書く
2. 機能を実装する
3. テストを実行する
4. 問題を修正する

品質保証

自動テスト

# 运行测试
npm test
pytest

# 类型检查
mypy script.py
tsc --noEmit

# 代码检查
eslint src/
flake8 .

コードレビューのパターン

サブエージェントを使用してレビューします：

"启动代码审查代理检查这个文件"

レビューの重点項目：

• コード品質
• セキュリティ上の問題
• パフォーマンスの最適化
• ベストプラクティス

エラーからの復旧

よくあるエラーパターン

1. ツールの使用エラー

   • 権限を確認する
   • 構文を検証する
   • パスを確認する

2. ファイル操作エラー

   • ファイルの存在を確認する
   • 読み取り／書き込み権限を確認する
   • パスが正しいことを検証する

3. API 呼び出しエラー

   • ネットワーク接続を確認する
   • API キーを検証する
   • リクエスト形式を確認する

段階的な修正戦略

1. 問題を切り分ける
2. 再現手順を最小限にする
3. 段階的に修正する
4. 解決策を検証する

ベストプラクティス

開発原則

1. 明確さを優先 - 要件と目標を明確にする
2. 段階的に実装 - 手順を分けて開発する
3. 継続的に検証 - 頻繁にテストする
4. 適切に抽象化 - 適切にモジュール化する

ツール使用の原則

1. 適切なツールを選ぶ - 用途に合ったツールを選択する
2. ツールを組み合わせる - 複数のツールを連携させる
3. 権限を最小限にする - 必要な権限のみを要求する
4. エラーを処理する - 失敗を適切に処理する

パフォーマンスの最適化

1. 一括操作 - 複数の操作をまとめる
2. 増分処理 - 大きなファイルを処理する
3. 結果をキャッシュ - 重複する計算を避ける
4. 非同期処理を優先 - async/await を使用する

セキュリティ上の考慮事項

サンドボックスモデル

各ツールは隔離された環境で実行されます：

• REPL：ファイルシステムへのアクセスなし
• Bash：明示的な承認が必要
• Web：特定のドメインのみ

セキュリティのベストプラクティス

1. 最小権限 - 必要な権限のみを付与する
2. コードレビュー - 生成されたコードを確認する
3. 機密データ - キーを共有しない
4. 定期的な監査 - フックと設定を確認する

トラブルシューティング

ツールを使用できない

症状： ツール呼び出しに失敗する

解決策：

• 権限設定を確認する
• 構文が正しいことを検証する
• ファイルパスを確認する
• エラーメッセージを確認する

REPL のパフォーマンス問題

症状： REPL の実行が遅い

解決策：

• データ量を減らす
• ストリーム処理を使用する
• アルゴリズムを最適化する
• バッチ処理する

MCP 接続の失敗

症状： MCP サーバーが応答しない

解決策：

• 設定ファイルを確認する
• サーバーが実行中であることを検証する
• 環境変数を確認する
• サーバーログを確認する

実用例

例 1：データ分析

// 在 REPL 中
const data = await window.fs.readFile('data.csv');
const parsed = Papa.parse(data, { header: true });
const values = parsed.data.map(row => parseFloat(row.value));
const avg = _.mean(values);
const std = math.std(values);
console.log(`平均值: ${avg}, 标准差: ${std}`);

例 2：ファイル検索

# 在 Bash 中
grep -r "TODO" src/
find . -name "*.py" -type f

例 3：ウェブデータの取得

"使用 web_fetch 获取 https://api.example.com/data 的内容，
然后在 REPL 中分析 JSON 数据"

参考ファイル

このスキルには詳細なドキュメントが含まれています：

• README.md（9,594 行）- Claude Code 上級ガイドの全内容

以下のトピックを含みます：

• 主要ツールの詳細な解説
• REPL の高度な連携パターン
• 開発ワークフローの詳細
• MCP 連携の完全ガイド
• フックシステムの設定
• 高度なパターンとベストプラクティス
• トラブルシューティングとセキュリティ上の考慮事項

view コマンドを使用して参考ファイルを表示し、詳細を確認してください。

リソース

• GitHub リポジトリ: https://github.com/karminski/claude-code-guide-study
• 原版: https://github.com/Cranot/claude-code-guide
• Anthropic 公式ドキュメント: https://docs.claude.com

注意事項

このガイドは、以下の内容を組み合わせています：

• 公式の機能と発表
• 実際の使用を通じて確認されたパターン
• 概念的なアプローチとベストプラクティス
• サードパーティ製ツールとの連携

使用する際は、最新の公式ドキュメントを参照してください。

---

このスキルを活用して、Claude Code の強力な機能を深く習得しましょう！