Sst-pde: /* Overview */

2026-11-03T15:06:29Z

Overview

← Older revision		Revision as of 16:06, 3 November 2026
Line 3:		Line 3:
	[https://opencode.ai OpenCode] is an open-source AI coding agent, available as a desktop application, in the browser or via the terminal. It supports tool calls, MCP servers, skills, plugins, etc. for software development workflows. OpenCode can be configured to exclusively use AI models hosted by [https://www.stepping-stone.ch/en/products/artificial-intelligence stepping stone AG] via its OpenAI-compatible API.		[https://opencode.ai OpenCode] is an open-source AI coding agent, available as a desktop application, in the browser or via the terminal. It supports tool calls, MCP servers, skills, plugins, etc. for software development workflows. OpenCode can be configured to exclusively use AI models hosted by [https://www.stepping-stone.ch/en/products/artificial-intelligence stepping stone AG] via its OpenAI-compatible API.

	'''Note:''' This guide walks through configuring the desktop variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on ~~Demand~~: ~~Configure~~ OpenCode Terminal]]		'''Note:''' This guide walks through configuring the desktop variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on demand: Configuring OpenCode Terminal]]

	The following steps describe how to create a basic OpenCode setup using models provided by stepping stone AG, and some good first steps to control and extend the agents capabilities.		The following steps describe how to create a basic OpenCode setup using models provided by stepping stone AG, and some good first steps to control and extend the agents capabilities.

Sst-pde: Sst-pde moved page AI on Demand: Configuring OpenCode Desktop to AI on demand: Configuring OpenCode Desktop

2026-11-03T14:46:12Z

Sst-pde moved page AI on Demand: Configuring OpenCode Desktop to AI on demand: Configuring OpenCode Desktop

← Older revision

Revision as of 15:46, 3 November 2026

Sst-pde at 14:45, 3 November 2026

2026-11-03T14:45:03Z

← Older revision		Revision as of 15:45, 3 November 2026
Line 148:		Line 148:

	[[Category: AI on Demand]]		[[Category: AI on Demand]]
			[[Category: OpenCode]]

Sst-pde: Sst-pde moved page AI on Demand: Configuring OpenCode to AI on Demand: Configuring OpenCode Desktop

2026-11-03T14:43:52Z

Sst-pde moved page AI on Demand: Configuring OpenCode to AI on Demand: Configuring OpenCode Desktop

← Older revision

Revision as of 15:43, 3 November 2026

Sst-pde: Created page with "== Overview == [https://opencode.ai OpenCode] is an open-source AI coding agent, available as a desktop application, in the browser or via the terminal. It supports tool calls, MCP servers, skills, plugins, etc. for software development workflows. OpenCode can be configured to exclusively use AI models hosted by [https://www.stepping-stone.ch/en/products/artificial-intelligence stepping stone AG] via its OpenAI-compatible API. '''Note:''' This guide walks through confi..."

2026-11-03T14:43:44Z

Created page with "== Overview == [https://opencode.ai OpenCode] is an open-source AI coding agent, available as a desktop application, in the browser or via the terminal. It supports tool calls, MCP servers, skills, plugins, etc. for software development workflows. OpenCode can be configured to exclusively use AI models hosted by [https://www.stepping-stone.ch/en/products/artificial-intelligence stepping stone AG] via its OpenAI-compatible API. '''Note:''' This guide walks through confi..."

New page

== Overview ==

[https://opencode.ai OpenCode] is an open-source AI coding agent, available as a desktop application, in the browser or via the terminal. It supports tool calls, MCP servers, skills, plugins, etc. for software development workflows. OpenCode can be configured to exclusively use AI models hosted by [https://www.stepping-stone.ch/en/products/artificial-intelligence stepping stone AG] via its OpenAI-compatible API.

'''Note:''' This guide walks through configuring the desktop variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on Demand: Configure OpenCode Terminal]]

The following steps describe how to create a basic OpenCode setup using models provided by stepping stone AG, and some good first steps to control and extend the agents capabilities.

{{Note|title=⚠️ Warning|content=Remember that agents such as OpenCode can autonomously perform actions on the system they run, such as reading / editing files, making web requests, executing terminal commands, etc. Agents may also interpret untrusted inputs such as skills or AGENTS.md files as instructions. Consider carefully which actions an agent should be allowed to execute, and whether a container or VM solution may be appropriate to prevent your agent from accessing sensitive information.}}

== Prerequisites ==

* A valid [https://www.stepping-stone.ch/en/products/artificial-intelligence AI on Demand] API key.
* Network access to <code>https://llm.stoney-cloud.com/v1</code>
* The ID of the AI models you wish to use with OpenCode (e.g.
* ''Optional:'' [https://nodejs.org Node.js] 20 or newer if you intend to install opencode via npm.

== Installation ==

Download and install the [https://opencode.ai/v2/docs#desktop binary / package] appropriate for your system.

Once complete, open the OpenCode desktop app to verify that the installation was successful

<gallery mode=packed heights=200px>
OpenCode Desktop homepage.png|OpenCode Desktop
</gallery>

== Configure provider and models ==

OpenCode desktop currently does not support adding custom model providers directly from its user interface. You will need to configure stepping stone AG as your provider by modifying your OpenCode configuration file to include the following:

<syntaxhighlight lang="json">
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"stepping-stone": {
"name": "stepping stone AG",
"package": "@opencode/ai/providers/openai-compatible",
"env": ["STONEY_KEY"],
"settings": {
"baseURL": "https://llm.stoney-cloud.com/v1"
},
"models": {}
}
}
}
</syntaxhighlight>

On Linux machines, the default location of your personal configuration file is <code>~/.config/opencode/opencode.jsonc</code> or equivalent. See [https://opencode.ai/v2/docs/config/#locations https://opencode.ai/v2/docs/config/#locations] for more information on where to place the configuration file on your system.

'''Note:''' When configuring stepping stone AG as your provider as above, OpenCode expects to find your API key in an environment variable called <code>STONEY_KEY</code>. Alternatively you may add your key directly to the configuration file by removing the <code>"env": ["STONEY_KEY"],</code> line, and adding your key as follows:

<syntaxhighlight lang="json">
...
"settings": {
"baseURL": "https://llm.stoney-cloud.com/v1",
"apiKey": "YOUR API KEY GOES HERE",
},
...
</syntaxhighlight>

{{Note|title=⚠️ Warning|content=Your API key must be kept secret by you! Be careful where you store your key to prevent it from being stolen or abused by a third party.}}

Next, you should configure at least one model you wish to use with OpenCode. The following is a configuration for the <code>GLM-5.3-Flash</code> model provided by stepping stone AG:

<syntaxhighlight lang="json">
...
"models": {
"zai-org/GLM-5.3-Flash": {
"name": "GLM 5.3 Flash",
"limit": {
"context": 262144,
},
"cost": {
"input": 0.3,
"output": 1.5,
"cache": {
"read": 0.045,
},
},
},
}
</syntaxhighlight>

Replace <code>zai-org/GLM-5.3-Flash</code> with the ID of the particular model you wish to use, and refer to [https://www.stepping-stone.ch/en/products/artificial-intelligence https://www.stepping-stone.ch/en/products/artificial-intelligence] for pricing and context window limits. Additional model specific configuration can be added as needed. See [https://opencode.ai/v2/docs/models/ https://opencode.ai/v2/docs/models/] for further information on configuring models.

To check if your configuration is correct, restart OpenCode after changing the configuration file. If the configuration is correct, stepping stone AG should appear as a configured provider, and your selected model in the available models list.

<gallery mode=packed heights=200>
OpenCode_Home_button.png|1. Open home page
OpenCode_settings_menu.png|2. Open settings menu
OpenCode_Desktop_Stepping_Stone_Provider.png|3. Check that stepping stone AG appears as a provider
OpenCode_Desktop_Stepping_Stone_Model.png|4. Check that your selected model appears at the bottom of the list
</gallery>

Finally, start a new session, select the model you have just configured and enter a first prompt to test that the model is working correctly.

<gallery mode=packed heights=200>
OpenCode_Desktop_Stepping_Stone_Model_selected.png|1. Start a new session and select a stepping stone AG provided model
OpenCode_Desktop_First_Prompt.png|2. Enter a first prompt to check that the configuration works
</gallery>

== Configure appearance and notifications ==

You may customise the appearance and layout of the UI, notification settings, shortcuts and more via the settings menu.

<gallery mode=packed heights=200>
OpenCode_Desktop_settings.png|Available settings submenus
</gallery>

== Permissions ==

OpenCode provides a built in sandbox to limit what actions an agent is allowed to perform. You can configure permissions via the configuration file (there is currently no option to configure permissions via the user interface). Permissions are defined as a list of rules. For each action (e.g. read/write a file, execute a shell command, etc.), you may define a set of rules, each with a pattern determining when the rule applies, and an effect to determine if the action is allowed, denied or requires explicit approval by the user. The following shows some examples of permission rules:

<syntaxhighlight lang="json">
...
"permissions": [
{ "action": "shell", "resource": "*", "effect": "ask" },
{ "action": "shell", "resource": "git status *", "effect": "allow" },
{ "action": "shell", "resource": "git push *", "effect": "deny" },
{ "action": "skill", "resource": "*", "effect": "allow" },
{ "action": "read", "resource": "*", "effect": "allow" },
{ "action": "edit", "resource": "*.html", "effect": "allow" },
]
...
</syntaxhighlight>

{{Note|title=⚠️ Warning|content=Try to keep the permissions you define as restrictive as feasable. In particular, do not allow your agent to perform sensitive or dangerous actions without your explicit approval.}}

{{Note|title=⚠️ Warning|content=While OpenCode provides a sandbox controlled via permissions, you should never rely exclusively on the sandbox to ensure that your agent does not perform dangerous actions or accesses sensitive data. Always exercise good judgement when deciding what your agent should be allowed to do.}}

== Further steps ==

You now have a basic OpenCode agent setup available to you. You may further customise and extend OpenCode in a variety of ways, such as by adding skills, configuring MCP servers or OpenCode plugins.

Check [https://opencode.ai/v2/docs/ https://opencode.ai/v2/docs/] or the settings menu of OpenCode to see how you can extend your agent to your needs.

= References =

* [https://opencode.ai/v2/docs/ OpenCode documentation]
* [https://opencode.ai/v2/docs/providers OpenCode providers guide]
* [https://opencode.ai/v2/docs/config OpenCode configuration reference] and [https://opencode.ai/config.json configuration schema]
* [https://opencode.ai/v2/docs/permissions OpenCode permissions guide]
* [https://opencode.ai/v2/docs/mcp-servers OpenCode MCP servers guide]
* [https://modelcontextprotocol.io Model Context Protocol specification]
* [https://www.stepping-stone.ch/en/products/artificial-intelligence stepping stone AG – Artificial Intelligence]
* [[AI on Demand: Usage]]

[[Category: AI on Demand]]

AI on demand: Configuring OpenCode Desktop - Revision history

Sst-pde: /* Overview */

Sst-pde: Sst-pde moved page AI on Demand: Configuring OpenCode Desktop to AI on demand: Configuring OpenCode Desktop

Sst-pde at 14:45, 3 November 2026

Sst-pde: Sst-pde moved page AI on Demand: Configuring OpenCode to AI on Demand: Configuring OpenCode Desktop