MiniMax Code · Tutorial 03

Your First Safe Task: Modes and Workspace

Choose Coding or Work mode, attach one disposable folder, and finish an inspect-plan-change-verify loop.

Hand-cut paper workspace boundary surrounding one document as inspection, plan, change, and verification cards move through a controlled loop.
Reading time
14 min
Last updated
August 2026

0 of 6 complete

Complete & next →

Essentials · Step 3 of 6 · View the route

Last checked and updated: August 25, 2026

Your first useful task is intentionally small: change one status line in the disposable minimax-code-practice folder from Lesson 2. The lesson is about the operating method, not the difficulty of the edit.

You will:

  1. select the right mode;
  2. confirm the workspace and authoritative file;
  3. ask the agent to inspect and plan without editing;
  4. approve one exact change;
  5. verify the changed path and file content yourself.

The finish line is evidence: one expected file changed, the new sentence is present, and no unrelated path changed.

Official MiniMax Code documentation showing the Coding and Work mode switch
Official modes documentation captured August 25, 2026. Coding and Work modes emphasize different surfaces.

Coding mode or Work mode?

MiniMax says both modes use the same underlying Agent capabilities but emphasize different surfaces.

Choose Coding mode when…Choose Work mode when…
The task reads or edits a codebaseYou mainly need a report or finished document
You need Files, Changes, Terminal, or browser panelsProgress and deliverables matter more than development details
You will run a check, inspect a diff, or debug a previewThe job is research, spreadsheet work, content, or everyday automation

Use Coding mode for this exercise because seeing the file and the change is part of the proof. Work mode may hide some developer panels; hiding detail does not mean no file or command action can occur.

Official MiniMax Code workspace picker used to choose the folder for a task
Official workspace documentation captured August 25, 2026. Confirm the full folder path before allowing changes.

Workspace is context, not automatic containment

The selected workspace tells MiniMax Code which local project belongs to the task. Official documentation says the agent can understand files, scripts, and conventions there, then read files, run commands, create artifacts, and report changes.

Treat that selection as a working boundary you must state and check—not as proof of an operating-system sandbox. A public issue report described a write outside the selected project. It is one user’s report, not a measured failure rate, but it is enough reason to review every changed path.

Check the starting state

Open the minimax-code-practice folder from Lesson 2. README.md should contain:

# MiniMax Code Practice

Status: draft.

Before the task:

  • close private projects and unrelated sensitive documents;
  • confirm the active workspace name in MiniMax Code;
  • open README.md from the Files panel;
  • confirm the Changes panel is empty;
  • do not attach your Documents folder, home folder, or an entire drive.

If the starting state differs, correct your practice file manually or record the difference. Do not ask the agent to “clean everything up.”

Step 1: inspect and plan, then stop

Start a new task in Coding mode with minimax-code-practice attached. Mention @README.md, then copy this prompt:

Outcome
Prepare one safe wording change in README.md: change “Status: draft.” to
“Status: ready for review.”

Scope
Read only README.md inside the active minimax-code-practice workspace.

Evidence
The current contents of @README.md are authoritative.

Constraints and approvals
For this turn, inspect and propose a plan only. Do not edit any file, run a command,
open a sibling folder, use the network, or create a new file.

Checks
State the active workspace, current sentence, proposed replacement, expected changed path,
and how I can verify it.

Finish line
Stop after the plan and wait for my approval.

Review the response. A safe plan names only README.md, quotes the exact before/after text, and proposes a file-content check. If it adds dependencies, rewrites the document, or touches another path, reject that part before proceeding.

Step 2: approve the bounded change

If the plan is correct, send:

Approved: make only the proposed one-line change in README.md.
Do not change any other file or run commands.
After editing, report every changed path and quote the final status line.

Read any permission prompt before accepting it. The action, exact path, and reason should match what you approved. A broad request to access another directory does not become safe because the underlying edit is small.

Step 3: verify independently

Do not stop at the agent’s “done” message.

  1. Open Changes and confirm only README.md appears.
  2. Inspect the diff. It should remove Status: draft. and add Status: ready for review.
  3. Open Files → README.md and read the saved file.
  4. Confirm the heading remains unchanged.
  5. Check that no new file or sibling-folder change appears.
  6. Record the result:
Workspace checked: minimax-code-practice
Expected changed path: README.md
Observed changed paths: README.md
Expected new line: Status: ready for review.
Observed new line: Status: ready for review.
Unexpected changes: none observed
Result: pass

The Changes panel is evidence of the local diff; the saved file is evidence of the current content. Neither proves a website deploy, external publication, or production change.

Step 4: practise a correction

Send one deliberately precise follow-up:

Restate the task boundary in one sentence. If your previous work changed anything except
README.md, stop and list those paths without making further changes.

This teaches a useful habit: correct the scope explicitly instead of starting a long argument with the agent. If a task moves in the wrong direction, interrupt it, preserve the evidence, and restate the objective and boundary.

Safety boundary

For a first task, do not authorize:

  • access outside minimax-code-practice;
  • delete, overwrite, bulk move, or dependency-install commands;
  • a production repository, deployment, purchase, message, or upload;
  • credential entry, account changes, or private web content;
  • a permission described more broadly than the approved action.

This exercise uses only documented workspace and file/change surfaces. It does not claim that general desktop computer use is active.

Troubleshooting

SymptomLikely causeRecovery
Files, Changes, or Terminal are missingYou are probably in Work modeSwitch to Coding mode and reopen the developer panel
The agent cannot find README.mdWrong workspace or the file was not mentioned correctlyConfirm the active folder, open the file manually, then mention @README.md again
The agent edited before your approvalThe prompt mixed planning and execution or the agent did not follow the boundaryInterrupt, inspect every changed path, restore the practice file manually if needed, then restart with a plan-only turn
More than one path appears in ChangesThe request was interpreted broadly or another change already existedStop; separate pre-existing and new changes, reject out-of-scope work, and do not approve more commands
Work mode says the task is complete but you cannot inspect the diffThe interface is prioritizing deliverables over developer detailSwitch to Coding mode and verify Files and Changes before accepting completion
The status line looks right in chat but not on diskThe agent may have described a change without saving it, or you opened a different copyOpen the file from the active workspace and verify its path and saved contents

FAQ

Does Coding mode make the agent safer?

Not by itself. It makes development evidence easier to see. Safety comes from a narrow workspace, explicit approvals, changed-path review, and reversible work.

Can I use Work mode for code?

The underlying agent capabilities are shared, but MiniMax recommends Coding mode when you need project context, files, diffs, commands, or browser debugging.

Why use two prompts for one tiny change?

The two-turn pattern teaches you to separate inspection from authorization. Later, you can streamline trusted, low-risk routines without losing the mental model.

What if the project already has changes?

Record them before starting and do not attribute them to the agent. Lesson 5 adds Git status and checkpoints so old and new work are easier to separate.

Is the selected workspace a security sandbox?

The official docs describe it as local project context. This course does not claim it is an isolation boundary. Keep sensitive sibling folders out of scope and review actual paths.

Official sources

What’s next

Turn a vague request into a testable contract and decide whether it deserves Goal mode in L04: Goals and Task Briefs.