Skip to content

docs: Add claude PATH troubleshooting section #157

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
+14 −0
Open

docs: Add claude PATH troubleshooting section #157

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,20 @@ After initialization, you should see the following commands available in your AI

## Troubleshooting

### Claude CLI Not Found Error

If you have Claude installed but see `⚠️ claude not found`, the installation cannot find the `claude` command in PATH.

**Quick fix:**
```bash
PATH="$HOME/.claude/local:$PATH" uvx --from git+https://github.com/github/spec-kit.git specify init --here
Copy link

Copilot AI Sep 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PATH assumes Claude is installed in $HOME/.claude/local, but this may not be accurate for all installations. Consider using a more generic example like PATH="/path/to/claude/directory:$PATH" or mention that users should replace with their actual Claude installation path.

Suggested change
PATH="$HOME/.claude/local:$PATH" uvx --from git+https://github.com/github/spec-kit.git specify init --here
# Replace /path/to/claude/directory with the actual path to your Claude installation
PATH="/path/to/claude/directory:$PATH" uvx --from git+https://github.com/github/spec-kit.git specify init --here

Copilot uses AI. Check for mistakes.
```

**Other solutions:**
- Find claude location: `which claude`
- Add to shell permanently: `export PATH="$HOME/.claude/local:$PATH"` in `~/.bashrc`/`~/.zshrc`
- Create symlink: `ln -s ~/.claude/local/claude /usr/local/bin/claude`
Comment on lines +58 to +66
Copy link

Copilot AI Sep 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to the quick fix, this assumes a specific installation path. Consider clarifying that users should verify their actual Claude installation location first, or provide instructions on how to find it.

Suggested change
**Quick fix:**
```bash
PATH="$HOME/.claude/local:$PATH" uvx --from git+https://github.com/github/spec-kit.git specify init --here
```
**Other solutions:**
- Find claude location: `which claude`
- Add to shell permanently: `export PATH="$HOME/.claude/local:$PATH"` in `~/.bashrc`/`~/.zshrc`
- Create symlink: `ln -s ~/.claude/local/claude /usr/local/bin/claude`
**Quick fix (default path):**
> Note: The path `$HOME/.claude/local` is the default for some installations. Your Claude installation may be elsewhere.
> To find the actual location, run:
>
> ```bash
> which claude
> ```
>
> Then, update your PATH accordingly. For example, if `which claude` returns `/home/user/.claude/local/claude`, use:
>
> ```bash
> export PATH="/home/user/.claude/local:$PATH"
> ```
>
> You can run the initialization command after updating your PATH:
>
> ```bash
> uvx --from git+https://github.com/github/spec-kit.git specify init --here
> ```
**Other solutions:**
- Add to shell permanently: Add the export line above to your `~/.bashrc` or `~/.zshrc`
- Create symlink: `ln -s $(which claude) /usr/local/bin/claude`

Copilot uses AI. Check for mistakes.

### Git Credential Manager on Linux

If you're having issues with Git authentication on Linux, you can install Git Credential Manager:
Expand Down