AI Agent Hub
AI エージェント / プラグイン情報メディア
← 一覧へ
Claude Engineer
CLAUDE

Claude Engineer

Claude Engineer

ターミナルから Claude を呼び出して自律的にコードを書かせる軽量 CLI フレームワーク。ファイル操作・コード実行・Web 検索などのツールを内蔵し、対話形式で開発を進められる。

原文: Claude Engineer is an interactive command-line interface (CLI) that leverages the power of Anthropic's Claude-3.5-Sonnet model to assist with software development tasks.This framework enables Claude to generate and manage its own tools, continuously expanding its capabilities through conversation. Available both as a CLI and a modern web interface
#CLI#自律エージェント
REPO STATS

リポジトリ統計

⭐ Stars
11.2k
🍴 Forks
1.1k
⚠️ Open Issues
29
🌿 Language
Python
📄 License
-
🕒 最終更新
2024.12.13 (1年前)
📅 公開日
2024.06.25
🌿 Branch
main
README

ドキュメント

— AI による自動翻訳 (2026.05.07 更新)

Claude Engineer v3 🤖

Claude 3.5 を使って AI ツールを作成・管理するために設計された強力な自己改善型 AI アシスタントです。このフレームワークは Claude が独自のツールを生成・管理でき、会話を通じて継続的に機能を拡張できます。CLI とモダンな Web インターフェースの両方で利用できます。

履歴と進化

このプロジェクトは Claude Engineer v2 の成功を基に構築された、Claude Engineer の 3 番目のメジャーリリースです。前バージョンからの主な改善点は次の通りです。

  • Claude 3.5 Sonnet モデルへのアップグレード
  • Anthropic の新しいトークンカウント API を使用した強化されたトークン管理
  • 自己改善型ツール生成システム
  • 合理化された会話処理
  • より正確なトークン使用量の追跡と可視化
  • 自律的なツール生成機能
  • Claude が自動的に実行するタイミングをインテリジェントに判断できるため、automode は不要

説明

Claude Engineer v3 は、動的ツール生成を通じて Claude が独自の能力を拡張できるようにする洗練されたフレームワークです。会話中に Claude は新しいツールの必要性を認識し、それらを設計・実装できます。この自己改善アーキテクチャは、フレームワークの使用頻度が高いほど強力になることを意味します。

インストール

最適な体験のために uv をインストールしてください。

macOS と Linux

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Or using wget if curl is not available:
# wget -qO- https://astral.sh/uv/install.sh | sh

# Clone and setup
git clone https://github.com/Doriandarko/claude-engineer.git
cd claude-engineer
uv venv
source .venv/bin/activate

# Run web interface
uv run app.py

# Or run CLI
uv run ce3.py

Windows

# Install uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone and setup
git clone https://github.com/Doriandarko/claude-engineer.git
cd claude-engineer
uv venv
.venv\Scripts\activate


# Run web interface
uv run app.py

# Or run CLI
uv run ce3.py

インターフェイスオプション

1. Web インターフェイス 🌐

洗練された最新の Web UI で以下の機能を備えています:

  • リアルタイムトークン使用量の可視化
  • 画像アップロードと分析機能
  • 構文ハイライト付き Markdown レンダリング
  • すべてのデバイスに対応したレスポンシブデザイン
  • ツール使用状況インジケータ
  • クリーンでミニマルなインターフェイス

Claude Engineer v3 Web Interface

Web インターフェイスを実行するには:

# Using uv (recommended)
uv run app.py

# Or using traditional Python
python app.py

# Then open your browser to:
http://localhost:5000

2. コマンドラインインターフェイス (CLI) 💻

以下の機能を備えた強力なターミナルベースのインターフェイスです:

  • リッチテキストフォーマット
  • 進行状況インジケータ
  • トークン使用量の可視化
  • 直接ツール操作
  • 詳細なデバッグ出力

CLI を実行するには:

# Using uv (recommended)
uv run ce3.py

# Or using traditional Python
python ce3.py

ワークフローに最適なインターフェイスを選択してください:

  • Web UI:ビジュアルワーク、画像分析、より最新のエクスペリエンスに最適です
  • CLI:開発者、システム統合、ターミナルワークフロー向けの最適ソリューションです

自己改善機能

  • 🧠 自動ツール識別および作成
  • 🔄 会話中の動的機能拡張
  • 🎯 スマートツール依存関係管理
  • 📈 ツール使用パターンからの学習
  • 🔍 機能ギャップの自動識別
  • 🛠️ 既存ツールの自己最適化

コア機能

  • 🔨 動的ツール作成とロード
  • 🔄 新しいツールのホットリロード機能
  • 🎨 進行状況インジケータを備えたリッチコンソールインターフェイス
  • 🧩 クリーンなインターフェイスを備えたツール抽象化フレームワーク
  • 📝 自動ツールコード生成
  • 🔌 Claude 3.5 AI との簡単な統合
  • 💬 トークン管理を備えた永続的な会話履歴
  • 🛠️ リアルタイムツール使用表示
  • 🔄 自動ツールチェーン機能
  • ⚡ 動的モジュール読み込みシステム
  • 📊 Anthropic のトークン計数 API を使用した高度なトークン追跡
  • 🎯 正確なコンテキストウィンドウ管理
  • 🔍 強化されたエラー処理とデバッグ
  • 💾 会話状態管理

プロジェクト構造

claude-engineer/
├── app.py             # Web interface server
├── ce3.py            # CLI interface
├── config.py         # Configuration settings
├── static/           # Web assets
│   ├── css/         # Stylesheets
│   └── js/          # JavaScript files
├── templates/        # HTML templates
├── tools/           # Tool implementations
│   ├── base.py      # Base tool class
│   └── ...         # Generated and custom tools
└── prompts/         # System prompts
    └── system_prompts.py

インターフェース別の機能

Web インターフェースの機能

  • 🖼️ Claude Vision による画像のアップロードと分析
  • 📊 ビジュアルトークン使用量プログレスバー
  • 🎨 Tailwind CSS による清潔でモダンなデザイン
  • 📝 シンタックスハイライト付きのマークダウンレンダリング
  • 🔄 リアルタイム更新
  • 📱 すべてのデバイス向けのレスポンシブデザイン
  • 🖥️ ツール使用インジケータ
  • ⌨️ Command/Ctrl + Enter でメッセージを送信

CLI の機能

  • 🎨 リッチテキストフォーマット
  • 📊 ASCII トークン使用量バー
  • 🔄 ライブプログレスインジケータ
  • 🛠️ 直接的なツール操作
  • 📝 詳細なデバッグ出力
  • 💻 ターミナル最適化インターフェース

ワークフローと好みに最適なインターフェースを選択してください。どちらのインターフェースも同じ強力な Claude Engineer の機能にアクセスできます。異なる方法で提示されているだけです。

主要なコンポーネント

Assistant クラス

コア Assistant クラスは以下を提供します:

  • 動的なツールの読み込みと管理
  • トークン追跡によるリアルタイム会話処理
  • 自動ツール作成と検証
  • ツール実行とチェーニング
  • プログレスインジケータ付きのリッチコンソール出力
  • トークン使用の最適化

構成オプション

アシスタントは Config クラスを通じてさまざまな構成オプションをサポートしています:

  • MODEL: Claude 3.5 Sonnet モデル仕様
  • MAX_TOKENS: 個別の応答の最大トークン数
  • MAX_CONVERSATION_TOKENS: 会話の総トークン制限
  • TOOLS_DIR: ツール保存用のディレクトリ
  • SHOW_TOOL_USAGE: ツール使用表示の切り替え
  • ENABLE_THINKING: 思考インジケータの切り替え
  • DEFAULT_TEMPERATURE: モデル温度設定

要件

  • Python 3.8+
  • Anthropic API キー(Claude 3.5 アクセス)
  • requirements.txt の必須パッケージ
  • リッチターミナルサポート

貢献

貢献を歓迎します。プルリクエストの提出をお気軽にどうぞ。大きな変更の場合は、まずイシューを開いて、変更内容について議論してください。

ライセンス

MIT

謝辞

このプロジェクトは Claude Engineer v2 の基盤の上に構築され、自己改善ツール生成と高度なトークン管理でその機能を強化しています。

組み込みツール

Claude Engineer v3 には、包括的な組み込みツールセットが付属しています。

コアツール

  • 🛠️ Tool Creator (toolcreator): 自然言語の説明に基づいて新しいツールを作成し、フレームワークの自己改善機能を実現します。

開発ツール

  • 📦 UV Package Manager (uvpackagemanager): Python 依存関係管理のための UV パッケージマネージャーへのインターフェースです。パッケージのインストール、削除、更新、および仮想環境管理に対応しています。
  • 🐍 E2B Code Executor (e2bcodetool): E2B により提供されるサンドボックス環境で Python コードを安全に実行します。このツールにより Claude は Python コードを直接書き込み実行でき、データ分析、可視化、複雑な計算を実行できます。e2b.dev で利用可能な E2B API キーが必要です。
  • 🔍 Linting Tool (lintingtool): Python ファイルに対して Ruff リンターを実行し、コーディングスタイルまたは構文の問題を検出および修正します。自動修正とカスタマイズ可能なルールに対応しています。

ファイルシステムツール

  • 📂 Create Folders Tool (createfolderstool): 新しいディレクトリとネストされたディレクトリ構造を適切なエラー処理とパス検証を使って作成します。
  • 📝 File Creator (filecreatortool): 指定されたコンテンツを使って新しいファイルを作成し、テキストファイルとバイナリファイルの両方に対応しています。
  • 📖 File Content Reader (filecontentreadertool): 複数のファイルからコンテンツを同時に読み込み、バイナリファイルとシステムファイルのスマートなフィルタリングに対応しています。
  • ✏️ File Edit (fileedittool): 完全なコンテンツ置換と部分的な編集に対応した高度なファイル編集機能です。
  • 🔄 Diff Editor (diffeditortool): 正確な部分文字列の照合によってファイル内の正確なテキスト置換を実行します。

ウェブツール

  • 🔍 DuckDuckGo (duckduckgotool): DuckDuckGo を使用してウェブ検索を実行します。
  • 🌐 Web Scraper (webscrapertool): ウェブページから読み取り可能なコンテンツをインテリジェントに抽出し、不要な要素を削除します。
  • 🌍 Browser (browsertool): システムのデフォルトウェブブラウザーで URL を開きます。

ユーティリティツール

  • 📸 Screenshot Tool (screenshottool): スクリーン全体または特定の領域のスクリーンショットをキャプチャし、Claude のビジョン機能で使用できる Base64 エンコード画像を返します。

各ツールは以下のように設計されています。

  • 詳細な説明を含む自己説明的
  • 包括的なエラー処理を備えたエラー耐性
  • 複雑な操作に対応可能
  • 適切な入力検証を備えたセキュア
  • 該当する場合はクロスプラットフォーム互換

ツールは動的に読み込まれ、Tool Creator を通じて実行時に拡張でき、アシスタントはユーザーのニーズに基づいて継続的に機能を拡張できます。

必要な API キー

— GitHub から取得した原文(一部省略の場合あり)

Claude Engineer v3 🤖

A powerful self-improving AI Assistant designed for creating and managing AI tools with Claude 3.5. This framework enables Claude to generate and manage its own tools, continuously expanding its capabilities through conversation. Available both as a CLI and a modern web interface!

History and Evolution

This project represents the third major iteration of Claude Engineer, building upon the success of Claude Engineer v2. Key improvements from previous versions include:

  • Upgraded to Claude 3.5 Sonnet model
  • Enhanced token management with Anthropic's new token counting API
  • Self-improving tool creation system
  • Streamlined conversation handling
  • More precise token usage tracking and visualization
  • Autonomous tool generation capabilities
  • No need for automode since Claude can intelligently decide when to run tools automatically and sequentially.

Description

Claude Engineer v3 is a sophisticated framework that allows Claude to expand its own capabilities through dynamic tool creation. During conversations, Claude can identify needs for new tools, design them, and implement them automatically. This self-improving architecture means the framework becomes more powerful the more you use it.

Installation

For the best possible experience install uv

macOS and Linux

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Or using wget if curl is not available:
# wget -qO- https://astral.sh/uv/install.sh | sh

# Clone and setup
git clone https://github.com/Doriandarko/claude-engineer.git
cd claude-engineer
uv venv
source .venv/bin/activate

# Run web interface
uv run app.py

# Or run CLI
uv run ce3.py

Windows

# Install uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone and setup
git clone https://github.com/Doriandarko/claude-engineer.git
cd claude-engineer
uv venv
.venv\Scripts\activate


# Run web interface
uv run app.py

# Or run CLI
uv run ce3.py

Interface Options

1. Web Interface 🌐

A sleek, modern web UI with features like:

  • Real-time token usage visualization
  • Image upload and analysis capabilities
  • Markdown rendering with syntax highlighting
  • Responsive design for all devices
  • Tool usage indicators
  • Clean, minimal interface

Claude Engineer v3 Web Interface

To run the web interface:

# Using uv (recommended)
uv run app.py

# Or using traditional Python
python app.py

# Then open your browser to:
http://localhost:5000

2. Command Line Interface (CLI) 💻

A powerful terminal-based interface with:

  • Rich text formatting
  • Progress indicators
  • Token usage visualization
  • Direct tool interaction
  • Detailed debugging output

To run the CLI:

# Using uv (recommended)
uv run ce3.py

# Or using traditional Python
python ce3.py

Choose the interface that best suits your workflow:

  • Web UI: Great for visual work, image analysis, and a more modern experience
  • CLI: Perfect for developers, system integration, and terminal workflows

Self-Improvement Features

  • 🧠 Autonomous tool identification and creation
  • 🔄 Dynamic capability expansion during conversations
  • 🎯 Smart tool dependency management
  • 📈 Learning from tool usage patterns
  • 🔍 Automatic identification of capability gaps
  • 🛠️ Self-optimization of existing tools

Core Features

  • 🔨 Dynamic tool creation and loading
  • 🔄 Hot-reload capability for new tools
  • 🎨 Rich console interface with progress indicators
  • 🧩 Tool abstraction framework with clean interfaces
  • 📝 Automated tool code generation
  • 🔌 Easy integration with Claude 3.5 AI
  • 💬 Persistent conversation history with token management
  • 🛠️ Real-time tool usage display
  • 🔄 Automatic tool chaining support
  • ⚡ Dynamic module importing system
  • 📊 Advanced token tracking with Anthropic's token counting API
  • 🎯 Precise context window management
  • 🔍 Enhanced error handling and debugging
  • 💾 Conversation state management

Project Structure

claude-engineer/
├── app.py             # Web interface server
├── ce3.py            # CLI interface
├── config.py         # Configuration settings
├── static/           # Web assets
│   ├── css/         # Stylesheets
│   └── js/          # JavaScript files
├── templates/        # HTML templates
├── tools/           # Tool implementations
│   ├── base.py      # Base tool class
│   └── ...         # Generated and custom tools
└── prompts/         # System prompts
    └── system_prompts.py

Features by Interface

Web Interface Features

  • 🖼️ Image upload and analysis with Claude Vision
  • 📊 Visual token usage progress bar
  • 🎨 Clean, modern design with Tailwind CSS
  • 📝 Markdown rendering with syntax highlighting
  • 🔄 Real-time updates
  • 📱 Responsive design for all devices
  • 🖥️ Tool usage indicators
  • ⌨️ Command/Ctrl + Enter to send messages

CLI Features

  • 🎨 Rich text formatting
  • 📊 ASCII token usage bar
  • 🔄 Live progress indicators
  • 🛠️ Direct tool interaction
  • 📝 Detailed debugging output
  • 💻 Terminal-optimized interface

Choose the interface that best matches your workflow and preferences. Both interfaces provide access to the same powerful Claude Engineer capabilities, just presented in different ways.

Key Components

Assistant Class

The core Assistant class provides:

  • Dynamic tool loading and management
  • Real-time conversation handling with token tracking
  • Automatic tool creation and validation
  • Tool execution and chaining
  • Rich console output with progress indicators
  • Token usage optimization

Configuration Options

The assistant supports various configuration options through the Config class:

  • MODEL: Claude 3.5 Sonnet model specification
  • MAX_TOKENS: Maximum tokens for individual responses
  • MAX_CONVERSATION_TOKENS: Total token limit for conversations
  • TOOLS_DIR: Directory for tool storage
  • SHOW_TOOL_USAGE: Toggle tool usage display
  • ENABLE_THINKING: Toggle thinking indicator
  • DEFAULT_TEMPERATURE: Model temperature setting

Requirements

  • Python 3.8+
  • Anthropic API Key (Claude 3.5 access)
  • Required packages in requirements.txt
  • Rich terminal support

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

License

MIT

Acknowledgments

This project builds upon the foundations of Claude Engineer v2, enhancing its capabilities with self-improving tool generation and advanced token management.

Built-in Tools

Claude Engineer v3 comes with a comprehensive set of pre-built tools:

Core Tools

  • 🛠️ Tool Creator (toolcreator): Creates new tools based on natural language descriptions, enabling the framework's self-improvement capabilities.

Development Tools

  • 📦 UV Package Manager (uvpackagemanager): Interface to the UV package manager for Python dependency management, supporting package installation, removal, updates, and virtual environment management.
  • 🐍 E2B Code Executor (e2bcodetool): Securely executes Python code in a sandboxed environment powered by E2B. This tool enables Claude to write and run Python code directly, making it capable of data analysis, visualization, and complex computations. Requires an E2B API key available at e2b.dev.
  • 🔍 Linting Tool (lintingtool): Runs the Ruff linter on Python files to detect and fix coding style or syntax issues, with support for automatic fixes and customizable rules.

File System Tools

  • 📂 Create Folders Tool (createfolderstool): Creates new directories and nested directory structures with proper error handling and path validation.
  • 📝 File Creator (filecreatortool): Creates new files with specified content, supporting both text and binary files.
  • 📖 File Content Reader (filecontentreadertool): Reads content from multiple files simultaneously, with smart filtering of binary and system files.
  • ✏️ File Edit (fileedittool): Advanced file editing with support for full content replacement and partial edits.
  • 🔄 Diff Editor (diffeditortool): Performs precise text replacements in files by matching exact substrings.

Web Tools

  • 🔍 DuckDuckGo (duckduckgotool): Performs web searches using DuckDuckGo.
  • 🌐 Web Scraper (webscrapertool): Intelligently extracts readable content from web pages while removing unnecessary elements.
  • 🌍 Browser (browsertool): Opens URLs in the system's default web browser.

Utility Tools

  • 📸 Screenshot Tool (screenshottool): Captures screenshots of the entire screen or specific regions, returning base64-encoded images ready for Claude's vision capabilities.

Each tool is designed to be:

  • Self-documenting with detailed descriptions
  • Error-resistant with comprehensive error handling
  • Composable for complex operations
  • Secure with proper input validation
  • Cross-platform compatible where applicable

The tools are dynamically loaded and can be extended during runtime through the Tool Creator, allowing the assistant to continuously expand its capabilities based on user needs.