Skip to main content

Documentation Index

Fetch the complete documentation index at: https://support.bolt.new/llms.txt

Use this file to discover all available pages before exploring further.

Bolt is retiring the v1 agent on August 3, 2026. After that date, your v1 projects will automatically switch to the Claude Agent default model. Claude Agent is faster, handles large projects better, and gives you access to the latest models. It’s significantly more capable than the v1 agent, so it produces more complete results and makes fewer errors that could require rework. If you have projects that use the v1 agent, switch each one to Claude Agent before that date.
Here’s the timeline for retiring the v1 agent:April 13, 2026: You’re no longer able to choose the v1 agent when you start a new project.August 3, 2026: You won’t be able to access your v1 agent projects or published sites built from them. Switch your v1 projects to Claude Agent beforehand to keep access to them.

​
Switch your v1 projects

You need to switch v1 projects individually, so repeat these steps for each v1 project you have.
Switching to Claude Agent clears your project’s chat history. This doesn’t affect your files or code, but the conversation history doesn’t carry over. Before switching, save any instructions or other context you want to keep. You can add it to your project knowledge so Claude Agent can access it across projects.
To switch a v1 project to Claude Agent:
  1. Open the project in Bolt.
  2. In the bottom-left corner of the chatbox, click the v1 Agent (legacy).
  3. Select the Claude Agent model you want to use.
  4. Click Switch to [model name] to confirm.
After you switch, add any ongoing instructions or context to Project Knowledge:
  1. In your project, click the gear icon in the top-center of the screen.
  2. Click Knowledge.
  3. In the Project instructions box, paste any information from your v1 agent chat that you want Claude Agent to have access to.

​
Choose your model

With Claude Agent, you can choose which underlying model to use. For most users switching from v1, we recommend you choose Sonnet or Opus:
  • Sonnet 4.6: The default model. This is a good choice if you’re not sure which to pick, since it’s reliable across a wide range of development work. It also offers deep reasoning for complex, multi-step development.
  • Opus 4.6: The most capable model in Bolt. It’s best for advanced reasoning, large existing codebases, and work that requires precision.
You can switch to a different model at any point. Unlike switching from the v1 agent to Claude Agent, switching between models within Claude Agent doesn’t clear your chat history. If you’re still not sure which model is right for you, see Agents and models for a more detailed comparison.
If you’re on a free plan, you’ll only be able to switch to the default model.

​
What you gain with Claude Agent

Claude Agent is a significant step up from the v1 agent. It produces more complete results and makes fewer errors that could require rework. Switching to Claude Agent also gives you capabilities that aren’t available with the v1 agent:
  • Database management: Claude Agent can create and edit Bolt Databases and connect your project to Supabase directly from the chat. You don’t need to set up or configure your database separately — the agent handles it as part of your build.
  • Model selection: The v1 agent uses a fixed model. With Claude Agent, you can choose the underlying model that powers your project.
  • Plan Mode: In Plan Mode, work through a detailed build strategy with the agent before it starts writing code. For more information about Plan Mode, see the FAQ below.

​
Frequently asked questions

​
When will my v1 projects stop working?

Your existing v1 projects will continue to work normally until August 3, 2026. After that date, they will automatically switch to the Claude Agent default model.

​
Will switching to a new agent break my project or site?

Your projects, and any sites that run on them, will continue working as expected after you switch agents. Your files, code, and live sites won’t be impacted. Only your chat history doesn’t carry over when you switch agents.

​
What happens to my chat history when I switch?

Switching to Claude Agent clears your project’s chat history. If you have important context in your v1 chat, copy it to Project Knowledge before switching so Claude Agent can reference it going forward.

​
I used Discussion Mode with v1. What do I use instead?

Claude Agent uses Plan Mode instead of Discussion Mode. Plan Mode is designed for building out detailed strategies before Bolt writes any code. Because Claude Agent is more capable than the v1 agent, you can also plan by chatting with Claude Agent directly. If you want to think something through while chatting and don’t want Bolt to build right away, tell the agent: “Don’t make any changes.”