← Back to insights
claudeworkflowgetting-started

Getting started with Claude Code in this project

Open the repo, read CLAUDE.md, and ship your first content or code change in minutes.

You don’t need a separate admin panel or headless CMS dashboard. With Claude Code in this project root, the repo is the CMS.

Open the project

git clone https://github.com/YOUR_USERNAME/astro-x-claude.git
cd astro-x-claude
npm install
claude

Claude loads CLAUDE.md automatically — project structure, commands, commit conventions, and boundaries are all there.

Your first prompts

Start small. These work well on day one:

  • Add a blog post about our team’s content workflow.
  • Update the About page description.
  • Change the hero headline to mention our product name.

Claude edits the right files, runs astro check, and can commit with a message like content(blog): add post - ….

Skills and hooks

This template includes skills under .claude/skills/ for content updates, feature development, and deploy workflows. Hooks run a build when you touch pages or config — catching errors before they land on main.

What to avoid

Don’t ask Claude to force-push main, commit .env files, or edit dist/. The project rules are explicit; Claude follows them by default.

Once you’re comfortable with content, try a feature prompt: Add a tags index page for the blog. That’s when this template really shines.