Create your first agent
Set up a folder for one of your projects.
In EasyCC, an agent is one folder you and Claude work in together — usually one of your projects. You can have as many agents as you like, and switching between them takes one click.
What's in an agent?
An agent is just a folder on your computer with whatever files you keep in there — documents, spreadsheets, drafts, references — plus a tiny .easycc/ folder where EasyCC keeps version history and settings for that agent.
You don't have to think about the .easycc/ folder. EasyCC manages it.
The first-launch wizard
The first time you open EasyCC after signing in, a short setup wizard runs.
Choose where your agents live
EasyCC suggests a folder under your home directory (something like ~/EasyCC on macOS or Documents\EasyCC on Windows). Accept it, or pick another spot.
This is the parent folder where every agent you create will live as its own subfolder.
Connect to Claude
EasyCC needs to know which Claude account to use. Three options:
- Anthropic account — sign in with the same email you use at claude.ai. Recommended for most people.
- API key — paste an Anthropic API key. Useful if you have one already.
- Custom gateway / Bedrock / Vertex / Foundry — for organizations that route Claude through their own infrastructure. Your IT admin will tell you which to pick.
Name your first agent
Give it a name (e.g. "Marketing", "Q3 Planning", "Bakery"). EasyCC creates a subfolder with that name.
Pick a starting point
You can start with a blank agent, the EasyCC sample workspace (a guided tour of every file type), or a template tailored to a specific kind of work.
That's it — you'll land in your new agent, ready to go.
Creating more agents later
You can add agents any time:
- From the agent switcher in the title bar (the dropdown next to "EasyCC")
- From the Command Center home view — click + New Agent
Each agent is independent. They don't share files, chat history, or settings unless you specifically share them.
Where things are saved
Inside each agent folder, EasyCC keeps:
- Your files — exactly where you put them
.easycc/history/— version history (every save, kept locally).easycc/config.json— settings just for this agent.claude/— Claude-specific config (skills, memory, permissions)
You can back up an agent by copying its folder. You can move an agent by moving its folder.
Next
How is this guide?