START NOW
User Guide

Agent mode

Attach a coding agent to a running compute instance or launch an instance from Account.

Agent mode runs a codeq terminal session inside a qBraid compute instance. The agent works with that instance’s files, packages, and terminal.

Start an agent session

  1. Open Agent in qBraid Account.
  2. Under Your instances, select Attach for a running instance or Resume for a stopped on-demand instance.
  3. To create an instance, choose a profile under Launch a new instance and review the launch confirmation.
  4. Wait for the instance and terminal to connect, then enter your task in the agent terminal.

Both subscription and on-demand instances can host the agent. The header identifies the attached instance and shows its per-minute credit rate when available.

A useful first task is:

Create a Python script for a two-qubit Bell circuit.
Run it on an available free simulator and explain the measurement counts.

The agent uses the files and permissions available inside the instance. Review any approval prompts in the agent terminal and specify a spending limit before requesting paid hardware jobs.

Reconnect or stop

If the terminal connection fails, select Retry. If the session ends while the instance is still running, select Reconnect.

Use Stop instance to stop the attached compute instance. The confirmation explains that this also ends the agent session. Closing the Agent page does not stop the instance.

Stopping an on-demand instance preserves its disk. Terminating it deletes its files. See on-demand instances before removing an instance.

Costs

Agent sessions use compute resources as well as AI tokens. Subscription instances draw on the applicable compute allocation, and on-demand instances use credits at their displayed rate. Model usage follows AI quotas and credit spending.

For platform questions that do not need a terminal, use AI Chat. For your own coding client, connect through the AI Gateway and MCP server.

© 2026 qBraid