Claude Codeの並列session: 分離とhandoff

並列化は独立taskだけに有効です。同じfileを二つの変更が必要とするなら、一人のownerを決めて順番に進めます。別API workflowではBetterToken Claude Codeガイドで自分のAPI Keyを設定できますが、これはClaude.ai subscriptionでもshared accountでもありません。

taskとfileを対応付ける

task	許可範囲	完了条件
空のamount	parser/, tests/import/	validation errorを返す
--dry-run	cmd/, tests/cli/	plan表示、dataを書かない

共通fileは並列開始を止めるsignalです。

worktreeを作る

git status --short
git worktree add ../project-fix-empty-amount -b fix/empty-amount
git worktree add ../project-cli-dry-run -b feat/cli-dry-run

未知の変更を隠したり捨てたりしません。worktreeはfilesとbranches、sessionはcontextを分けますが、conflictは解決しません。

promptの境界を固定する

許可directory、禁止事項、test commandを指定します。共通のparser/schema.tsが必要になったら、黙って編集せずblockerとして停止します。

handoff契約を書く

Task: empty amount returns validation error
Worktree / branch: ../project-fix-empty-amount / fix/empty-amount
Changed: parser/amount.ts, tests/import/empty-amount.test.ts
Verified: npm test -- tests/import/empty-amount.test.ts
Not verified: full integration suite
Next: review diff before merge

chat transcriptではなくstateと再現commandを渡します。

検証とrollback

git status --short
git diff --check
npm test -- tests/import/empty-amount.test.ts

受け手はworktreeに入り、このcommandを再実行します。再現できなければ未検証です。変更を戻すかownerへ返します。

Git、権限、secret

overlap時はownerが両diffを読み、一つのbranchへ統合して両testを実行します。範囲外への一括permissionを与えません。API Key、cookie、.env、個人データ、完全なsensitive logをhandoffやcommitに入れません。

CTAとsources

現行ガイドで自分のKeyだけを設定し、secretは通常のsecret mechanismで渡してください。

• Claude Code documentation
• Git worktree documentation