Claude-code as a dating sim in a virtual machine, fully vibe coded.
Claude-chan is based off Chiyo Sakura.
- Terminal app to see logs
- Switch between voices
- Switch between sceneries
- Tons of Claude-chan sprites (by Grok)
- Intuitive controls from dating sims
- A robots.txt + many comments in the code for your Claude-code to understand
- Can edit your files, do tasks for you, etc.
- Attachment/long message pasting
ESCto cancel response/thinking- Permission requests (popup)
- Switch between models
Claude-chan's messages are displayed as click-through segments, visual-novel style.
Claude-chan is made to have as little dependencies as possible! Only Archlinx and Windows supported rn.
python3 - Pacman
sudo pacman -S python
claude-code - AUR
yay -S claude-code
Note
This part is uh, vibecoded, so idk if it really works..
python3 - winget
winget install Python.Python.3.12
If you want to install manually from python.org instead, tick "Add python.exe to PATH".
claude-code - PowerShell
irm https://claude.ai/install.ps1 | iex
Or if you prefer npm:
npm install -g @anthropic-ai/claude-code
git clone https://github.com/halosviel/Claude-chan.git
cd Claude-chan
Make sure you are signed in your respective Claude-code app and have an active subscription!!!
Open the project in VSC and simply press F5. It should open the terminal and you should see something like this:

Then, open the http://localhost:8765 website in your browser! (might be different for you)
This works the same on Linux and Windows.
Run AivisSpeech in a new terminal:
~/.local/bin/aivisspeech-engine
Then run server.py in another terminal:
cd ~/Local/Projects/Claude_chan
python3 server.py
Install AivisSpeech and launch it. Make sure it's running in the background.
Then run server.py from PowerShell (or cmd):
cd path\to\Claude-chan
python server.py
Make sure AivisSpeech and the python server are running simultaneously.
Open the http://localhost:8765 website in your browser (might be different).
Ask your Claude-code to debug!