Frequently Asked Questions

Answers to common questions about setting up and using Vicoa

What is Vicoa?

Vicoa (Vibe Code Anywhere) is a platform that lets you run coding agents like Claude Code, Codex, and OpenCode remotely from any device. Start coding on your laptop, continue seamlessly on your phone or tablet, and get instant notifications when your AI agent needs input.

Do I need coding experience to use Vicoa?

Nope. You don't need traditional coding experience. Vicoa is made for people who uses coding agents. If you can type ideas, tweak prompts, and run simple commands, you're good to go.

What can I build with Vicoa?

You can build anything that Claude Code, Codex, and OpenCode support: web applications, APIs, automation scripts, mobile apps, data analysis tools, and more. Vicoa doesn't limit what you can create, it just lets you create it from anywhere, whether you're on a laptop, phone, or tablet.

How does Vicoa work?

Vicoa creates a remote session that connects your local development environment with our server. When you run vicoa in your terminal, it establishes a secure connection that lets you interact with Claude Code, Codex, or OpenCode from any device. Your prompts and agents' responses stay synced, and you get push notifications when the AI needs your input.

What devices and platforms does Vicoa support?

Vicoa works on:

iOS: Download from the App Store
Web: Access at https://app.vicoa.ai from any browser
CLI: Works on macOS, Linux, and Windows with Python installed
Android: Coming soon - Join the waitlist

Is Vicoa free to use?

Vicoa offers a free tier to get started. You'll need your own API keys for Claude or other AI providers. For advanced features and higher usage limits, check our pricing page for details.

How long does it take to set up Vicoa?

You can go from installation to your first remote coding session in under 5 minutes. Simply run 'pip install vicoa', launch with 'vicoa', and connect from any device, no complex configuration required.

Can I use Vicoa with my existing projects?

Absolutely. Vicoa works with any project that Claude Code, Codex, or OpenCode can work with. Just navigate to your project directory and run vicoa to start a session. Your existing codebase, git repositories, and development tools all work seamlessly.

How do I connect Vicoa with Claude Code?

Follow the Getting Started guide to install Vicoa
Ensure Claude Code is installed
Launch the CLI: vicoa
Sign in with your Vicoa account if prompted
Claude Code is the default agent, so you're connected and ready to go
If you previously switched agents, restore Claude Code as default with vicoa --set-default claude

How do I connect Vicoa with Codex?

Follow the Getting Started guide to install Vicoa
Ensure Codex tools are installed and configured
Run vicoa --agent codex or vicoa codex to start a session with Codex
To set Codex as default for future sessions: vicoa --set-default codex
Switch back to Claude Code anytime with vicoa --set-default claude

How do I connect Vicoa with OpenCode?

Follow the Getting Started guide to install Vicoa
Ensure OpenCode is installed
Run vicoa --agent opencode or vicoa opencode to start a session with OpenCode
The OpenCode plugin installs automatically and syncs with Vicoa
To set OpenCode as default: vicoa --set-default opencode
Learn more in the OpenCode documentation

How do I update to the latest version of Vicoa?

Update CLI

Keep your CLI up to date with the latest features and bug fixes:

pip install --upgrade vicoa

To check your current version:

vicoa --version

Update Apps

iOS: Update through the App Store
Web: The web app at https://app.vicoa.ai is always up to date
Android: Coming soon - Join the waitlist

What features does the Vicoa CLI support?

The Vicoa CLI supports many advanced features including:

File mentions: Use @filename to reference files directly
Slash commands: Quick access to common workflows with /command
Permission modes: Switch between plan mode, accept edits, and bypass permissions
Agent switching: Switch between Claude Code, Codex, and OpenCode
Remote sessions: Access your session from any device

Learn more in the Vicoa Features guide.

Visit the how to redeem a promo code page for instructions.

Is my code secure with Vicoa?

Yes. Vicoa establishes secure connections between your local environment and our infrastructure. Your code stays in your local development environment.

How do notifications work?

When your AI agent (Claude Code, Codex, or OpenCode) needs your input, like confirming an action or answering a question, Vicoa sends you an instant push notification on your mobile device. This means you can step away from your computer and still stay responsive.

When should I use Vicoa?

Vicoa is perfect for developers who:

Want to code on the go from mobile or tablet
Need to monitor long-running AI coding sessions
Work across multiple devices throughout the day
Want instant notifications when their AI agent needs input
Value the flexibility to code from anywhere, anytime

What's the difference between the web app and mobile app?

Both the web app and mobile apps provide the same core functionality: access to your remote Claude Code, Codex, and OpenCode sessions, real-time updates, and notifications. The mobile apps offer native push notifications and a mobile-optimized interface, while the web app works on any device with a browser. Choose based on your preference and workflow.

Can I switch between Claude Code, Codex, and OpenCode?

Yes, Vicoa supports Claude Code, Codex, and OpenCode. You can start a session with any agent and switch between them freely:

vicoa for Claude Code (default)
vicoa codex for Codex
vicoa opencode for OpenCode

Set your preferred default with vicoa --set-default <agent>. Learn more in the Agents documentation.

Need more help? Reach out at hi@vicoa.ai or browse the rest of the docs for more information.

On this page