从这里，开始第一次调用。Your first request starts here.

macOS / Linux：查看版本与命令位置macOS / Linux: check version and command locations

type -a claude
claude --version

Windows PowerShell：查看版本与命令位置Windows PowerShell: check version and command locations

Get-Command claude -All | Select-Object CommandType, Source
claude --version

检查安装与更新状态Check installation and update status

如果存在多个 claude 路径，先确认实际使用哪一份，再更新对应的安装。If multiple claude commands are found, identify the active installation before updating it.

claude doctor

退出已保存的官方登录Sign out of your saved official account

在卸载前运行。使用门户 Key 时，还需清除接入变量或个人 settings.json 中对应的 env 项；退出登录不会撤销门户 Key。Run before uninstalling. For a portal key, also clear connection variables or matching env entries in your personal settings.json. Signing out does not revoke the portal key.

claude auth logout

macOS / Linux：清除当前终端的接入变量macOS / Linux: clear connection variables in this terminal

关闭工具后执行，再从同一终端重新启动。若变量写入 ~/.zshrc、~/.bashrc 或工具配置，也需编辑对应文件移除；此命令只影响当前终端。Close the tool, run these commands, then restart it from this terminal. Also remove matching entries from ~/.zshrc, ~/.bashrc or tool settings if saved there. These commands affect only the current terminal.

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY

Windows PowerShell：清除当前终端的接入变量Windows PowerShell: clear connection variables in this terminal

如果曾保存为用户环境变量，再到下方的“持久化变量与缓存”清理。关闭旧终端，重新登录系统后再验证。For saved user variables, also follow Persistent variables and caches below. Close old terminals and sign in to the operating system again before checking.

Remove-Item Env:ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue

预览指定项目的本地记录清理Preview local record cleanup for one project

此命令形式适用于 Claude Code 2.1.288 及以上，旧版曾使用 claude project purge。先用 --version 和 --help 核对支持情况，再替换为目标项目路径进行预览；此步骤不会删除。This syntax applies to Claude Code 2.1.288 and later; older versions used claude project purge. Check --version and --help first, then replace the project path to preview the cleanup. This step does not delete anything.

claude purge "YOUR_PROJECT_PATH" --dry-run

确认清理指定项目的本地记录Confirm local record cleanup for one project

关闭该项目的 Claude 会话，核对上一步预览后逐项确认。会删除本地会话与相关状态，无法用来恢复对话；项目源代码不是此命令的清理对象。Close Claude sessions for this project, review the preview, then confirm each item. Local conversations and related state are deleted and cannot be resumed. This command does not target project source code.

claude purge "YOUR_PROJECT_PATH" --interactive

可选：重置个人数据（macOS / Linux）Optional: reset personal data (macOS / Linux)

仅限默认用户目录。先关闭 Claude Code、相关 IDE 插件和桌面应用。此操作把设置、MCP、技能及会话移到私人备份目录，重新启动后会重新建立数据；备份仍占空间，可能含凭据。确认不再需要后再手动删除备份。项目里的 .claude、CLAUDE.md 和 .mcp.json 需单独检查。For default user directories only. Close Claude Code and related IDE and desktop apps. Settings, MCP, skills and sessions move to a private backup; new data is created on restart. Backups still use disk space and may contain credentials. Delete them manually only when no longer needed. Check project .claude, CLAUDE.md and .mcp.json separately.

cli_backup_dir="$HOME/claude-backup-$(date +%Y%m%d-%H%M%S)"
if (umask 077; mkdir "$cli_backup_dir"); then
  [ ! -e "$HOME/.claude" ] || mv -i "$HOME/.claude" "$cli_backup_dir/"
  [ ! -e "$HOME/.claude.json" ] || mv -i "$HOME/.claude.json" "$cli_backup_dir/"
fi

可选：重置个人数据（Windows PowerShell）Optional: reset personal data (Windows PowerShell)

关闭相关程序后执行；会移走默认用户目录里的设置和会话，保留备份。仅在重置故障配置或清除本机数据时使用，日常更新无需执行。备份可能包含密钥，不要上传。Close related apps first. Settings and sessions in default user directories are moved into a backup. Use only to reset broken configuration or clear local data, not for routine updates. Backups may contain keys; do not upload them.

$cliBackupDir = Join-Path $env:USERPROFILE ("claude-backup-" + [guid]::NewGuid().ToString("N"))
New-Item -ItemType Directory -Path $cliBackupDir -ErrorAction Stop | Out-Null
foreach ($cliPath in @("$env:USERPROFILE\.claude", "$env:USERPROFILE\.claude.json")) {
  if (Test-Path -LiteralPath $cliPath) { Move-Item -LiteralPath $cliPath -Destination $cliBackupDir -ErrorAction Stop }
}

macOS / Linux：查看版本与命令位置macOS / Linux: check version and command locations

type -a codex
codex --version

Windows PowerShell：查看版本与命令位置Windows PowerShell: check version and command locations

Get-Command codex -All | Select-Object CommandType, Source
codex --version

清除已保存的登录凭据Remove saved login credentials

先关闭其他 Codex 会话，在卸载前运行。凭据可能保存在 auth.json 或系统凭据库，使用退出命令处理；CLI 与 IDE 可能共用登录状态。门户环境变量 Key 还需单独清除。Close other Codex sessions and run before uninstalling. Use logout to clear credentials stored in auth.json or the system credential store. CLI and IDE may share login state. Clear the portal key environment variable separately.

codex logout

macOS / Linux：清除当前终端的接入变量macOS / Linux: clear connection variables in this terminal

关闭工具后执行，再从同一终端重新启动。若变量写入 ~/.zshrc、~/.bashrc 或工具配置，也需编辑对应文件移除；此命令只影响当前终端。Close the tool, run these commands, then restart it from this terminal. Also remove matching entries from ~/.zshrc, ~/.bashrc or tool settings if saved there. These commands affect only the current terminal.

unset PORTAL_API_KEY

Windows PowerShell：清除当前终端的接入变量Windows PowerShell: clear connection variables in this terminal

如果曾保存为用户环境变量，再到下方的“持久化变量与缓存”清理。关闭旧终端，重新登录系统后再验证。For saved user variables, also follow Persistent variables and caches below. Close old terminals and sign in to the operating system again before checking.

Remove-Item Env:PORTAL_API_KEY -ErrorAction SilentlyContinue

macOS：清除桌面应用的会话环境变量macOS: clear the desktop session environment variable

适用于曾按桌面教程使用 launchctl setenv 的用户。先完全退出桌面应用，清除后重新打开。For users who followed the desktop guide with launchctl setenv. Fully quit the desktop app and reopen it after clearing the variable.

launchctl unsetenv PORTAL_API_KEY

可选：重置用户配置（macOS / Linux）Optional: reset user configuration (macOS / Linux)

先关闭 CLI、IDE 扩展和桌面工作区。此操作备份并移走用户 config.toml，个人模型、MCP 和偏好需重新配置；会话、技能和工作树保留。项目配置与组织托管策略仍可能生效。Close the CLI, IDE extension and desktop workspace. Backs up and moves your config.toml; model, MCP and preference settings must be configured again. Sessions, skills and worktrees remain. Project configuration and managed policies may still apply.

cli_state_dir="${CODEX_HOME:-$HOME/.codex}"
if [ -f "$cli_state_dir/config.toml" ]; then
  mv -i "$cli_state_dir/config.toml" "$cli_state_dir/config.toml.backup-$(date +%Y%m%d-%H%M%S)"
fi

可选：重置用户配置（Windows PowerShell）Optional: reset user configuration (Windows PowerShell)

仅重置用户配置文件，备份仍可能包含敏感配置。不要把整个 .codex 当成缓存删除，其中可能还有会话、技能、数据库和未合并的工作树；历史清理优先使用所在客户端的管理功能。Resets only the user configuration file. Backups may contain sensitive settings. Do not delete the whole .codex directory as a cache: it may contain sessions, skills, databases and unmerged worktrees. Prefer your client's history management features.

$cliStateDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }
$cliConfigPath = Join-Path $cliStateDir "config.toml"
if (Test-Path -LiteralPath $cliConfigPath) {
  Move-Item -LiteralPath $cliConfigPath -Destination ($cliConfigPath + ".backup-" + [guid]::NewGuid().ToString("N")) -ErrorAction Stop
}

macOS / Linux：查看版本与命令位置macOS / Linux: check version and command locations

type -a gemini
gemini --version

Windows PowerShell：查看版本与命令位置Windows PowerShell: check version and command locations

Get-Command gemini -All | Select-Object CommandType, Source
gemini --version

macOS / Linux：清除当前终端的接入变量macOS / Linux: clear connection variables in this terminal

关闭工具后执行，再从同一终端重新启动。若变量写入 ~/.zshrc、~/.bashrc 或工具配置，也需编辑对应文件移除；此命令只影响当前终端。Close the tool, run these commands, then restart it from this terminal. Also remove matching entries from ~/.zshrc, ~/.bashrc or tool settings if saved there. These commands affect only the current terminal.

unset GEMINI_API_KEY GOOGLE_GEMINI_BASE_URL

Windows PowerShell：清除当前终端的接入变量Windows PowerShell: clear connection variables in this terminal

如果曾保存为用户环境变量，再到下方的“持久化变量与缓存”清理。关闭旧终端，重新登录系统后再验证。For saved user variables, also follow Persistent variables and caches below. Close old terminals and sign in to the operating system again before checking.

Remove-Item Env:GEMINI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:GOOGLE_GEMINI_BASE_URL -ErrorAction SilentlyContinue

查看当前项目的已保存会话List saved sessions for the current project

在目标项目目录运行。先核对会话 ID，再决定删除哪一条；普通清屏不会删除已保存记录。Run in the target project directory. Check session IDs before choosing one to delete. Clearing the terminal does not delete saved records.

gemini --list-sessions

删除指定会话Delete a specific session

将占位符替换为上一步确认的 ID，会删除该会话及关联数据。~/.gemini/tmp 中也包含会话与计划，不能当成普通下载缓存整体清空。Replace the placeholder with the ID you checked. Deletes that session and related data. ~/.gemini/tmp also contains sessions and plans; do not clear it as a download cache.

gemini --delete-session "YOUR_SESSION_ID"

检查登录方式Check authentication method

在 Gemini CLI 内运行以管理认证方式。若曾使用 Google 登录，环境变量清理不会撤销 Google 授权；按认证界面处理，不要将 oauth_creds.json 当成可公开的缓存文件。Run inside Gemini CLI to manage authentication. Clearing environment variables does not revoke Google authorization. Use the authentication interface; oauth_creds.json is not a cache file you can share.

/auth

安装包方式：更新与卸载Installers: update and uninstall

从官方 Releases 下载同一系统的新版本，关闭应用后按安装包说明更新。Windows 在“已安装的应用”卸载；macOS 移除应用；Linux 使用原安装包对应的包管理器。此桌面项目不使用旧教程中的 npm install -g cc-switch。Download the new release for your OS, close the app and follow the installer instructions. Uninstall through Installed apps on Windows, remove the app on macOS, or use the original package manager on Linux. The old npm install -g cc-switch command does not apply to this desktop project.

https://github.com/farion1231/cc-switch/releases

清理提供方与已写入的配置Remove providers and generated configuration

先在 CC Switch 中移除不再使用的提供方，再检查它写入的 CLI 配置和环境变量。删除桌面应用不会自动恢复这些文件；仅编辑对应提供方的条目，保留其他模型和设置。Remove unused providers in CC Switch, then check the CLI settings and environment variables it wrote. Removing the desktop app does not restore those files. Edit only the relevant provider entries.

Claude Code → ~/.claude/settings.json
Codex → ~/.codex/config.toml

更新与卸载桌面应用Update and uninstall the desktop app

通过应用的更新入口或官方安装包更新。先保存工作并关闭 Cursor；Windows 在“已安装的应用”卸载，macOS 移除应用，Linux 按原安装方式移除软件包或 AppImage。Update through the app or an official installer. Save your work and close Cursor. Use Installed apps on Windows, remove the app on macOS, or remove the original package or AppImage on Linux.

https://cursor.com/download

清除自定义接入配置Remove custom connection settings

移除自己的 API Key、自定义 Base URL 和不再使用的模型。若启用了设置同步，检查其他设备是否仍保存配置。需要清理会话时，先导出所需内容，再使用客户端提供的删除入口。Remove your API key, custom base URL and unused models. If settings sync is enabled, check other devices too. Export any conversations you need before deleting them through the client.

Settings → Models / API Keys

JetBrains 插件管理JetBrains plugin management

在插件管理页选择更新或卸载，并按提示重启 IDE。VS Code 的 code 命令不适用于 JetBrains。Update or uninstall in Plugins, then restart the IDE if prompted. VS Code's code commands do not apply to JetBrains.

Settings / Preferences → Plugins → Installed → Continue

清理本地模型配置Remove local model configuration

先关闭 IDE，从配置中移除对应模型和 apiKey。若使用环境变量、其他配置文件或远程开发环境，也检查对应来源。保留仍在使用的模型；卸载插件不会自动撤销门户密钥。Close the IDE and remove the relevant model and apiKey entries. Also check environment variables, other configuration files and remote environments. Keep models you still use. Uninstalling the extension does not revoke portal keys.

~/.continue/config.yaml

macOS / Linux：查看版本与命令位置macOS / Linux: check version and command locations

type -a aider
aider --version

Windows PowerShell：查看版本与命令位置Windows PowerShell: check version and command locations

Get-Command aider -All | Select-Object CommandType, Source
aider --version

macOS / Linux：清除当前终端的接入变量macOS / Linux: clear connection variables in this terminal

关闭工具后执行，再从同一终端重新启动。若变量写入 ~/.zshrc、~/.bashrc 或工具配置，也需编辑对应文件移除；此命令只影响当前终端。Close the tool, run these commands, then restart it from this terminal. Also remove matching entries from ~/.zshrc, ~/.bashrc or tool settings if saved there. These commands affect only the current terminal.

unset OPENAI_API_BASE OPENAI_API_KEY

Windows PowerShell：清除当前终端的接入变量Windows PowerShell: clear connection variables in this terminal

如果曾保存为用户环境变量，再到下方的“持久化变量与缓存”清理。关闭旧终端，重新登录系统后再验证。For saved user variables, also follow Persistent variables and caches below. Close old terminals and sign in to the operating system again before checking.

Remove-Item Env:OPENAI_API_BASE -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue

清理 Aider 的 uv 下载缓存Clear Aider's uv download cache

仅用于 uv 安装方式，清理指定包缓存；再次安装可能重新下载。会话历史和项目文件不属于这个缓存。For uv installations only. Clears this package's cache; reinstalling may download it again. Session history and project files are separate.

uv cache clean aider-chat

macOS / Linux：删除当前项目的默认历史文件macOS / Linux: delete this project's default history files

先退出 Aider，并确认当前目录就是目标项目。命令逐个确认删除，只覆盖默认历史文件；若自定义历史路径，需单独处理。项目代码、Git 历史、.env 与 .aider.conf.yml 保留。Exit Aider and check the current project directory. Confirms deletion of each default history file. Handle custom history paths separately. Source code, Git history, .env and .aider.conf.yml remain.

pwd
rm -i .aider.chat.history.md .aider.input.history

Windows PowerShell：删除当前项目的默认历史文件Windows PowerShell: delete this project's default history files

核对当前项目后确认删除。若密钥写在用户配置或项目 .env 中，需手动移除相应条目，不要直接删除整个项目 .env。Check the project before confirming deletion. Remove key entries from user settings or project .env manually if present; keep the rest of the .env file.

Get-Location
Remove-Item -LiteralPath ".aider.chat.history.md", ".aider.input.history" -Confirm

检查当前 Compose 服务Check current Compose services

以下命令均在这套 LobeHub 的 Compose 目录运行。旧版单容器 LobeChat 需先按官方迁移文档处理，不能直接套用另一套部署的配置。Run all commands in this LobeHub deployment's Compose directory. For an older single-container LobeChat deployment, follow the official migration instructions before adopting a different deployment configuration.

docker compose ps

更新现有 Compose 部署Update an existing Compose deployment

先备份数据库、上传文件及 .env，阅读目标版本的迁移要求并更新对应配置；确认镜像标签指向目标版本后再执行。会重建相关服务并中断正在进行的请求。Back up databases, uploads and .env, then review migration requirements and update configuration for your target version. Confirm the image tags before running. Services are recreated and active requests are interrupted.

docker compose pull
docker compose up -d

卸载这套 Compose 服务Remove this Compose deployment

停止并删除当前 Compose 项目的容器和网络，保留持久化卷与绑定目录。不要添加 -v，除非已备份且确定要永久删除卷内数据库和文件。Stops and removes this Compose project's containers and networks while keeping persistent volumes and bind mounts. Add -v only if you have backups and intend to permanently delete databases and files in those volumes.

docker compose down

核对旧镜像后按 ID 清理Check old images before removing by ID

仅删除已确认不再使用的旧镜像，可使用 docker image rm IMAGE_ID（替换为核对后的 ID）。数据库卷、上传目录、.env 和浏览器会话属于用户数据；移除容器不等于清空这些数据。Remove only confirmed unused images with docker image rm IMAGE_ID, replacing the ID after checking. Database volumes, uploads, .env and browser sessions are user data; removing containers does not erase them.

docker image ls

更新与卸载客户端Update and uninstall the client

通过客户端更新入口、官方安装包或原应用商店更新。卸载前先导出需要的对话和设置，再通过操作系统的应用管理卸载。Update through the client, official installer or original app store. Export conversations and settings you need before uninstalling through your operating system.

https://chatboxai.app

清理提供方与本地记录Remove providers and local records

在模型提供方设置中移除不再使用的 API Key 和地址。对话记录先导出备份，再从客户端删除；备份也可能含敏感内容。清除本机数据不会删除门户用量记录或撤销 Key。Remove unused API keys and addresses in provider settings. Export conversations before deleting them in the client; backups may contain sensitive data. Clearing local data does not remove portal usage records or revoke keys.

https://chatboxai.app/en/guide/faq/data-storage