This is a starting point for Python solutions to the "Build Your own Claude Code" Challenge.

Claude Code is an AI coding assistant that uses Large Language Models (LLMs) to understand code and perform actions through tool calls. In this challenge, you'll build your own Claude Code from scratch by implementing an LLM-powered coding assistant.

Along the way you'll learn about HTTP RESTful APIs, OpenAI-compatible tool calling, agent loop, and how to integrate multiple tools into an AI assistant.

Note: If you're viewing this repo on GitHub, head over to codecrafters.io to try the challenge.

Passing the first stage

The entry point for your claude-code implementation is in app/main.py. Study and uncomment the relevant code, and submit to pass the first stage:

codecrafters submit

Stage 2 & beyond

Note: This section is for stages 2 and beyond.

1. Ensure you have uv installed locally.
2. Run ./your_program.sh to run your program, which is implemented in app/main.py.
3. Run codecrafters submit to submit your solution to CodeCrafters. Test output will be streamed to your terminal.