Use OpenCode with STACKIT AI Model Serving

Prerequisites

• You have a STACKIT customer account: Create a customer Account
• You have a STACKIT user account: Create a user account
• You have a STACKIT project: Create a project

What is OpenCode?

OpenCode is an open-source AI coding assistant that runs in your terminal. It provides intelligent code completions, explanations, and refactoring suggestions powered by various LLM providers. STACKIT AI Model Serving is available as an official built-in provider in OpenCode, allowing you to use STACKIT’s hosted models directly in your development workflow.

For installation and system requirements, refer to the OpenCode documentation.

Get a STACKIT AI Model Serving Auth Token

To authenticate with STACKIT AI Model Serving, you need to create an auth token. Refer to Manage auth tokens to create your token in the STACKIT Portal.

The auth token is sensitive information that provides access to STACKIT AI Model Serving. Keep it secure and do not share it publicly.

Configure OpenCode to use STACKIT AI Model Serving

Refer to the OpenCode STACKIT Provider documentation for configuration steps. You will need your STACKIT AI Model Serving Auth Token during the setup.

See Available Shared Models for the complete list of available models.

Troubleshooting

Authentication errors

If you receive authentication errors:

1. Verify your auth token is still valid (tokens expire based on the ttlDuration set during creation)
2. Run /connect again and re-enter your token
3. Ensure you have access to the STACKIT project

Connection errors

If OpenCode cannot connect to STACKIT:

1. Check your network connection and firewall settings
2. Ensure the STACKIT AI Model Serving API is accessible from your network
3. Verify your auth token has not expired

Model not found

If you receive “model not found” errors:

1. Run /models to see the current list of available models
2. Check Available Shared Models for the current model catalog
3. Some models may have been updated or deprecated

Additional resources

• Available Shared Models
• Manage auth tokens
• STACKIT AI Model Serving API Documentation