# Troubleshooting

> Troubleshooting instructions for OpenCode - common issues and solutions

- Skill: `timsonner/troubleshooting` (Agent Skill)
- Install (CLI): `npx skillmds@latest add timsonner/troubleshooting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/timsonner/troubleshooting/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: timsonner (https://skillmd.com/u/timsonner)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/timsonner/troubleshooting

---


# OpenCode Troubleshooting

For troubleshooting common issues with OpenCode, refer to the [Troubleshooting](/docs/troubleshooting/) documentation.

## Common Issues

- Installation problems
- Configuration errors
- Provider connection issues
- Performance problems
- Feature-specific issues

## Getting Help

If you encounter issues not covered in the documentation:

1. Check the [GitHub Issues](https://github.com/anomalyco/opencode/issues)
2. Join the [Discord community](https://opencode.ai/discord)
3. Contact support through official channels

## Windows-Specific Issues

For Windows users, we recommend using [Windows Subsystem for Linux (WSL)](/docs/windows-wsl) for the best experience.

If you encounter issues on Windows:

- Try using WSL2
- Ensure you have the latest updates
- Check for compatibility issues with your terminal emulator