PLUGIN Mollie is now part of Sylius-Standard
4 min. read
Categories: Technical
How Claude Code can boost your Sylius project

In our previous article, we introduced Codex, a tool designed to speed up development in Sylius projects. This time, let’s take a look at Claude Code from Anthropic. Claude offers a different approach: it’s a simple command-line tool that uses AI directly in your terminal, helping you quickly understand, customize, and extend your Sylius eCommerce application. Whether you’re working on checkout changes, API customizations, or building new features from scratch, Claude can make your workflow smoother and faster.

Getting started with Claude Code

To get started, first install Claude Code’s CLI tool directly from the official documentation on the Claude Code website. Claude runs entirely on your local machine: there’s no web interface, no uploading files, and no complicated configuration. It uses your existing development environment and interacts with your local Sylius project directly from your console. 

Here’s how easy it is:

Installation:
Follow the installation instructions here. It usually takes just a few seconds.

Run Claude in your project:
Open your Sylius project folder in the terminal and simply run:

claude

When running Claude for the first time, you’ll be prompted to log in via your browser. Claude will also ask you to confirm that you trust the files in your current project directory before proceeding.


Start Interacting:

Immediately ask questions, request code changes, or ask Claude to explain code within your Sylius project.

Claude will read directly from your local files, understand your project’s context, and respond clearly, directly in your terminal.

No extra configuration or cloud setup is required. Claude works straight from your current Sylius development environment, which is very developer-friendly.

Working with Claude Code

Claude provides two distinct modes that make your interaction smoother:

  • Planning Mode:
    In planning mode, Claude suggests high-level tasks and approaches, offering step-by-step guidance without directly editing your files. It helps you map out changes or new features clearly.
  • Developing Mode:
    Switch to developing mode (toggle with Shift + Tab) when you’re ready for Claude to start modifying your files directly. In this mode, Claude makes precise edits and writes new code or files as requested.

Interacting efficiently with Claude

  • Viewing Files:
    To quickly reference files in your conversation, use the @ symbol followed by the path. Claude will immediately include the file content in context and respond accordingly.
  • Terminal commands and file management:
    Claude can directly execute or guide you through terminal commands such as searching or removing files. It may occasionally prompt you for confirmation or ask specific questions before running these commands.
  • Notifications:
    Claude uses clear notifications in the terminal whenever your attention is required: for instance, to confirm a change, resolve an ambiguity, or address errors during edits. It also notifies you when it has completed a task, so you always know when an operation is done and the code is ready.

Importance of context

Claude relies on additional context provided in a dedicated file named CLAUDE.md. It’s a good idea to include one in your Sylius project, since it helps Claude understand how things are structured and what conventions you’re using. If your project already includes a Codex AGENTS.md file, you can reuse or combine the content to avoid duplicating effort, like we’ve done here.

Context makes a real difference when working with AI tools. The more your project structure, naming, and conventions are clear, the better the tool can follow along and provide useful suggestions. Without context, it’s easy for an AI to miss important details or give answers that don’t really fit how your application is built. The CLAUDE.md file is one way to provide that background, but what matters most is that the tool understands how your project actually works.

Keep in mind that while Sylius has its own set of patterns and best practices, you’re working on an end application: your project = your rules. The context you give the AI should reflect how your team works, not just how Sylius does things by default. If some Sylius conventions don’t fit your needs, it’s fine to leave them out or change them. 

Just know that going your own way can come with trade-offs: for example, upgrading to a new Sylius version might require extra work if your project drifts too far from the usual structure.

Tip: If you’re not sure where to start, Claude can help generate the initial context for you. Just run the /init command, and it will scan your project and create a basic CLAUDE.md file that you can then adjust to fit your workflow.

Claude Code vs Codex

Feature / WorkflowClaude CodeCodex
InterfaceTerminal (interactive CLI)GitHub PRs, CLI, file-level changes
SetupNone (runs in your project folder)Requires environment configuration
File awarenessLocal project contextBased on Codex project setup and file hints
Output formatWrites files or modifies them in placeCreates diffs, PRs, and commits
Development stylePair programming feelStructured automation
Context fileCLAUDE.mdAGENTS.md

Summary

Personally, I find myself reaching for Claude more often than Codex. It runs in the console, works directly in my local environment, and that alone makes it feel faster and more natural to use. It might not be using the most advanced model out there (ChatGPT 4.5 is probably stronger in some cases), but the speed and tight integration with my actual project matter more in day-to-day work.

Most development is iterative anyway. Claude helps me move quickly, test ideas, tweak things, and keep going. To be honest, these iterations often end with me just finishing the coding myself, but I still save time by thinking it through with Claude. It makes me more productive.

Tip: When starting out, it’s usually better to stick with planning mode first. It helps you explore possible solutions before handing over control to the AI.

Tags:
Share:
Michał Pysiak
More from our blog
Technical 4 min read 04.12.2024
Here’s everything you had to know about the first major release since 2017! Over 7 years after the first major release, on Nov 12, 2024, we have released Sylius 2.0.0. We had a great opportunity to announce it first at SyliusCon in Lyon, but now, as we are back to… Read More
4 min read 22.11.2024
The emotions start to settle after SyliusCon, and it’s time to reflect on this incredible milestone in our journey. Why a milestone? Because SyliusCon exceeded our expectations in every possible way. We broke attendance records and brought together the key figures of our community, numerous partners, freelancers, and simply all… Read More
Cloud 4 min read 17.06.2024
We are thrilled to announce that we just signed a strategic partnership with Platform.sh, and as a result, we are extending our offer with Sylius Cloud powered by Platform.sh. Platform.sh is a modern Platform-as-a-Service (PaaS) solution that allows businesses to leverage the cloud environment without losing access to the code… Read More
Comments