Set up Vicoa

Install, authenticate, and start using Vicoa on your laptop, tablet, or phone.

Vicoa allows you to run a team of coding agents (Claude Code, Codex, and OpenCode) anywhere, on any device. Follow this guide to get started in minutes.

Vicoa CLI System Requirements

• Operating systems: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+
• Hardware: 4 GB RAM or more
• Software: Node.js installed, one of Claude Code, Codex, or OpenCode
• Network: Internet connection required for authentication and AI processing
• Shell: Works best in Bash, Zsh, Fish, or PowerShell

Video Walkthrough

Watch this complete walkthrough from CLI installation to sending messages remotely to Claude Code:

Installation

1. Install Vicoa CLI

npm i -g @vicoa/cli

To update to the latest version at any time:

npm i -g @vicoa/cli@latest

Check your installed version:

vicoa --version

Alternatively, you can install via pip:

pip install vicoa

2. Install a coding agent (if needed)

Install one of the supported coding agents before setting up Vicoa.

curl -fsSL https://claude.ai/install.sh | bash

winget install Anthropic.Claude

npm i -g @openai/codex

npm i -g opencode-ai

npm i -g opencode-ai

3. Start a coding session

macOS / Linux

vicoa

Windows

vicoa daemon

On macOS / Linux, a coding session will appear in the left sidebar of the Vicoa web app.

On Windows, click New Session in the left sidebar to start a session. Learn more

4. Web Authorization

When you run vicoa or vicoa daemon for the first time, you'll be redirected to the web browswer to:

1. Create an account or sign in if you already have one
2. Authorize your CLI session
3. Send a message to your coding agent to test the connection

5. Mobile App

• iOS
• Android

Sign in with the same account you used on the web.

Next Steps

Now that Vicoa is installed, you can start coding anywhere with Claude Code, Codex, and OpenCode. Learn how to use these agents in Vicoa here.

Need help?

• Check our troubleshooting guide for common issues
• Feature requests and raise issues: https://github.com/vicoa-ai/vicoa-open
• Contact support at hi@vicoa.ai