Roo Code

Roo Code is an agentic coding extension for VS Code with multiple operating modes. It reaches Lyceum through its OpenAI Compatible provider.

Install

Open the VS Code Extensions panel (Cmd+Shift+X or Ctrl+Shift+X).
Search for Roo Code and click Install.
Restart VS Code.

Configure

Open the settings

Click the Roo Code icon in the sidebar, then the gear icon.

Select the provider

Set API Provider to OpenAI Compatible.

Fill in the fields

Set model capabilities

Set Context Window and Max Output Tokens from active models. Enable Image Support only for vision models.

Roo Code uses native tool calling with no fallback. A model without tool-calling support will fail to edit files. Every model in the table below supports it.

Recommended models

Model	Why
`moonshotai/kimi-k2.7-code`	Built for agentic coding
`z-ai/glm-5.2`	Strongest general reasoning
`deepseek/deepseek-v4-flash-0731`	Fast, cheap for simple modes

Modes

Roo Code ships five built-in modes. Switch with the dropdown left of the chat input, a slash command, or Cmd+. on macOS / Ctrl+. on Windows and Linux.

Mode	Command	Use it for	Suggested model
Code (default)	`/code`	Writing code, implementing features	`moonshotai/kimi-k2.7-code`
Architect	`/architect`	System design, planning	`z-ai/glm-5.2`
Debug	`/debug`	Tracking bugs, diagnosing errors	`z-ai/glm-5.2`
Ask	`/ask`	Explanation, technical questions	`deepseek/deepseek-v4-flash-0731`
Orchestrator	`/orchestrator`	Multi-step work spanning modes	`moonshotai/kimi-k3`

Per-mode models

Roo Code supports one API configuration profile per mode, so each mode can run a different model. Create a profile per row above under API Configuration Profiles in settings, then assign profiles to modes in the mode settings. Every profile uses the same Base URL and API key; only the model differs.

Custom modes

Add a .roomodes file to your project root to define specialised modes:

customModes:
  - slug: reviewer
    name: "Code Reviewer"
    roleDefinition: >-
      You are a senior code reviewer focused on code quality,
      security, and best practices.
    groups:
      - read
      - browser
    customInstructions: |
      Review code for bugs, security issues, and style.
      Suggest improvements with specific examples.

  - slug: docs-writer
    name: "Documentation Writer"
    roleDefinition: You are a technical writer specialising in clear documentation.
    groups:
      - read
      - - edit
        - fileRegex: \.(md|mdx)$
          description: Markdown files only
      - browser

Assign a model to a custom mode the same way as a built-in one, through an API configuration profile.

Troubleshooting

Issue	Fix
Model does not respond	Confirm the key is an `lk_` key and the Base URL has no `/v1` suffix
Context window errors	Set Context Window in Model Configuration to match the model, see active models
Replies cut off	Raise Max Output Tokens
Slow on simple tasks	Switch that mode to `deepseek/deepseek-v4-flash-0731`

Getting Started

Serverless

Instances

Inference

Coding Agents

Workloads

Observability

Tools

Configuration

Account

Install

Configure

Recommended models

Modes

Per-mode models

Custom modes

Troubleshooting

​Install

​Configure

​Recommended models

​Modes

​Per-mode models

​Custom modes

​Troubleshooting

Install

Configure

Recommended models

Modes

Per-mode models

Custom modes

Troubleshooting