Skip to content
Carry Code | Docs

Dual Mode

CarryCodevides two working modes: Build mode and Plan mode. Understanding the differences can help you use AI more efficiently.

Mode Overview

Section titled “Mode Overview”
ModeIconFunctionUse Cases
Build🔨Read/write files, execute commandsLet AI write/modify code
Plan📋Read-only analysisLet AI analyze problems, plan solutions

🔨 Build Mode

Section titled “🔨 Build Mode”

Build mode is the default mode in Carry Code. In this mode, AI can:

  • 📖 Read files - View project code
  • ✏️ Write files - Create and modify code
  • ▶️ Execute commands - Run scripts, install dependencies, etc.
  • 🔧 Use tools - Call various built-in tools

Use Cases

Section titled “Use Cases”
ScenarioExample
Write new codeHelp me write a user login API
Fix bugsHow to solve this error?
Refactor codeHelp me optimize this code
Execute operationsRun npm install

Security Mechanisms

Section titled “Security Mechanisms”

AI will ask for confirmation before executing dangerous operations:

  • Modifying files
  • Executing shell commands
  • Delete operations

📋 Plan Mode

Section titled “📋 Plan Mode”

In Plan mode, AI can only read and analyze and cannot modify anything.

Function Restrictions

Section titled “Function Restrictions”
  • ❌ Cannot write files
  • ❌ Cannot execute commands
  • ✅ Can read files
  • ✅ Can analyze code
  • ✅ Can provide suggestions

Use Cases

Section titled “Use Cases”
ScenarioExample
Code reviewWhat are the issues with this code?
Solution designDesign a user system architecture
Learning analysisAnalyze the time complexity of this algorithm
Explain codeWhat does this code do?

Switching Modes

Section titled “Switching Modes”

Keyboard Shortcut

Section titled “Keyboard Shortcut”

Press Shift + Tab to switch between the two modes.

Command Line

Section titled “Command Line”

You can also switch using commands:

/mode build   # Switch to Build mode
/mode plan    # Switch to Plan mode

Status Display

Section titled “Status Display”

The current mode is displayed at the top of the interface:

🔨 Build Mode | Model: DeepSeek Chat

Usage Tips

Section titled “Usage Tips”

When to Use Build Mode?

Section titled “When to Use Build Mode?”
  • Need AI to write code for you
  • Need AI to modify existing code
  • Need AI to execute commands to complete tasks

When to Use Plan Mode?

Section titled “When to Use Plan Mode?”
  • Just want to understand code structure
  • Need AI to analyze problems without modifications
  • Learning new technologies, want AI to explain
  • Code review

Mode Switching Tips

Section titled “Mode Switching Tips”
  1. Plan then Build: First have AI analyze the problem, then switch to Build mode to execute
  2. Safety first: Use Plan mode for uncertain operations first

Combining with Approval Modes

Section titled “Combining with Approval Modes”

Dual modes can work with approval modes for finer-grained control:

Approval ModeBuild ModePlan Mode
read-only❌ Restricted✅ Read-only
agent✅ Executable✅ Read-only
agent-full✅ Full access✅ Read-only

Next Steps

Section titled “Next Steps”