referencegrowing

DeepSeek を Claude Code の自動運用ループに組み込む

Claude Code CLI の Anthropic 互換エンドポイントを利用し、role ごとに Claude と DeepSeek を切り替える実装メモ。submodule 運用と並列化の注意点も含む。

概要

run_agent.sh(Claude Code を自動で回すループスクリプト)に プロバイダ切り替え を追加した。 プロンプトファイルの PROVIDER: ディレクティブで role ごとに Claude / DeepSeek を選べる。

  • 秘密情報はプロジェクトルートに置く。submodule(methodology 側)には置かない
  • claude 起動行にだけ env を被せる。グローバル export はしない
  • 既存の Claude 運用は 1 バイトも変わらない(PROVIDER: を書かない role は従来どおり)

背景

Claude Code は ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN を読み取ってバックエンドを決定する。 DeepSeek は Anthropic 互換エンドポイント(https://api.deepseek.com/anthropic)を公開しているため、 この2つの環境変数を差し替えるだけで claude コマンドが DeepSeek を叩く。

スクリプト全体を DeepSeek に置き換えるのではなく、role 単位で振り分けたいというのが今回の要件。 理由は:

  • レビューや設計判断など、Claude の方が品質が安定する role を残したい
  • 大量の単純作業は DeepSeek のコストメリットを活かしたい
  • 「Claude 5 回 → DeepSeek 2 回」のような比率ループを組みたい

設計

ディレクティブの追加

MODEL: と同じ書式で PROVIDER: を追加する。

agents/prompts/example.md
PROVIDER: deepseek
MODEL: deepseek-v4-pro
...

書式ルールは MODEL: と完全に揃える:

  • 行頭(先頭の空白 / <!-- --> / # は無視)から PROVIDER: で始める
  • 大文字小文字は区別しない
  • 値の charset は []A-Za-z0-9._-(角括弧は context suffix 用)
  • ファイル先頭から最初にマッチした1行のみ採用

解決の優先順位

  1. プロンプトファイル内の PROVIDER: 指定
  2. MODEL: の値からの自動判定(deepseek-* → deepseek / claude-*|opus*|sonnet*|haiku* → claude)
  3. 環境変数 DEFAULT_PROVIDER
  4. 既定値 claude

未知の PROVIDER: 値は警告して DEFAULT_PROVIDER にフォールバックする。 黙って claude に落ちると、DeepSeek のつもりが Claude を叩いて課金される事故になる。

env の被せ方

claude 起動行にだけ env プレフィックスを付ける。グローバル export はしない。

Terminal window
# DeepSeek role
ENV_PREFIX=(
env
ANTHROPIC_BASE_URL="$DEEPSEEK_BASE_URL"
ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"
)
# Claude role(残留した env を明示的に遮断)
ENV_PREFIX=(
env
-u ANTHROPIC_BASE_URL
-u ANTHROPIC_AUTH_TOKEN
)
"${ENV_PREFIX[@]}" claude -p "$FULL_PROMPT" "${CLAUDE_OPTS[@]}" ...

グローバル export にしない理由は、DeepSeek role の直後に Claude role へ移ったとき ANTHROPIC_BASE_URL が残留し、素の claude が DeepSeek を叩く事故を防ぐため。 Claude role 側でも -u で明示的に unset しているのは、呼び出し元シェルの env を遮断するため。

実装

lib/model.sh への追加

extract_provider_from_prompt() を extract_model_from_prompt() の隣に追加する。 sed/grep のパイプラインは同一で、キー名だけ変える。書式ルールを揃えることが重要。

Terminal window
extract_provider_from_prompt() {
local file="$1"
local line
line=$(sed -E \
-e 's/<!--//g' \
-e 's/-->//g' \
-e 's/^[[:space:]]*#+[[:space:]]*//' \
-e 's/^[[:space:]]+//' \
"$file" \
| grep -iE '^PROVIDER:[[:space:]]*[]A-Za-z0-9._[-]+' \
| head -n1)
[[ -z "$line" ]] && return 1
local value
value=$(echo "$line" | sed -E 's/^[Pp][Rr][Oo][Vv][Ii][Dd][Ee][Rr]:[[:space:]]*([]A-Za-z0-9._[-]+).*/\1/')
[[ -z "$value" ]] && return 1
echo "$value"
return 0
}

run_agent.sh への追加

resolve_model_for_role() の直後に resolve_backend_for_role() を置き、resolve_model_for_role() の末尾から呼ぶ。 MODEL: が確定した後でないと自動判定ができないため、順序は固定。

Terminal window
resolve_backend_for_role() {
PROMPT_PROVIDER=$(extract_provider_from_prompt "$PROMPT_FILE" || true)
if [[ -z "${PROMPT_PROVIDER:-}" ]]; then
case "$CLAUDE_MODEL" in
deepseek-*) PROMPT_PROVIDER="deepseek" ;;
claude-*|opus*|sonnet*|haiku*) PROMPT_PROVIDER="claude" ;;
*) PROMPT_PROVIDER="$DEFAULT_PROVIDER" ;;
esac
fi
case "$PROMPT_PROVIDER" in
claude|deepseek) ;;
*)
log "WARNING: unknown PROVIDER='${PROMPT_PROVIDER}'. falling back to ${DEFAULT_PROVIDER}"
PROMPT_PROVIDER="$DEFAULT_PROVIDER"
;;
esac
PROVIDER="$PROMPT_PROVIDER"
}

env ファイルの読み込み

cd "$REPO_ROOT" || exit 1 の直後に挿入する。

Terminal window
for _envfile in ".env.agent" ".env.deepseek" ".env.local"; do
if [[ -f "$_envfile" ]]; then
set -a
source "$_envfile"
set +a
echo "INFO: loaded env file: ${_envfile}" >&2
fi
done
unset _envfile

.env.agent(汎用) → .env.deepseek(プロバイダ固有) → .env.local(ローカル上書き)の順で後勝ち。

秘密情報の置き場所

プロジェクトルート直下に置く。submodule 内には置かない。

理由:

  1. submodule は複数プロジェクトで共有するため、秘密情報を入れると流出リスクがある
  2. submodule は独立した Git リポジトリなので、親の .gitignore が効かない
  3. 「秘密情報はルート、汎用ロジックは submodule」が 12-factor 的にも正しい分離

.env.deepseek の最小構成:

Terminal window
# 必須
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx

DEEPSEEK_BASE_URL と DEFAULT_PROVIDER は run_agent.sh 側に既定値があるため、通常は書かない。

セットアップ

agents/methodology/autorun/setup_agents.sh を新規プロジェクトで実行すると、 agents/ 配下のディレクトリ・テンプレート・.gitignore が一発で整う。冪等。

Terminal window
chmod +x agents/methodology/autorun/setup_agents.sh
cd <project-root>
agents/methodology/autorun/setup_agents.sh

作成される構造:

agents/
├── prompts/ # role 定義
├── config/ # rotation.yaml 等
├── state/ # PID・終了理由
├── logs/ # 実行ログ
├── handover/ # 引き継ぎ書
├── remote/ # GitHub 経由の介入点
└── inbox/ # 未整理メモ

.gitignore には .env.agent / .env.deepseek / .env.local を自動追記する。

実行

単発モード

Terminal window
./agents/methodology/autorun/run_agent.sh <role-name>

ローテーションモード

rotation.yaml の preset で role を並べる。書き方は 2 形式ある。

形式 A — フラット sequence(連続実行): 同じ role を複数回書けばその回数だけ連続実行。

presets:
mix:
sequence:
- role: claude-task # Claude
count: 5
- role: deepseek-task # DeepSeek
count: 2

これで「Claude 5 回 → DeepSeek 2 回」のループが回る。

形式 B — グループ反復 groups(交互実行): (step 列) を repeat 回 を表現できる。 交互に回したいときはこちら(sequence では A×5 → B×2 になり、A,B,A,B… にはならない)。

presets:
pair:
groups:
- repeat: 15
steps:
- role: claude-task # Claude
- role: deepseek-task # DeepSeek
- repeat: 1
steps:
- role: reviewer # Claude(振り返りは Claude 固定)

これで「(Claude, DeepSeek) を 15 周 → reviewer 1 回」のループが回る。 groups と sequence は同時に書かない(どちらか片方。両方書くと起動時に loud-fail)。 groups 内の step は count を持たない(繰り返しは group の repeat が担う。書くと loud-fail)。 ネスト(group の中に group)はサポートしない。

★ role ごとに Claude / DeepSeek を切り替えるのは、role のプロンプトファイルの PROVIDER: が担う(同ファイルの「解決の優先順位」参照)。つまり claude-task / deepseek-task は 別々のプロンプトファイルで、PROVIDER: だけが違う。

並列化の注意点

同じ作業ツリーでは並列実行はできない。 env プレフィックスの方法ではなく、run_agent.sh の設計そのものが単一作業ツリー前提のため。

理由:

  1. PID ロックが per-role。同じ role を並列起動すると claim_pid が弾く
  2. safe_pull が単一の作業ツリーに対して git fetch + git merge する。別 role を並列で回すと index.lock 衝突が起きる
  3. state/kill_switch や agent_id カウンタファイルが共有

真面目に並列化するなら git worktree で role ごとに別作業ツリーを切る。

Terminal window
git worktree add ../my-blog-claude -b agent/claude-task
git worktree add ../my-blog-deepseek -b agent/deepseek-task

git worktree は「1つのリポジトリに複数の作業ツリーをぶら下げる」機能。 .git の中身(オブジェクト DB)は共有され、ブランチは worktree ごとに独立。 fetch は 1 箇所で済み、マージは通常のブランチマージと同じ。

worktree 方式の注意点:

  • STATE_DIR / LOG_DIR / HANDOVER_DIR を worktree ごとに分けるか共有するかを先に決める
  • kill_switch は全 worktree で共有したい(緊急停止は全停止したい)ため、絶対パスで外に出す
  • 同じブランチを2つの worktree で同時にチェックアウトすることは Git が禁止している

ただし、まずは 逐次交互 で安定性を確認してから並列化に踏み切るのが安全。 DeepSeek のレートリミット挙動や CLI 出力形式が Claude と違う可能性があり、 classify_rate_limit が誤動作するかもしれない。ログを目視で監視すること。

未検証・注意点

  • DeepSeek のレートリミット検知は未検証。classify_rate_limit は Claude CLI の出力形式(You've hit your session limit · resets ...)に依存している。DeepSeek が同じ書式を出す保証はないので、実験中はログを目視で確認する
  • ANTHROPIC_MODEL は設定しない。--model オプションが優先されるが、グローバルに export すると意図しない role に影響する
  • ANTHROPIC_AUTH_TOKEN を使う。ANTHROPIC_API_KEY は Claude 側の通常キーなので混ぜない
  • env プレフィックスの PID。kill_child "$CLAUDE_PID" は env の PID を殺す。env は通常 execvp でプロセスを置き換えるので実害はないが、ps で claude が残っていないか確認した方がよい

参考

  • Claude Code CLI: --model / --continue / --dangerously-skip-permissions
  • DeepSeek Anthropic 互換エンドポイント: https://api.deepseek.com/anthropic
  • Git worktree: git worktree add / git worktree remove