Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

[SDK] タスク作成で activeForm フィールドが不要になりました — スピナーはタスクサブジェクトにフォールバックします

原文（英語） ​

[SDK] Changed task creation to no longer require the activeForm field — the spinner falls back to the task subject

概要 ​

Claude Code SDKを使用してタスクを作成する際、activeForm フィールドの指定が必要でした。この変更により、activeForm フィールドはオプションになりました。activeForm が指定されていない場合、処理中のスピナーはタスクの subject（サブジェクト/件名）フィールドにフォールバックして表示されます。SDKの使用がよりシンプルになります。

基本的な使い方 ​

javascript
// 修正前: activeForm が必須
const task = await sdk.createTask({
  subject: "コードレビュー",
  activeForm: "form-id-123",  // 必須だった
  // ...
});

// 修正後: activeForm なしでシンプルに作成可能
const task = await sdk.createTask({
  subject: "コードレビュー",
  // activeForm は不要
});
// → スピナーに "コードレビュー" が表示される

実践例 ​

シンプルなタスク作成 ​

javascript
// Claude Code SDK
const { ClaudeCode } = require('@anthropic/claude-code');

// シンプルなタスク作成（activeForm なし）
const task = await ClaudeCode.createTask({
  subject: "TypeScriptファイルのリファクタリング",
  description: "src/utils.ts を最適化してください"
});

// スピナーには "TypeScriptファイルのリファクタリング" が表示される

既存のコードの簡略化 ​

javascript
// 修正前（activeForm が必要だったコード）
const task = await sdk.createTask({
  subject: "テスト実行",
  activeForm: "test-runner-form",
  // ...
});

// 修正後（activeForm を削除してシンプルに）
const task = await sdk.createTask({
  subject: "テスト実行",
  // activeForm は削除しても動作する
});

バッチタスクの作成 ​

javascript
// 複数のタスクをシンプルに作成
const tasks = await Promise.all([
  sdk.createTask({ subject: "タスク1: データ分析" }),
  sdk.createTask({ subject: "タスク2: レポート生成" }),
  sdk.createTask({ subject: "タスク3: 通知送信" }),
]);
// 各タスクのスピナーにそれぞれのsubjectが表示される

注意点 ​

  • activeForm は後方互換性のため引き続き使用できます（削除されたわけではありません）
  • activeForm が指定されていない場合、スピナーは subject フィールドの値を表示します
  • subject も省略された場合のフォールバック動作については、ドキュメントを参照してください

関連情報 ​