CLI 常见问题与路径速查¶
CLI 工具常见问题¶
| 问题 | 解决方案 |
|---|---|
npm 命令不存在 |
需先安装 Node.js，参考上方安装步骤 |
| 安装时权限不足 | Linux/Mac：命令前加 sudoWindows：以管理员身份运行命令提示符 |
| 配置文件不生效 |
1. 检查文件路径是否正确 2. 检查 JSON 格式是否正确 3. 重启 CLI 工具 |
| Claude Code 上下文耗尽 | 输入 /clear 清理上下文，或使用 compact 命令压缩 |
| Claude Code 500 错误 | 开启新对话，不要尝试恢复死循环对话 |
| 令牌无效 | 检查令牌是否复制完整，确认分组选择正确 |
配置文件路径速查表¶
| 工具 | Windows 路径 | macOS / Linux 路径 |
|---|---|---|
| Claude Code | %USERPROFILE%.claude\settings.json |
~/.claude/settings.json |
| CodeX | %USERPROFILE%.codex\config.toml%USERPROFILE%.codex\auth.json |
~/.codex/config.toml~/.codex/auth.json |
| Gemini CLI | %USERPROFILE%.gemini.env%USERPROFILE%.gemini\settings.json |
~/.gemini/.env~/.gemini/settings.json |