Skip to main content

External room agents

An external room agent is a coding agent that runs on your own computer and works for you inside an agentic room. Today that agent is Claude Code. You give it a command in the room, or hand it one of your tasks, and it works in a folder on your computer. The room shows each step as it happens, and the answer lands on the run card.

Claude Code works only for you. Only you see your runs; other people in the room see what changed.

Supported agents​

AgentStatus
Claude CodeSupported
Codex CLI, Gemini CLI, OpenCode, Cursor CLI, Copilot CLIListed, not supported yet. You can set them up now, and they switch on when Qik supports them.

How to connect your computer​

You connect a computer once. One bridge on the computer serves every agent installed there.

  1. Open Settings › Connected apps › External room agents.
  2. Select Set up on Claude Code. Its setup card has three steps: install Claude Code, connect the computer, and turn it on in a room.
  3. Install Claude Code with the command shown, then run claude once and sign in.
  4. Connect the computer:
    • In the Qik desktop app, select Connect this computer.
    • In a terminal, run npx qik-claude connect. It shows a code. Enter the code on the setup card and select Connect.
  5. Leave Keep it running in the background ticked if you want the bridge to start by itself whenever you sign in to your computer.

The card shows each connected computer as online or offline. To connect another computer, select Add a computer.

How to turn on Claude Code in a room​

  1. Open the room's Agent popover, or Room settings › Agent.
  2. Under Your personal agent, turn on Claude Code.
  3. Choose the folder it works in for this room. Qik suggests folders from your computer, or select Choose folder….
  4. Confirm that Claude Code may read, edit and run files in that folder.

Each room has its own folder. Only the folder's name is stored in Qik. To change it later, select the folder chip in the prompt bar.

Settings › Connected apps › External room agents lists the rooms under each agent, each with its own switch.

How to give Claude Code a command​

  1. Open the room's Agent Center. When Claude Code is on, a switch at the top lets you choose between Claude Code and the room's own agent.
  2. Choose Claude Code, type your command and select Execute.
  3. Watch the steps. When Claude Code starts helper agents, the run shows N agents working. Select it to see each helper's progress.
  4. Reply in the box below the answer to continue in the same session.

You can also message Claude Code while it works. It takes your message into account straight away.

Several runs can go side by side in one folder, like two terminals, up to 8 runs per computer.

Allow or deny changes​

When Claude Code asks permission to edit a file or run a command, its question appears in the run as an Allow / Deny card. A proposed file change is shown as a diff, so you can see exactly what will change before you allow it.

Code changes​

Claude Code's file edits show in the run card as diffs: line numbers, added lines in green and removed lines in red. Long changes fold, and very large ones show the file and line counts only.

Qik stores no code

Diffs go from your computer straight to your app. A finished run reads its diffs back from your computer, so when your computer is offline the run card shows Code changes show when your computer is online.

Sessions​

Each run belongs to a Claude Code session. A reply continues the same session. Select the session chip in the prompt bar to pick one:

  • New session — a fresh start for the next command.
  • In this room — earlier sessions from this room.
  • Your computer and folder — Claude Code sessions in the room's folder, including ones you started in a terminal.

A session that is still open in a terminal can be continued as a copy with Continue as a copy, while the terminal keeps its own. Each run ends with a claude --resume <id> command you can copy to continue the session in your terminal, and the picker has Copy resume for each session.

The "/" menu​

Type / in the prompt bar to open a menu of:

  • Your Claude Code commands — your own commands, skills and plugins from the room's folder.
  • Qik actions — /new, /attach, /open-tasks, /stop, /session and /folder.
  • Qik skills — tell Claude Code to load one of Qik's agent skills.

How to hand a task to Claude Code​

  1. Open a task in a room where Claude Code is on.
  2. In the assignee picker, choose Claude Code.

Claude Code works on the task, adds a note and sets a review status. It never marks a task Completed; that stays with you.

From your terminal, Claude Code can also pick up a Qik task and report progress through the Qik connector or the Qik plugin's /qik:task command. The room shows it as a run.

When your computer is offline​

The prompt bar shows that Claude Code is offline. Commands you send wait and go out by themselves when your computer is back (up to a day). Select Reconnect for the steps to bring the computer back, or use the room's own agent meanwhile.

Agent credits​

Each Claude Code run costs 2 agent credits. A reply is its own run. Claude's own usage is billed by your Claude plan, never by Qik. A command that never leaves the queue costs nothing. See Credit types.

Plans and company control​

External room agents are part of AI Office Pro, Custom and Enterprise. On Prime Office and Business Office you see the agents, and connecting a computer or turning one on in a room shows Upgrade to Pro.

Company owners and admins can turn external room agents off for the whole company in Company settings › Agents. The switch is on by default, and off for restricted companies. Turning it off removes it from everyone's rooms at once; folders are kept for when it is turned back on.