0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

2025年、生成AIを使ってみてどうだった？
@nakai-kento-unionai

【実装ガイド】Claude Code 2.1.29 を使いこなす｜インストールから SubAgent まで

0
Posted at

この記事でできること

  • Claude Codeのインストールと初期設定
  • v2.1.29の新機能（Checkpoint、Sandboxing）の活用
  • CLAUDE.mdによるプロジェクト設定
  • SubAgentの作成と呼び出し
  • よくあるエラーと解決方法

1. 環境構築

動作確認環境

Node.js: 18.0.0+
OS: macOS / Linux / Windows

インストール

npm経由:

npm install -g @anthropic-ai/claude-code

Windows (winget):

winget install Anthropic.ClaudeCode

バージョン確認

claude --version
# 出力例: claude-code 2.1.29

認証

claude

ブラウザが開いてAnthropicアカウントでログインを求められます。

ブラウザが開かない場合:

  • cキーを押してOAuth URLをコピー
  • 手動でブラウザに貼り付け

2. 基本操作

プロジェクトで起動

cd /path/to/your/project
claude

スラッシュコマンド一覧

/help     # ヘルプ表示
/clear    # 会話履歴クリア
/cost     # API使用量確認
/compact  # コンテキスト節約（会話を要約）
/memory   # CLAUDE.md編集
/plan     # プランモード起動
/config   # 設定変更
/doctor   # 問題診断
/stats    # 使用統計

# v2.1.29 新規追加
/rewind   # Checkpointに巻き戻し
/sandbox  # サンドボックスモード切替
/context  # コンテキスト管理
/tasks    # タスクリスト表示

CLIフラグ

# 最新の会話を再開
claude --continue

# 過去のセッションから選択して再開
claude --resume

# 追加ディレクトリのCLAUDE.mdも読み込み
claude --add-dir /path/to/other/project

# GitHub PRにリンクしたセッション再開
claude --from-pr 123

# 非対話モードで実行
claude -p "このプロジェクトの構造を教えて"

# JSON出力
claude -p "すべてのAPIエンドポイントをリスト" --output-format json

3. Checkpoint（巻き戻し機能）

概要

Claude Codeは変更前に自動でCheckpointを作成します。
失敗した変更を簡単に元に戻せます。

使い方

方法1: Escキー2回

Esc × 2

方法2: スラッシュコマンド

/rewind

復元オプション

実行すると以下の選択肢が表示されます：

1. コードのみ復元
2. 会話のみ復元
3. 両方復元

4. Sandboxing（安全実行）

概要

ファイルシステムとネットワークを隔離して、安全にコードを実行します。

有効化

/sandbox

内部実装

OS 技術
macOS Apple Sandbox (sandbox-exec)
Linux Landlock + seccomp

効果:

  • 許可プロンプト84%削減（Anthropic内部テスト）

5. CLAUDE.md の設定

ファイル作成

プロジェクトルートにCLAUDE.mdを作成します。

touch CLAUDE.md

自動生成

/init

Claude Codeがプロジェクトを分析して雛形を生成します。

記述例

# CLAUDE.md

## プロジェクト概要
React + TypeScriptのWebアプリケーション

## 技術スタック
- フロントエンド: React 18 + TypeScript 5
- バックエンド: Node.js + Express
- データベース: PostgreSQL
- 状態管理: Zustand

## コーディング規約
- 関数名はcamelCase
- コンポーネント名はPascalCase
- 日本語コメント推奨

## よく使うコマンド
- テスト: `npm test`
- ビルド: `npm run build`
- リント: `npm run lint`

## 過去の決定事項
- 2025-12-01: 認証はJWTを採用
- 2025-12-15: 状態管理はZustandに統一

書くべきこと / 書かないこと

✅ 書くべき ❌ 書かない
Claudeが推測できないBashコマンド コードを読めばわかること
デフォルトと異なるコードスタイル 言語の標準慣習
テスト実行方法 詳細なAPIドキュメント
アーキテクチャ決定事項 頻繁に変わる情報

6. SubAgent の作成

ディレクトリ構造

.claude/
└── agents/
    ├── security-expert.md
    ├── performance-expert.md
    └── ux-reviewer.md

SubAgent定義例

# .claude/agents/security-expert.md

## Role
You are a security expert specializing in web application security.

## Focus Areas
- OWASP Top 10 vulnerabilities
- Authentication and authorization
- Input validation
- Secure coding practices

## Review Checklist
1. Check for SQL injection risks
2. Verify XSS protection
3. Review authentication flows
4. Check for sensitive data exposure

呼び出し方

サブエージェントを使って、認証システムがトークンリフレッシュを
どう処理しているか調査して

特定のSubAgentを無効化

.claude/settings.local.json:

{
  "disabledTools": ["Task(security-expert)"]
}

7. Agent Skills

ディレクトリ構造

.claude/
└── skills/
    ├── xlsx/
    │   └── SKILL.md
    └── custom/
        └── SKILL.md

人気のSkills

Skill 用途
xlsx Excelファイル操作
docx Wordドキュメント操作
pdf PDF生成・編集
frontend-design モダンUI作成
mcp-builder MCPサーバー構築

8. トラブルシューティング

エラー1: 認証エラー

Error: Authentication failed

原因: トークンの期限切れ、または認証情報の破損

解決方法:

# 認証情報をクリアして再認証
rm -rf ~/.claude
claude

エラー2: Node.jsバージョンエラー

Error: Node.js version 16.x is not supported

原因: Node.js 18未満を使用している

解決方法:

# Node.jsのバージョン確認
node --version

# nvmで最新版をインストール
nvm install 20
nvm use 20

エラー3: コンテキスト超過

Warning: Context usage is at 95%

原因: 会話が長くなりコンテキストが埋まった

解決方法:

# 会話を要約してコンテキスト節約
/compact

# または会話をクリア
/clear

エラー4: Sandboxでの権限エラー

Error: Operation not permitted in sandbox

原因: Sandboxモードで制限されている操作を実行

解決方法:

# サンドボックスを一時的に無効化
/sandbox

エラー5: MCPツール接続エラー

Error: MCP server connection failed

原因: MCPサーバーが起動していない、または設定ミス

解決方法:

# MCPサーバーの状態確認
/doctor

# 設定ファイルを確認
cat ~/.claude/mcp.json

9. 日本語設定

.claude/settings.local.json:

{
  "language": "japanese"
}

10. ベストプラクティス

検証方法を与える

❌ Bad: 「メール検証関数を実装して」

✅ Good: 「validateEmail関数を書いて。
         test@example.comはtrue、invalidはfalse。
         実装後にテスト実行して」

セッション管理

同じエラーで2回修正が失敗した場合:
→ /clear してより具体的なプロンプトで再開

探索→計画→実装

1. /plan でコード調査（変更なし）
2. 実装計画を作成
3. Normal Modeでコーディング
4. PRを作成

まとめ

  • Checkpoint: Esc×2 または /rewind で変更を巻き戻し
  • Sandboxing: /sandbox で安全実行モード
  • CLAUDE.md: /init で自動生成、プロジェクト知識を蓄積
  • SubAgent: .claude/agents/ に専門家エージェントを定義
  • トラブル時: /doctor で診断、/clear でリセット

参考リンク

更新履歴

日付 内容
2026-02-03 初版公開（v2.1.29対応）
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?