Set up Vicoa

Install, authenticate, and start using Vicoa on your development machine.

Vicoa lets you run Claude Code and Codex anywhere, on any device. Follow this guide to get started in minutes.

System Requirements

• Operating systems: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+ (with WSL 1, WSL 2, or Git for Windows)
• Hardware: 4 GB RAM or more
• Software: Python 3.10+, Claude Code or Codex installed
• Network: Internet connection required for authentication and AI processing
• Shell: Works best in Bash, Zsh, or Fish
• Location: Any country where Anthropic services are available

To check your Python version:

python --version # or `python3 --version`

Video Walkthrough

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

Installation

1. Install Vicoa CLI

Install Vicoa using pip in your terminal:

pip install vicoa

To start the Vicoa CLI, run:

vicoa

2. Web Authorization

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

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

The web interface will guide you through:

• Account verification
• CLI session linking

3. Mobile App Download

Once your CLI is set up, download the mobile app to code on the go:

iOS

• Scan the QR code in your dashboard or download directly
• Full feature parity with web and CLI

Android

• Coming soon - join the waitlist

Note: Login with the same account you used for the web interface.

Next Steps

Now that Vicoa is installed, you can start coding anywhere with Claude Code and Codex.

• Learn how to switch between agents in Claude Code and Codex 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@habitrewards.me