Sst-pde: /* Overview */

2026-11-03T15:06:17Z

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 terminal variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on demand: ~~Configure~~ OpenCode Desktop]]		'''Note:''' This guide walks through configuring the terminal variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on demand: Configuring OpenCode Desktop]]

	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 at 15:05, 3 November 2026

2026-11-03T15:05:58Z

← Older revision		Revision as of 16:05, 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 terminal variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on ~~Demand~~: Configure OpenCode Desktop]]		'''Note:''' This guide walks through configuring the terminal variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on demand: Configure OpenCode Desktop]]

	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: 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-03T15:05:33Z

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 terminal variant of OpenCode. If you are looking for guidance on setting up the terminal version of OpenCode, see [[AI on Demand: Configure OpenCode Desktop]]

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 ==

Use your JavaScript package manager of choice to install the terminal variant of OpenCode:

<syntaxhighlight lang="bash">
npm install -g @opencode/cli
# or
bun install -g --trust @opencode/cli
# or
brew install anomalyco/tap/opencode-v2
</syntaxhighlight>

See [https://opencode.ai/v2/docs https://opencode.ai/v2/docs] for further information on how to install OpenCode.

Verify that the installation was successful by starting OpenCode:
<syntaxhighlight lang="bash">
opencode --version
opencode
</syntaxhighlight>

<gallery mode=packed heights=200>
OpenCode TUI.png|thumb|OpenCode Terminal
</gallery>

== Configure provider and models ==

To configure stepping stone AG as your provider, you must modify 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, you should be able to select the newly added model hosted by stepping stone AG from the list of available models. You can open a selection of all models available to you via the shortcut <code>CTRL + X</code>, <code>m</code>. You may need to scroll to the end of the displayed list.
<gallery mode=packed heights=200>
OpenCode_TUI_Model_selection.png|Model selection menu
</gallery>

Finally, select the newly added model, then enter a first prompt to test that the model is working correctly.
<gallery mode=packed heights=200>
OpenCode_TUI_Initial_prompt.png|Enter an initial prompt
OpenCode_TUI_Initial_prompt_response.png|Check that you receive a response
</gallery>

== Useful short-cuts and menus ==

The following is a list of useful shortcuts to get started with using OpenCode:

* <code>CTRL + P</code>: Open the main menu to interact with the agent, manage sessions and MCP servers, configuration, theming, etc.
* <code>CTRL + X</code> / <code>N</code>: Open a fresh session.
* <code>CTRL + X</code> / <code>L</code>: Switch to another existing session.
* <code>CTRL + X</code> / <code>W</code>: Close the current session tab.
* <code>CTRL + X</code> / <code>M</code>: Switch the current model.
* <code>CTRL + X</code> / <code>A</code>: Switch the current agent mode.
* <code>CTRL + X</code> / <code>Q</code>: Quit OpenCode.
* <code>CTRL + C</code>: Clear prompt input field.

== 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/] to see how you can extend your configuration file to adapt 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]]
[[Category: OpenCode]]

AI on demand: Configuring OpenCode Terminal - Revision history

Sst-pde: /* Overview */

Sst-pde at 15:05, 3 November 2026