From 607b085cb89124f472e066ae78f114b3f4d7bc52 Mon Sep 17 00:00:00 2001 From: Sobuur Date: Thu, 22 Jan 2026 01:31:10 +0100 Subject: [PATCH] docs: add troubleshooting section for Claude authentication errors --- README.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/README.md b/README.md index 9ba101be..e8eb5f23 100644 --- a/README.md +++ b/README.md @@ -153,6 +153,38 @@ export DISABLE_AUTOUPDATER=1 --- +## Troubleshooting + +### "Claude test failed" Error + +If you see an error message like `Claude test failed:` when starting Vide, this typically means there's an issue with your Claude Code CLI authentication. + +**To diagnose:** + +Open a separate terminal and run: +```bash +claude --print 'Respond with exactly: "Connected and ready to help!"' +``` + +**Common issues:** + +1. **Authentication expired** - If you see an OAuth token expired error: +```bash + claude login +``` + Follow the prompts to re-authenticate with your Claude account. + +2. **Claude Code not installed** - Install it: +```bash + npm install -g @anthropic-ai/claude-code +``` + +3. **Claude Code not in PATH** - Ensure the installation directory is in your system's PATH environment variable. + +After resolving the issue, restart Vide. + +--- + ## Agent Architecture ```