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: を追加する。
PROVIDER: deepseekMODEL: deepseek-v4-pro...書式ルールは MODEL: と完全に揃える:
- 行頭(先頭の空白 /
<!-- -->/#は無視)からPROVIDER:で始める - 大文字小文字は区別しない
- 値の charset は
[]A-Za-z0-9._-(角括弧は context suffix 用) - ファイル先頭から最初にマッチした1行のみ採用
解決の優先順位
- プロンプトファイル内の
PROVIDER:指定 MODEL:の値からの自動判定(deepseek-*→ deepseek /claude-*|opus*|sonnet*|haiku*→ claude)- 環境変数
DEFAULT_PROVIDER - 既定値
claude
未知の PROVIDER: 値は警告して DEFAULT_PROVIDER にフォールバックする。
黙って claude に落ちると、DeepSeek のつもりが Claude を叩いて課金される事故になる。
env の被せ方
claude 起動行にだけ env プレフィックスを付ける。グローバル export はしない。
# DeepSeek roleENV_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 のパイプラインは同一で、キー名だけ変える。書式ルールを揃えることが重要。
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: が確定した後でないと自動判定ができないため、順序は固定。
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 の直後に挿入する。
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 fidoneunset _envfile.env.agent(汎用) → .env.deepseek(プロバイダ固有) → .env.local(ローカル上書き)の順で後勝ち。
秘密情報の置き場所
プロジェクトルート直下に置く。submodule 内には置かない。
理由:
- submodule は複数プロジェクトで共有するため、秘密情報を入れると流出リスクがある
- submodule は独立した Git リポジトリなので、親の
.gitignoreが効かない - 「秘密情報はルート、汎用ロジックは submodule」が 12-factor 的にも正しい分離
.env.deepseek の最小構成:
# 必須DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxDEEPSEEK_BASE_URL と DEFAULT_PROVIDER は run_agent.sh 側に既定値があるため、通常は書かない。
セットアップ
agents/methodology/autorun/setup_agents.sh を新規プロジェクトで実行すると、
agents/ 配下のディレクトリ・テンプレート・.gitignore が一発で整う。冪等。
chmod +x agents/methodology/autorun/setup_agents.shcd <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 を自動追記する。
実行
単発モード
./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 の設計そのものが単一作業ツリー前提のため。
理由:
- PID ロックが per-role。同じ role を並列起動すると
claim_pidが弾く safe_pullが単一の作業ツリーに対してgit fetch+git mergeする。別 role を並列で回すとindex.lock衝突が起きるstate/kill_switchや agent_id カウンタファイルが共有
真面目に並列化するなら git worktree で role ごとに別作業ツリーを切る。
git worktree add ../my-blog-claude -b agent/claude-taskgit worktree add ../my-blog-deepseek -b agent/deepseek-taskgit 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