AIエージェント入門

【2026年最新】Devin完全ガイド|自律AIエンジニアの5ステップ導入法

【2026年最新】Devin完全ガイド|自律AIエンジニアの5ステップ導入法

この記事の結論

Cognition AIが開発した自律型AIエンジニア「Devin」の導入から実務活用まで徹底解説。API連携・GitHub Actions・PR自動レビューのコード例7つ付き。失敗パターンと回避策も完全網羅。

「タスクを渡したら、あとは完成PRが届く」—— そんな開発ワークフローを実現するのが、Cognition AIが2024年に世界へ公開した自律型AIエンジニア Devin です。

Devinは単なるコード補完ツールではありません。専用のクラウドサンドボックス環境で ターミナル・コードエディタ・ブラウザを自ら操作 し、要件定義から実装・テスト・PRの作成まで、エンジニアが一人でこなすタスクをエンドツーエンドで自律実行します。

本記事では「Devinとは何か」という入門から、API連携・GitHub Actions自動化・実運用のベストプラクティス まで、コード例7つを交えて解説します。「試してみたいが何から手をつければいいかわからない」「どこまで任せられるか判断できない」という方に向けた完全ガイドです。

結論を先に
Devinは「繰り返しの定型実装・PR自動レビュー・バグ修正タスク」に絶大な威力を発揮します。ただし複雑なアーキテクチャ判断や破壊的操作には必ず人間のレビューが必要です。本記事を読めば、Devinを安全に最大活用するための判断基準と実装パターンが手に入ります。

Devinとは何か — 従来のAIコーディングツールとの根本的な違い

Cursor・GitHub CopilotClaude Codeといったツールは、IDE内で開発者の 隣で 動くアシスタントです。開発者がコードを書くそばで補完・提案し、指示に応じて差分を生成します。人間がドライバーで、AIはナビという構図です。

📊 関連比較:主要12ツールを料金・コンテキストウィンドウ・OSS度・用途の4軸で横並びにした【2026年最新】AIエージェントツール完全比較12選|用途・料金・選び方ガイドも併せて参照してください。

Devinはこれとまったく異なる設計思想を持ちます。Devinは開発者から 独立した自律エージェント として動作します。タスクを受け取ると自分専用のクラウドサンドボックスを起動し、計画を立て、コードを書いて実行し、エラーが出れば自力で調査・修正を繰り返し、最終的にPull Requestとして成果物を提出します。開発者はPRをレビューするだけでいい。

Cognition AIのCEO Scott Wu氏はこの思想を「AIをエンジニアチームの同僚として扱う」と表現しています。実際、Linear・Jira・Slackといったプロジェクト管理ツールと統合することで、チケットをアサインするだけでDevinが動き出す運用が現実になっています。

Devinのアーキテクチャ概要

Devinの動作は以下の4層構造で成り立っています。

  • プランニング層:受け取ったプロンプトをステップに分解し、実行計画を立てる
  • 実行環境層:セキュアなクラウドサンドボックス(ターミナル・エディタ・ブラウザ付き)
  • ツール呼び出し層:shell実行・ファイル操作・Webブラウジング・API呼び出し
  • 成果物提出層:GitHub PRとしてコード変更をアウトプット

重要なのは、Devinは実行中にドキュメントを読み、StackOverflowを調べ、エラーログを解析する点です。「コードを書く」だけでなく「調べながら問題を解く」能力がDevinを他のツールと一線を画す存在にしています。

まず試したい「5分即効」セットアップ3選

即効テクニック1:APIでDevinセッションを作成する

最も手軽にDevinを試せるのがAPI経由のセッション作成です。DEVIN_API_KEY を取得して以下のコードを実行するだけで、Devinが自律タスクを開始します。

import os
import requests
import time

# 必要パッケージ: pip install requests
# DEVIN_API_KEY は https://app.devin.ai/settings で取得

DEVIN_API_KEY = os.getenv("DEVIN_API_KEY")

def create_devin_session(task_description: str) -> dict:
    """Devinセッションを作成してタスクを開始する"""
    response = requests.post(
        "https://api.devin.ai/v1/sessions",
        headers={
            "Authorization": f"Bearer {DEVIN_API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": task_description,
            "idempotent": True  # 同一タスクの重複実行を防ぐ
        }
    )
    response.raise_for_status()
    data = response.json()
    print(f"セッション作成成功: {data['session_id']}")
    print(f"進捗確認URL: {data['url']}")
    return data

# 使用例:バグ修正タスクを依頼
session = create_devin_session(
    "リポジトリ https://github.com/your-org/your-repo の issue #42 を修正してください。"
    "修正後はテストが通ることを確認し、PRを作成してください。"
)

このコードを実行すると、DevinがGitHubリポジトリをクローンし、issue #42の内容を解析して修正を開始します。通常5〜30分でPRが届きます。

即効テクニック2:セッションのステータスをポーリングして完了を検知する

長時間タスクを自動化するには、セッションの完了を検知するポーリングロジックが必要です。

def wait_for_session_completion(session_id: str, timeout_minutes: int = 60) -> dict:
    """Devinセッションの完了まで待機し、最終ステータスを返す"""
    timeout = timeout_minutes * 60
    elapsed = 0
    check_interval = 30  # 30秒ごとにチェック

    print(f"セッション {session_id} の完了を待機中...")

    while elapsed < timeout:
        status_response = requests.get(
            f"https://api.devin.ai/v1/sessions/{session_id}",
            headers={"Authorization": f"Bearer {DEVIN_API_KEY}"}
        )
        status_data = status_response.json()
        current_status = status_data.get("status_enum", "unknown")

        print(f"[{elapsed}秒] ステータス: {current_status}")

        # 終了状態の判定
        if current_status in ["finished", "exit"]:
            print("タスク完了!")
            return status_data
        elif current_status in ["error", "failed"]:
            print(f"エラー発生: {status_data.get('error', 'Unknown error')}")
            return status_data
        elif current_status == "blocked":
            print("Devinが人間の入力を待っています")
            # ここで Slack 通知などを送信する
            return status_data

        time.sleep(check_interval)
        elapsed += check_interval

    print("タイムアウト: セッションが時間内に完了しませんでした")
    return {"status_enum": "timeout", "session_id": session_id}

# 実際の使用
result = wait_for_session_completion(session["session_id"])
print(f"最終ステータス: {result['status_enum']}")

即効テクニック3:実行中のDevinに追加指示を送る

Devinが実行中に「やっぱりこの部分もやってほしい」という追加要件が出た場合、セッションを止めずにメッセージを送ることができます。

def send_message_to_devin(session_id: str, message: str) -> bool:
    """実行中のDevinセッションに追加指示を送る"""
    response = requests.post(
        f"https://api.devin.ai/v1/sessions/{session_id}/message",
        headers={
            "Authorization": f"Bearer {DEVIN_API_KEY}",
            "Content-Type": "application/json"
        },
        json={"message": message}
    )
    if response.status_code == 200:
        print(f"メッセージ送信成功: {message}")
        return True
    else:
        print(f"メッセージ送信失敗: {response.status_code}")
        return False

# 実装中のDevinに追加要件を伝える
send_message_to_devin(
    session_id=session["session_id"],
    message="修正が終わったら、必ずユニットテストも追加してください。"
             "カバレッジは80%以上を目標にしてください。"
)

Devinの活用は”3つのモード”で考える

モード 用途 向いているタスク 人間のレビュー頻度
完全自律モード 明確な仕様の定型実装 バグ修正・型エラー修正・テスト追加 PR提出後のみ
協調モード 中程度の複雑さのタスク 新機能追加・リファクタリング 中間確認あり
監視モード アーキテクチャが絡む変更 DB設計変更・API設計変更 各ステップで確認

多くのチームが陥る失敗は「とりあえず全部Devinに投げる」という使い方です。Devinはタスクの明確さに比例してパフォーマンスが上がります。「issue #42を直して」より「issue #42のnull参照エラーを修正し、null チェックをアーキテクチャガイドライン(docs/architecture.md参照)に従って実装してください」のほうが圧倒的に良い結果が得られます。

ユースケース別実装パターン

ユースケース1:GitHub ActionsでPRを自動レビューする

最も費用対効果が高い活用法のひとつが、PRが作成されるたびに自動でDevinがコードレビューを行う仕組みです。Cognition AI公式ブログ(参照日: 2026-06-04)でも推奨されているパターンです。

# .github/workflows/devin-pr-review.yml
name: Devin自動PRレビュー

on:
  pull_request:
    types: [opened, synchronize, reopened]

permissions:
  contents: read
  pull-requests: read
  issues: read

jobs:
  devin-review:
    runs-on: ubuntu-latest
    steps:
      - name: コードをチェックアウト
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: 変更ファイルの取得
        id: pr-files
        run: |
          FILES=$(curl -s 
            -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" 
            "https://api.github.com/repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/files" | 
            jq -r '[.[] | .filename] | @json')
          echo "files=$FILES" >> $GITHUB_OUTPUT

      - name: Devinレビューセッション作成
        env:
          DEVIN_API_KEY: ${{ secrets.DEVIN_API_KEY }}
          PR_NUMBER: ${{ github.event.pull_request.number }}
          REPO: ${{ github.repository }}
          FILES: ${{ steps.pr-files.outputs.files }}
        run: |
          PROMPT="リポジトリ ${REPO} の PR #${PR_NUMBER} をレビューしてください。
          変更ファイル: ${FILES}
          以下の観点でレビューし、GitHubのPRコメントとして投稿してください:
          1. バグ・ロジックエラーの検出
          2. セキュリティの問題(SQLインジェクション、XSS等)
          3. パフォーマンスの懸念事項
          4. コーディング規約への準拠
          各コメントは具体的なファイル名と行番号を含めてください。"

          ESCAPED_PROMPT=$(echo "$PROMPT" | jq -Rs .)
          curl -s -X POST 
            -H "Authorization: Bearer $DEVIN_API_KEY" 
            -H "Content-Type: application/json" 
            -d "{"prompt": $ESCAPED_PROMPT}" 
            "https://api.devin.ai/v1/sessions"

このワークフローを設定すると、PRが作成されるたびにDevinが5〜10分以内にコードレビューコメントを投稿します。セキュリティ問題・パフォーマンス問題・コーディング規約違反を自動で検出できるため、人間レビュアーが本質的な設計議論に集中できます。

ユースケース2:LinearチケットからPRを自動生成するパイプライン

Linear MCP連携(2026年にDevin標準機能として追加)を使うと、Linearチケットを起点にDevinが自律的に実装まで行うパイプラインが構築できます。

import os
import requests
from linear_sdk import LinearClient  # pip install linear-sdk

DEVIN_API_KEY = os.getenv("DEVIN_API_KEY")
LINEAR_API_KEY = os.getenv("LINEAR_API_KEY")

def dispatch_linear_issue_to_devin(issue_id: str) -> str:
    """LinearのissueをDevinに自動アサインしてPR作成まで実行する"""

    # 1. Linearからissue情報を取得
    linear = LinearClient(api_key=LINEAR_API_KEY)
    issue = linear.get_issue(issue_id)

    # 2. Devinへのプロンプトを構築
    prompt = f"""
以下のLinearチケットを実装してPull Requestを作成してください。

タイトル: {issue.title}
説明: {issue.description}
優先度: {issue.priority}
ラベル: {", ".join(issue.labels)}

実装完了後:
1. テストを実行してすべてパスすることを確認する
2. PRに「Fixes Linear: {issue_id}」と記載する
3. Linearチケットのステータスを「In Review」に更新する
"""

    # 3. Devinセッションを作成
    response = requests.post(
        "https://api.devin.ai/v1/sessions",
        headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
        json={"prompt": prompt, "idempotent": True}
    )
    session_data = response.json()

    # 4. LinearチケットにDevinセッションのURLをコメント
    linear.create_comment(
        issue_id=issue_id,
        body=f"Devinがこのチケットの実装を開始しました。n進捗: {session_data['url']}"
    )

    return session_data["session_id"]

ユースケース3:バグ修正の自動化バッチ処理

テストが失敗しているissueを一括でDevinに投げ、並列で修正させるバッチ処理も実用的です。

import concurrent.futures
import os
import requests

DEVIN_API_KEY = os.getenv("DEVIN_API_KEY")
REPO_URL = "https://github.com/your-org/your-repo"

def fix_bug_issue(issue_number: int) -> dict:
    """単一のバグissueをDevinに修正させる"""
    prompt = (
        f"{REPO_URL} の issue #{issue_number} を修正してください。n"
        "1. issue の詳細を読んで原因を特定するn"
        "2. 最小限の変更で修正を実装するn"
        "3. 既存テストが全て通ることを確認するn"
        "4. 修正を説明するPRを作成する"
    )
    response = requests.post(
        "https://api.devin.ai/v1/sessions",
        headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
        json={"prompt": prompt}
    )
    data = response.json()
    print(f"issue #{issue_number} -> セッション {data.get('session_id', 'N/A')}")
    return data

# 修正対象のissue番号リスト(バグラベルがついたもの等)
bug_issues = [42, 51, 67, 89, 103]

# 並列で最大3セッション同時実行(ACU消費に注意)
with concurrent.futures.ThreadPoolExecutor(max_workers=3) as executor:
    results = list(executor.map(fix_bug_issue, bug_issues))

print(f"合計 {len(results)} セッションを起動しました")

5ステップ実装フロー:チームにDevinを本番導入する

  1. APIキー取得とサンドボックスで動作確認
    app.devin.ai/settings でAPIキーを発行し、社内の非重要リポジトリで試験タスクを実行。Devinが自律的にコードを書いてPRを作成する流れを実機で確認します。所要時間は30分程度。
  2. タスク分類基準の策定
    「Devinに任せてよいタスク」「人間が主導すべきタスク」の判断基準をチームで合意します。目安は「明確なテスト基準がある」「破壊的DBオペレーションなし」「既存アーキテクチャの変更なし」の3点がすべてYesなら完全自律で問題ありません。
  3. GitHubリポジトリの接続とアクセス権限設定
    app.devin.ai の設定画面からGitHub組織を接続し、Devinがアクセスするリポジトリと権限範囲を明示的に指定します。最小権限の原則に従い、本番ブランチへの直接pushは禁止に設定することを推奨します。
  4. プロンプトテンプレートの整備
    タスク種別ごとにプロンプトテンプレートを用意します。「何のissueか」「コーディング規約はどこか」「テスト要件は何か」を毎回明示することで、Devinのアウトプット品質が劇的に安定します。チームのWikiやNotionにテンプレートを蓄積しましょう。
  5. ACUモニタリングとコスト管理の仕組み化
    DevinはACU(Agentic Computing Unit)課金で、1 ACU ≒ 15分の自律作業に相当します(Core プランで $2.25/ACU)。Devin API の使用量エンドポイントを定期的にポーリングしてSlackに通知する仕組みを作り、予算を可視化します。

他のAIコーディングツールとの比較

2026年現在、AIコーディングツールは「IDE内アシスタント」「ターミナルエージェント」「完全自律エージェント」の3カテゴリに収束しています。Devinはその中で「完全自律」の代表格です。

ツール カテゴリ 動作場所 自律度 月額(目安) SWE-bench 最適用途
Devin 完全自律 クラウドサンドボックス ★★★★★ $20〜$500+ 13.86%(2024版) バッグ修正・定型実装の自動化
Claude Code ターミナルエージェント ローカル端末 ★★★★☆ API従量課金 80.8%(Opus 4.6) 大規模リファクタリング・複雑なデバッグ
GitHub Copilot IDEアシスタント IDE内 ★★☆☆☆ $10/$19/月 日常のコード補完・提案
Cursor IDEアシスタント IDE内 ★★★☆☆ $20/月〜 コード補完・Composer機能
OpenDevin OSSエージェント セルフホスト ★★★☆☆ 無料(LLM費別) 測定中 コスト重視・カスタマイズ

注目すべきはSWE-benchのスコア差です。Claude Code(Opus 4.6)が80.8%を記録する一方、Devinの自己申告スコアは13.86%(2024年版アーキテクチャ)です。ただしSWE-benchは「コード編集能力」を測るもので、Devinの強みである「エンドツーエンドの自律タスク完遂」とは別の指標です。Devinは計画・ブラウジング・テスト実行・PR作成を含むフルサイクルを一人でこなせる唯一無二の存在で、Claude Codeとは競合というより 補完関係 にあります。

実際、2026年時点で最も生産性が高い開発チームの多くは「日常のコーディングにCursor・大規模タスクにClaude Code・定型自動化にDevin」という三刀流を採用しています。

【要注意】Devinでよくある失敗パターンと回避策

失敗パターン1:曖昧なプロンプトでDevinが迷走する

❌ 悪い例:「パフォーマンスを改善して」

⭕ 良い例:「src/api/user.tsのgetUsersByRegion()関数の実行時間を測定し、N+1クエリがあれば一括取得クエリに書き換えてください。変更前後のDB実行数をコメントに記載してください。」

Devinは指示に忠実ですが、曖昧な指示を受けると「とりあえず動く方向」に最適化します。コーディングスタイルやアーキテクチャのコンテキストがないままDevinが動くと、「動くがチームの慣習に合わない」PRが届きます。プロンプトには対象ファイル・成功基準・参照すべきドキュメントのパスを必ず含めましょう。

失敗パターン2:複雑なデバッグをDevinに丸投げする

❌ 状況:分散システムのレースコンディションが原因の不定期クラッシュをDevinに調査させた

⭕ 正しい対処:Devinには「Sentryのエラーログを取得してくれ」「候補原因をリストアップしてくれ」という情報収集タスクに限定し、原因特定と修正判断は人間が行う

Answer.AIが2025年に実施したDevin評価では20タスク中14件が失敗し、その多くが「複雑なデバッグ・システム間相互作用の理解」を要するタスクでした(参照日: 2026-06-04)。Devinは「問題が明確に定義されている」場合に強く、「問題定義自体が難しい」場合には人間が先にトリアージする必要があります。

失敗パターン3:破壊的操作を含むタスクを監視なしで実行する

❌ やってはいけないこと:「本番DBのuser_sessionsテーブルを全削除して、新しいスキーマで再作成して」を無条件でDevinに実行させる

⭕ 安全なアプローチ:マイグレーションSQLの生成のみDevinに依頼し、実行はエンジニアが確認後に手動で行う

Devinは「危険な操作」であることを自己判断して止まる機能は現時点で限定的です。公式ドキュメントにも「人間のレビューが必須の操作として、本番データベースへの破壊的変更」が明示されています(参照日: 2026-06-04)。タスク設計の段階で「Devinが実行できる範囲」と「人間が確認する範囲」を明示的に分離することが事故防止の鉄則です。

失敗パターン4:ACUコストを把握せずに大量タスクを投入する

❌ 状況:50件のissueを一気にDevinに投げてACU消費が想定の10倍になった

⭕ 正しい管理:セッション作成時にmax_acu_limitパラメータを設定し、タスクごとの上限ACUを明示する

# セッション作成時にACU上限を設定する
response = requests.post(
    "https://api.devin.ai/v1/sessions",
    headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
    json={
        "prompt": "issue #42を修正してください",
        "max_acu_limit": 10  # このタスクはACU10(約2.5時間)まで
    }
)

ACU消費は1タスクあたり平均2〜5 ACUが目安ですが、複雑なタスクやDevinが迷走したケースでは20 ACUを超えることもあります。max_acu_limitを設定することでコスト暴走を防げます。

セキュリティと運用ルール

Devinを本番環境で運用するにあたって、以下のセキュリティ原則を必ず守ってください。

最小権限の原則

DevinのGitHub権限は「特定リポジトリへのread/write」に限定し、「組織全体へのアクセス」は付与しないことを推奨します。app.devin.aiのSettings > Integrationsで接続するリポジトリを個別に選択できます。

プロダクションブランチへの直接pushを禁止

GitHub側でmainブランチのブランチ保護ルールを有効にし、Devinが作成するPRも必ず人間がレビュー・承認してからマージする運用を徹底します。Devinは「PRを作成する」までが役割で、「マージする」のは人間の仕事です。

シークレットの安全な扱い

データベース接続文字列やAPIキーなどのシークレットは、Devinのセッション設定のsession_secretsパラメータ経由で渡します。プロンプト文字列に直接書かないことが鉄則です。

# シークレットはsession_secretsで安全に渡す
response = requests.post(
    "https://api.devin.ai/v1/sessions",
    headers={"Authorization": f"Bearer {DEVIN_API_KEY}"},
    json={
        "prompt": "ステージング環境でDBマイグレーションをテストしてください",
        "session_secrets": [
            {
                "name": "DATABASE_URL",
                "value": os.getenv("STAGING_DB_URL")  # 環境変数から取得
            }
        ]
    }
)

Devinの料金プランと費用対効果の試算

Devinは2026年6月現在、以下3つのプランを提供しています(出典: devin.ai/pricing、参照日: 2026-06-04)。

プラン 月額 ACU単価 向いているチーム
Core(従量課金) $20〜(最低) $2.25/ACU 個人・スタートアップ初期
Team $500/月 $2.00/ACU(250 ACU込み) 5〜20人規模のエンジニアチーム
Enterprise 要問い合わせ ボリューム割引 VPCデプロイ・SAML SSO必要な組織

Teamプランの費用対効果を試算してみましょう。月250 ACUはおよそ60時間分の自律作業に相当します。エンジニア単価を月80万円(時給約5,000円)とすると、60時間分の定型タスク(バグ修正・テスト追加・PRレビュー)を代替できれば、30万円分の工数削減が期待できます。$500(約7.5万円)の投資に対して3〜5倍の効果が出る計算です。

今後のDevinの進化方向

2026年6月のDevinドキュメント(参照日: 2026-06-04)を確認すると、いくつかの注目すべき進化が進行中です。

  • Linear MCP のネイティブ統合:Linearとの連携がより深まり、チケットのステータス更新・コメント投稿が標準機能になりました
  • Classic環境セットアップの廃止(2026年6月30日):新しい環境セットアップに移行が必要です
  • v3 API リリース:devin_modeパラメータで実行モードの切り替え・セッションのリポジトリ名フィルタリングが可能になりました
  • マルチエージェント協調:複数のDevinインスタンスが協調してより大規模なタスクを分担する機能の実験が進んでいます

「自律AIエンジニアが人間を置き換える」という議論がありますが、現実は異なります。Devinの真の価値は「エンジニアが本当に考えるべきこと(設計・プロダクト判断・チームコミュニケーション)に集中できる環境を作る」ことにあります。定型タスクを自動化することで、エンジニアの仕事の質が上がるというのが2026年時点での正しい理解です。

参考・出典

あわせて読みたい関連記事

まとめ:今日から始める3つのアクション

  1. 今日app.devin.ai でアカウントを作成し、非重要リポジトリの小さなバグ修正1件をDevinに依頼してPRの品質を確認する
  2. 今週中:チームで「Devinに任せてよいタスク基準」を3〜5項目で合意し、GitHub ActionsのPR自動レビューを導入する
  3. 今月中:LinearまたはJiraのチケットから自動でDevinセッションを起動するパイプラインを構築し、定型タスクの自動化率を測定する

「AIが同僚として開発チームに参加する」時代は、もう始まっています。Devinを適切な場面で使いこなすことで、あなたのチームの生産性は着実に底上げされます。まず1タスク、Devinに投げてみてください。

この記事を読んでAIエージェント導入のイメージが固まってきた方へ

UravationではAIエージェント導入の研修・コンサルを行っています。Devinをはじめとした自律型AIエージェントのチーム導入から、社内ワークフロー設計まで伴走支援します。


著者:佐藤傑(さとう・すぐる)
株式会社Uravation 代表取締役。X(@SuguruKun_ai)フォロワー約10万人。著書『AIエージェント仕事術』。Devin・Claude Code・Cursor を組み合わせた開発ワークフロー最適化を探求中。

Need help moving from reading to rollout?

この記事を読んで導入イメージが固まってきた方へ

Uravationでは、AIエージェントの要件整理、PoC設計、社内導入、研修まで一気通貫で支援しています。

この記事をシェア

X Facebook LINE

※ 本記事の情報は2026年6月時点のものです。サービスの料金・仕様は変更される可能性があります。最新情報は各サービスの公式サイトをご確認ください。

関連記事