Skip to main content
Back to Home

Help & Guides

Everything you need to get started with Vibe Walk.

Install Claude Code

Required for Vibe Walk to work

Prerequisites

  • A Claude Pro or Max subscription from Anthropic
  • Node.js 18+ installed on your computer
1

Install Claude Code via npm

Open a terminal (Terminal on macOS, Command Prompt or PowerShell on Windows) and run:

npm install -g @anthropic-ai/claude-code
2

Authenticate with Anthropic

Run Claude Code once to log in:

claude

This will open your browser to authenticate with your Anthropic account.

3

Verify installation

Check that Claude Code is working:

claude --version

You should see a version number like 1.0.x.

Done! Claude Code is now installed and ready to use with Vibe Walk.

Connect Telegram

Create a private bot in 2 minutes

1

Open BotFather in Telegram

Search for @BotFather in Telegram, or click:

Open @BotFather
2

Create a new bot

Send this command to BotFather:

/newbot

BotFather will ask you for a name and username for your bot. Choose anything you like (e.g., "My Code Bot").

3

Copy your bot token

BotFather will give you a token that looks like:

123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Keep this token secret! Anyone with it can control your bot.

4

Get your Telegram User ID

Search for @userinfobot in Telegram and start a chat. It will reply with your user ID:

Your user ID: 123456789

This ensures only you can use the bot.

5

Configure Vibe Walk

In the Vibe Walk app, add a new project and paste:

  • Bot Token — from step 3
  • User ID — from step 4
  • Project Path — the folder you want Claude to work in

Done! Start the bot and send a message to your bot in Telegram.

Power Tips

Get the most out of Vibe Walk

Use the -c flag for session continuity

When you code in the terminal without Vibe Walk, use the -c flag to continue your most recent Claude session. This keeps Claude's memory of your project intact, so it remembers previous work done via Vibe Walk.

claude -c

Vibe Walk uses this flag by default, so switching between mobile and desktop is seamless.

Enable "Bypass Permissions" for seamless mobile coding

By default, Claude Code asks for confirmation before making file changes or running commands. This works great when you're at your desk, but when you're on mobile, those confirmation prompts can't reach you through Telegram.

Enabling "Bypass Permissions" in the Vibe Walk settings lets Claude execute changes autonomously. You can review what happened when you return to your desk, or ask Claude to explain what it did.

💡 Tip: Use this on projects with version control (git) so you can easily review and revert changes if needed.

Prevent your computer from sleeping

If your computer goes to sleep, Vibe Walk can't respond to your Telegram messages. To keep your bot available 24/7, prevent sleep when plugged in:

macOS

  1. 1.Open System SettingsEnergy Saver (or Battery on laptops)
  2. 2.Enable "Prevent automatic sleeping when the display is off"
  3. 3.Optionally, use the caffeinate command in Terminal to temporarily prevent sleep
caffeinate -d -i -s# Keeps Mac awake until you press Ctrl+C

Windows

  1. 1.Open SettingsSystemPower & sleep
  2. 2.Set "When plugged in, put my device to sleep after" to Never

Frequently Asked Questions

Is my code sent to the cloud?

No. Your code stays on your machine. Only the text of your messages travels through Telegram's servers. Claude Code runs locally and never uploads your source files.

Do I need a Claude API key?

No. Vibe Walk uses your existing Claude Pro or Max subscription through the Claude Code CLI. There are no additional API costs.

Can someone else use my bot?

Only if they know your Telegram User ID and it's configured in Vibe Walk. By default, the bot only responds to your user ID.

What happens if my computer goes to sleep?

The bot will stop responding until your computer wakes up. On macOS, adjust your Energy Saver settings. On Windows, set "Power & sleep" to Never when plugged in. See the Power Tips section for details.

How do I update Claude Code?

Run the same install command to get the latest version:

npm install -g @anthropic-ai/claude-code