The text edit tool

Overview

• Claude has one built-in tool by default: the Text Editor tool
• Provides file system operations similar to a standard text editor (open, read, create, edit, replace, undo)
• Dramatically expands Claude's abilities and enables it to act as a software engineer

How It Works

Two Components Required for Tools

• JSON schema: Describes the tool and its arguments (provided to Claude)
• Tool function implementation: Actual code that executes when Claude uses the tool

Text Editor Tool Specifics

• Only the JSON schema is built into Claude
• You must write the tool function implementation to handle Claude's requests
• When Claude requests a file operation, your code must execute it on the file system

Schema Handling

• Send a small "stub" schema to Claude that references the text editor tool
• Claude automatically expands this into a full schema with complete instructions
• The schema type string varies by Claude model version (e. g. , Claude 3. 7 vs 3. 5)

Capabilities

• View: Read file or directory contents, view specific text ranges
• Create: Make new files
• Replace: Add or replace text within files
• Edit: Perform standard text editor operations

Practical Applications

• Replicate functionality of AI-powered code editors
• Edit files when you lack access to a native code editor
• Automate file creation and modification tasks
• Enable Claude to work with file systems programmatically

Implementation Note

• Using the text editor tool requires effort—you must write implementation code
• The tool is not "free" but provides significant capability once implemented

Takeaways

• Claude's built-in Text Editor tool enables file system operations (read, create, edit, replace) and dramatically expands its capabilities to act as a software engineer
• Implementation requires two components: a JSON schema (provided by Claude) and your own tool function code to execute file operations on the actual file system
• The tool allows Claude to view file contents, create new files, and perform text replacements—enabling automation of file tasks and replication of AI-powered code editor functionality
• You send a small "stub" schema to Claude which automatically expands into full instructions, though the exact schema type varies by Claude model version
• While implementation requires effort, the tool provides significant capability for programmatic file system work once set up