Skapa och konfigurera en agent
Den här guiden visar hur du lägger till en agent i en arbetsyta och konfigurerar den tills den faktiskt kan köra.
Varje arbetsyta skapas med fem agenter – en CEO plus qa, architect, engineer och librarian – så du har oftast agenter redan innan du har konfigurerat någon. Stegen nedan gäller lika mycket för en medföljande agent som för en ny.
Innan du börjar
Avsnitt med rubriken “Innan du börjar”- Du är inne i en arbetsyta. Hela gränssnittet ligger under Inställningar → Arbetsyta → Agenter (
/settings/workspace/agents). - Agenten behöver en backend. Antingen ansluter du en leverantör för den inbyggda harnessen under Inställningar → Server → Modellleverantörer, eller så installerar du Claude Code CLI på maskinen som kör
cc_server. - Om du vill att agenten ska ha skills installerar du dem först under Inställningar → Arbetsyta → Färdigheter. I agentformuläret kan du bara slå på skills som redan finns i arbetsytan.
Lägg till agenten
Avsnitt med rubriken “Lägg till agenten”- Öppna Inställningar → Arbetsyta → Agenter.
- Klicka på Ny agent.
Det finns ingen dialog och ingen rollväljare. En agent med namnet ”Namnlös agent” skapas direkt och markeras i detaljpanelen till höger.
Nu bör du se ”Namnlös agent” i listan till vänster, med fliken Inställningar i detaljpanelen öppen och ett fält Namn som innehåller ”Namnlös agent”.
Ge den ett namn
Avsnitt med rubriken “Ge den ett namn”- Namn – den korta identifieraren som används i @-omnämnanden, till exempel
alice. Tolkningen av omnämnanden matchar@följt av ordtecken, så ett namn med bindestreck, punkt eller mellanslag kan aldrig nämnas. - Titel – den läsbara etiketten, till exempel ”Seniorutvecklare”.
- Systemprompt – valfria extra instruktioner som injiceras som avsnittet Agent instructions; de ersätter inte resten av den sammansatta prompten.
Klicka på Spara ändringar längst ned i formuläret. Varje fält på den här sidan sparas med den enda knappen.
Ge den en adapter och en modell
Avsnitt med rubriken “Ge den en adapter och en modell”Listrutan Adapter visar de körare som servervärden faktiskt har. Den inbyggda adaptern hittas alltid (den är servern). Claude Code visas bara om dess CLI har upptäckts på den värden:
| Adapter | Backend |
|---|---|
| Control Center (built-in) | Den processinterna agentloopen – ingen extern CLI |
| Claude Code | claude -p --output-format stream-json |
Bara den inbyggda adaptern upprätthåller lägen, styrning, paus/återupptagning, slutförandekontrakt och subagenter. Claude Code ger dig inget av det. Cursor, Codex och de andra modellleverantörerna kopplas till den inbyggda adaptern, inte som egna körare.
Listrutan Modell styrs av den adapter du valde. För den inbyggda adaptern kommer listan direkt från de leverantörer du har anslutit under Inställningar → Server → Modellleverantörer, så en leverantör utan sparad inloggningsuppgift bidrar med noll modeller.
Lägg till skills
Avsnitt med rubriken “Lägg till skills”Färdigheter är en chipväljare över de skill-paket som är installerade i den här arbetsytan. Tryck på en chip för att slå på eller av den; bockikonen markerar de valda. Om arbetsytan inte har några skills står det ”No skills available. Create skills in Settings → Skills first.” i fältet.
Du väljer inte ett repos egna skills här. Ett repo som levererar dem (i .agents/skills/, .claude/skills/ eller .opencode/skills/) bidrar automatiskt med dem till den agent som arbetar i det repot, och de byts ut när den flyttar till ett annat – se Reposcopade skills.
Ange rapporteringslinje och persona
Avsnitt med rubriken “Ange rapporteringslinje och persona”- Rapporterar till – välj en annan agent via namnet. Det här bygger rapporteringsträdet som knappen Organisationsschema i sidhuvudet visar. Det är inte den lista som en teamledare använder när den delegerar – den kommer från teamets medlemmar och deras skills.
- Persona – fri text som formar ton och beteende, till exempel: ”Föredrar enkla, läsbara lösningar. Skriver tester för all ny kod.”
Finjustera körningen
Avsnitt med rubriken “Finjustera körningen”- Resonemangsinsats – alternativen kommer från den valda modellens egna publicerade nivåer: Low / Medium / High, plus Extra High på modeller i OpenAI-stil och Extra High + Max på modeller i Claude-stil. Fältet döljs helt när den valda modellen inte anger några resonemangsnivåer, och det står på modellens egen standard.
- Storlek på kontextfönster – förifylls från modellens kontextfönster varje gång du byter modell, med chips för ett tryck för modellens standard, 200k, 500k och 1M. Ett värde som du skriver in efter att ha valt modellen gäller till nästa modellbyte.
- Tystnadstimeout (minuter) – avsluta en körning efter så här lång tid utan utdata. Lämna tomt för att använda standarden per läge.
Bevilja behörigheter
Avsnitt med rubriken “Bevilja behörigheter”En agent har inga egna behörighetsväxlar. Vad den får pusha, öppna, slå samman eller nå bestäms av åtgärdsreglerna under Inställningar → Arbetsyta → Agentbehörigheter, där en regel kan begränsas till den här agenten. Från början frågar en push, en pull request, en granskning eller sammanslagning och en skrivning till ett ärendesystem dig först, var och en, och nätverksåtkomst är tillåten.
Agentens GitHub-token kan alltid bara läsa. En push går genom Control Center, som frågar regeln Pusha till en remote innan den skickas vidare. Se Konfigurera sandlådepolicyer för hur varje regel når en körning.
Verifiera att den körs
Avsnitt med rubriken “Verifiera att den körs”- Öppna Inställningar → Server → Modellleverantörer och bekräfta att adaptern du valde rapporterar en installerad version i stället för ”Hittades inte”. Klicka på Uppdatera för att söka igen – sökningen körs på maskinen som kör
cc_server, inte på maskinen du tittar på. - Öppna en yta med agenten och skicka ett meddelande till den, eller @-nämn den i en befintlig yta.
- Gå tillbaka till Inställningar → Arbetsyta → Agenter, välj agenten och öppna fliken Loggar. En körning bör visas med en statusbricka, en varaktighet, en starttid och adaptern den använde. Visa öppnar körningens händelseström.
Om ingen körning visas alls går du igenom Felsök en agent.
Ta bort en agent
Avsnitt med rubriken “Ta bort en agent”Välj den i listan. På fliken Inställningar rullar du ned till Farozon längst ned i formuläret och klickar på Ta bort.
Relaterade guider
Avsnitt med rubriken “Relaterade guider”- Kör agenter parallellt
- Bygg ett agentteam
- Hantera adapters och modeller
- Felsök en agent
- Agentkonfiguration