Claude Code ガイド

Appearance

原文（日本語） ​

プランモード中にプロアクティブティックが発火する問題を修正しました。

原文（英語） ​

Fixed proactive ticks firing while in plan mode

概要 ​

Claude Code v2.1.41では、プランモード（計画立案フェーズ）で作業している際に、プロアクティブティック（自動的なアクション提案）が誤って発火してしまう問題が修正されました。これにより、プランモード中は計画立案に集中でき、不要な自動アクションによる中断がなくなりました。

問題の背景 ​

プランモードとは ​

プランモードは、コードを書く前に実装計画を立てるフェーズです。このモードでは、ファイルの読み取りや調査は可能ですが、実際のコード変更は行いません。

プロアクティブティックとは ​

プロアクティブティックは、Claude Codeが自動的に次のアクションを提案・実行する機能です。例えば、テストの実行、コミットの提案、ドキュメント更新などです。

発生していた問題 ​

プランモード中（計画を立てている段階）でも、プロアクティブティックが発火し、実装を開始してしまうことがありました。

修正前:

text
# プランモードで計画を立案中
> "新機能の実装計画を作成してください"

Plan Mode: Analyzing codebase...
Plan Mode: Designing architecture...

# 突然プロアクティブティックが発火
🤖 Proactive: I noticed you need tests. Should I write them now?
🤖 Proactive: Files are ready for commit. Creating commit?

# ← プランモード中なのに、実装・コミット提案が来てしまう

修正後:

text
# プランモードで計画を立案中
> "新機能の実装計画を作成してください"

Plan Mode: Analyzing codebase...
Plan Mode: Designing architecture...
Plan Mode: Creating implementation plan...

# プロアクティブティックは発火しない
# 計画立案に集中できる

Plan completed. Ready to implement.

基本的な使い方 ​

プランモードの開始 ​

修正後は、プランモード中はプロアクティブティックが抑制されます。

bash
# プランモードで作業
> "データベーススキーマの変更計画を作成してください"

Entering plan mode...

# 計画立案フェーズ
📋 Analyzing current schema...
📋 Identifying required changes...
📋 Planning migration steps...

# プロアクティブティックは発火しない（修正後）

Plan ready. Approve to proceed with implementation.

実践例 ​

大規模リファクタリングの計画 ​

大規模なリファクタリングを計画する際、実装前にじっくり計画を立てられます。

bash
> "認証システム全体をリファクタリングする計画を立ててください"

Plan Mode: Analyzing authentication flow...
Plan Mode: Identifying dependencies...
Plan Mode: Designing new architecture...

# 修正前: 計画途中で実装提案が来る
🤖 Proactive: Found unused imports. Should I remove them?
🤖 Proactive: Tests are missing. Writing tests?
# ← 計画段階で細かい実装提案が来てしまう

# 修正後: 計画に集中できる
# プロアクティブティックは発火しない

Plan completed:
1. Extract authentication logic to separate module
2. Implement new JWT token handling
3. Update middleware
4. Migrate existing sessions
5. Write comprehensive tests

Approve plan to begin implementation?

新機能の設計フェーズ ​

新機能の設計段階で、アーキテクチャを検討します。

bash
> "リアルタイム通知機能の実装計画を作成してください"

Plan Mode: Researching WebSocket libraries...
Plan Mode: Designing message queue architecture...
Plan Mode: Planning database schema changes...

# 修正後: 設計に集中できる
# 実装提案は計画完了後に

Plan summary:
- WebSocket server setup
- Redis pub/sub for scaling
- Notification table schema
- Client-side event handling

Approve to start implementation?

アーキテクチャレビュー ​

既存コードのアーキテクチャを分析・改善計画を立てる際です。

bash
> "現在のアーキテクチャを分析し、改善計画を立ててください"

Plan Mode: Analyzing project structure...
Plan Mode: Identifying architectural patterns...
Plan Mode: Finding potential improvements...

# 修正前: 分析中に細かい修正提案が来る
🤖 Proactive: Found typo in comment. Fix it?
🤖 Proactive: This file has long lines. Format it?

# 修正後: 分析に集中できる
# 細かい提案は計画完了後に

Architecture analysis complete:
- Current: Monolithic structure
- Issues: Tight coupling, hard to test
- Proposed: Modular architecture with DI
- Benefits: Better testability, maintainability

Proceed with refactoring?

マイグレーション計画 ​

データベーススキーマやAPIのマイグレーション計画を立てる際です。

bash
> "データベースをPostgreSQLからMongoDBに移行する計画を作成してください"

Plan Mode: Analyzing current schema...
Plan Mode: Mapping to document model...
Plan Mode: Planning data migration steps...

# 修正後: 慎重な計画立案が可能
# 実装提案は計画承認後に

Migration plan:
1. Schema mapping (3 days)
2. Data migration scripts (2 days)
3. API adapter layer (2 days)
4. Testing & validation (3 days)
5. Gradual rollout (1 week)

Total estimated time: 3 weeks
Approve plan?

セキュリティ改善の計画 ​

セキュリティ脆弱性の修正計画を立てる際です。

bash
> "セキュリティ脆弱性の修正計画を作成してください"

Plan Mode: Scanning for security issues...
Plan Mode: Prioritizing vulnerabilities...
Plan Mode: Planning remediation steps...

# 修正後: セキュリティ分析に集中
# 修正実装は計画承認後に

Security audit results:
- Critical: SQL Injection (auth module)
- High: XSS vulnerability (user input)
- Medium: Weak password policy
- Low: Missing security headers

Remediation plan:
1. Implement parameterized queries (Critical)
2. Add input sanitization (High)
3. Update password requirements (Medium)
4. Configure security headers (Low)

Approve security fixes?

この修正の利点 ​

計画立案への集中 ​

  • 計画フェーズで実装提案による中断がない
  • アーキテクチャ設計に集中できる
  • じっくり考える時間が確保される

ワークフローの明確化 ​

  • 計画と実装のフェーズが明確に分離
  • 計画承認後に実装開始
  • 段階的なアプローチが可能

品質の向上 ​

  • 十分な計画時間の確保
  • 慎重な設計判断
  • 実装前のレビュー機会

プランモードのワークフロー ​

1. 計画立案フェーズ ​

text
Plan Mode: ✓
- コードベース分析
- 要件整理
- アーキテクチャ設計
- プロアクティブティック: ❌ 抑制

2. 計画レビュー ​

text
Plan completed
- ユーザーレビュー
- 承認・却下判断
- プロアクティブティック: ❌ 抑制

3. 実装フェーズ ​

text
Plan approved → Implementation starts
- コード変更開始
- プロアクティブティック: ✓ 有効
  - テスト実行提案
  - コミット提案
  - ドキュメント更新提案

注意点 ​

  • この修正はプランモード中のみ適用されます
  • 実装フェーズに入ると、プロアクティブティックは通常通り動作します
  • プランモードの開始・終了は自動的に管理されます
  • 手動でプロアクティブティックを無効化することも可能です（設定で）

プロアクティブティックの制御 ​

設定での無効化 ​

bash
# ~/.claude/settings.json
{
  "proactiveTicks": {
    "enabled": true,
    "disableInPlanMode": true,  // デフォルトで有効
    "frequency": "normal"
  }
}

一時的な無効化 ​

bash
# セッション中に一時無効化
> /proactive off

# 再度有効化
> /proactive on

関連情報 ​