Claude Engineer
An interactive self imporving AI coding agent for creating and using AI tools with Claude.At its core, Claude Engineer introduces a dynamic tool ecosystem where the AI can autonomously create, manage, and execute its own tools during conversations. This allows the system to continuously expand its capabilities, adapting to user needs in real time and becoming more effective the more it is used.
Features
- Dynamic tool creation and loading
- Dynamic expansion of capabilities during interactions
- Smart management of tool dependencies
- Adaptation based on tool usage patterns
- Automated generation of tool code
- Integrates with Claude of any model
- Real-time display of tool execution
- Token usage tracking via Anthropic API
- Continuous refinement of existing tools
- Improves reliability with enhanced error handling and debugging
- Dynamic module importing system
Requirements🧷
- Windows or Mac OS
- Python 3.6+
- Anthropic API Key
- Required packages from
requirements.txt
Installation
Windows
git clone https://github.com/bawadou/claude-engineer
cd claude-engineer
python -m venv venv
venv\Scripts\activate.bat
pip install -r requirements.txt
# or
pip install -e .
python main.py
MacOS / Linux
git clone https://github.com/bawadou/claude-engineer
cd claude-engineer
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# or
pip install -e
python3 main.py
Configuration⚙
Create .env file and copy .env.example to .env and fill in your key:
ANTHROPIC_API_KEY=sk-ant-...
The agent supports configuration options through the Config class:
| Option | Description |
|---|---|
CE_MODEL | Which Claude model to use for the conversation |
ANTHROPIC_API_KEY | Your Anthropic API key from console.anthropic.com. The agent will refuse to start without it. |
CE_MAX_TOKENS | Maximum number of tokens the model is allowed to generate in a single response. Higher values allow longer outputs but cost more. |
CE_VERBOSE | When set to 1, prints every tool invocation and its arguments as they happen. Useful for debugging the agent loop. |
CE_TOOLS_DIR | Directory for tool storage |
Run
python -m claude_engineer
Type /help inside the REPL to see commands.
Built-in Tools
There are some pre-built tools available in Claude Engineer.
| Tool | What it does |
|---|---|
read_file | Read a text file from the project |
create_tool | Create new tools using frameworks self-improvement core |
write_file | Create or overwrite a text file |
list_dir | List a directory |
run_shell | Run a shell command (60s timeout) |
web_search | Search the web via Anthropic's hosted tool |
Project structure
├── claude_engineer/ # Main package
│ ├── __init__.py # Package exports
│ ├── __main__.py # Entry point for `python -m claude_engineer`
│ ├── agent.py # Core conversation loop and tool orchestration
│ ├── cli.py # Interactive REPL and argument parsing
│ ├── config.py # Configuration loading and defaults
│ └── tools/ # Built-in tool implementations
│ ├── __init__.py # Tool registry
│ ├── base.py # Abstract tool interface
│ ├── fs.py # File system operations
│ ├── shell.py # Shell command execution
│ └── search.py # Web search integration
├── tests/ # Unit tests
├── pyproject.toml # Package metadata and dependencies
├── requirements.txt # Runtime dependencies
├── .env.example # Template for environment variables
├── .gitignore
└── README.md
Contribution
Contributions are welcome. Whether it's a new tool, or a bug fix — open an issue first if the change is non-trivial, so we can align on the approach before you submit a Pull-Request.
License
MIT - Use freely, modify as needed, contribute back if you can.