Claude Code 常用使用帮助（命令、VS Code 免确认、存储位置迁移）

这是一篇可在不同电脑上直接照着操作的 Claude Code 使用手册。适用于 Windows、macOS、Linux 的 Claude Code；绕过权限配置一节仅针对 VS Code 的 Claude Code 扩展，不涉及终端 CLI 的绕过参数。

已经装好 Claude Code 的读者可从「一、常用命令」开始。首次安装请先看同目录的《Claude Code 安装教程（npm 方式）》。功能和菜单会随版本调整，以文末的 Anthropic 官方文档为准。

一、先分清三种命令在哪里输入

输入位置	可以输入什么	例子
Claude Code 聊天输入框（VS Code 扩展面板或 Claude CLI 会话）	以 `/` 开头的会话命令	`/model`、`/compact`
VS Code 命令面板（`Ctrl+Shift+P`；macOS 为 `Cmd+Shift+P`）	VS Code 编辑器命令	`Preferences: Open User Settings (JSON)`
PowerShell / CMD / Terminal	`claude` 系统命令	`claude --version`、`claude doctor`

不要在 VS Code 的命令面板输入 /compact，也不要在终端直接把 /permissions 当成系统命令。

二、Claude Code 常用斜杠命令

在 Claude Code 对话框输入 /，即可查看当前版本实际支持的命令。常用命令如下：

命令	用途	适合什么时候用
`/help`	显示帮助和可用命令	忘记命令名称
`/model`	选择或切换模型	换模型
`/effort`	调整模型思考强度	简单任务和复杂任务切换
`/context`	查看上下文占用情况	对话很长、想知道占用
`/compact`	总结并压缩当前对话上下文	上下文接近上限
`/autocompact 300k`	设置自动压缩窗口约 300K Tokens（v2.1.221+）	想让长会话更早自动压缩
`/clear`	清空当前对话上下文并开始新任务	要切换到不相关的任务
`/resume`	查找并恢复历史会话	继续上次的工作
`/permissions`	查看和管理工具权限规则	调整执行命令/修改文件的审批
`/config`	打开 Claude Code 设置	修改会话配置
`/mcp`	管理 MCP 服务连接	接入外部工具
`/init`	为项目生成 `CLAUDE.md`	首次为项目配置协作说明
`/memory`	管理记忆和 `CLAUDE.md`	更新项目规则与长期指令
`/plan`	进入计划模式	希望先看方案、再动代码
`/diff`	查看代码修改差异	检查 Claude 改过的文件
`/agents`	管理子智能体	多模块工作
`/status`	查看当前会话/配置状态	核对版本、模型、配置来源
`/doctor`	检查 Claude Code 运行环境	诊断异常
`/usage`	查看可用的使用量统计	查询当前账号的额度或使用情况

说明：不同版本、平台、登录方式可能有命令差异；以输入 / 后展示的列表为准。命令要放在消息开头。

实用操作组合

换模型：/model → 选择模型。

上下文快满了：先 /context → 需要立即压缩用 /compact；设置后续自动压缩窗口用 /autocompact 300k。

想重新开始但保留历史记录：/clear，以后可用 /resume 找旧会话。

开始大型改动前先做方案：/plan。

开发完成核对改动：/diff。

自动压缩阈值：让 Claude Code 提前压缩对话

Claude Code v2.1.221 或更高版本支持在 Claude Code 对话输入框直接调整自动压缩窗口（不是在 VS Code 命令面板输入）：

/autocompact           # 查看当前设置
/autocompact 200k      # 约 20 万 Tokens 的窗口
/autocompact 300k      # 约 30 万 Tokens 的窗口（常用）
/autocompact 500k      # 约 50 万 Tokens 的窗口
/autocompact auto      # 恢复模型默认窗口

推荐：/autocompact 300k。设置会保存到 Claude Code 用户配置，并应用于当前会话；新版按当前模型分别记录。它设置的是自动压缩窗口大小，不是把模型本身的上下文上限改为 300K，也不是保证恰好到 300K 才压缩：实际触发会稍早。200K 上下文模型无法获得 300K 窗口，设置值会受模型上限约束。

CLI 一次性启动设置（适用于支持该参数的版本，在终端执行）：

为所有模型统一设置：编辑 Claude Code 的用户设置文件，保留已有其他配置并加入：

Windows：%USERPROFILE%\.claude\settings.json

macOS / Linux：~/.claude/settings.json

如果已使用 CLAUDE_CONFIG_DIR 改过存储位置，则编辑新目录下的 settings.json。

{
  "autoCompactWindow": 300000
}

如果此前已用 /autocompact 给某个模型单独保存过窗口，该模型的单独设置可能优先于上面的通用值。执行 /autocompact auto 可以恢复当前模型默认窗口。

脚本/环境变量方式：需要从终端启动 Claude Code 时，也可使用 CLAUDE_CODE_AUTO_COMPACT_WINDOW，这是 Token 数量，优先级高于上述命令与配置（Windows/macOS/Linux 都支持）：

# Windows PowerShell：仅当前终端生效
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW = '300000'
claude

# Windows：对后续新开的终端长期生效
[Environment]::SetEnvironmentVariable('CLAUDE_CODE_AUTO_COMPACT_WINDOW','300000','User')

环境变量不会自动改变已经运行中的 VS Code 进程；配置后重新打开相关程序。需要在 VS Code 扩展内使用时，优先试 /autocompact，如版本没有该命令，可在扩展设置中搜索 Claude Code: Environment Variables 并配置相同变量名和值。

百分比方式（备选）：CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50 表示在自动压缩窗口的约 50% 处尝试提前压缩，不是 50 万 Tokens，也不能抬高默认阈值；如果希望确定「300K 窗口」，优先使用 /autocompact 300k 或 autoCompactWindow。

官方说明：自动压缩窗口配置；命令参考。

三、终端里的常用 Claude 命令

以下命令在 PowerShell、Windows Terminal、macOS Terminal 或 Linux 终端中运行，不是在 VS Code 命令面板运行。

如果系统提示找不到 claude，先检查是否已安装，并关闭、重新打开终端；安装请看同分类中的安装教程。

四、VS Code 插件开启「绕过权限」模式（仅适用 VS Code 扩展）

本节设置的是 VS Code 官方 Claude Code 扩展，不是 Claude CLI 的命令行启动参数。

方法 A：通过设置界面开启

在 VS Code 按 Ctrl+,（macOS 为 Cmd+,）打开设置。

搜索 Allow Dangerously Skip Permissions。

勾选 Claude Code: Allow Dangerously Skip Permissions。

图 1：VS Code 设置中找到并勾选 Allow Dangerously Skip Permissions

图 1：在 VS Code 设置中搜索 Dangerously，勾选 Claude Code 对应的选项。截图来源：The Guide to Claude Code for PMs。示例为 Workspace 界面，想让每个新项目都适用，请在 User（用户）设置中操作。
4. 在 Claude Code 对话面板的权限模式选择器中，选择 Bypass permissions（绕过权限）。

图 2：Claude Code 面板中选择 Bypass permissions 权限模式

图 2：展开对话输入框的权限模式选单，选择 Bypass permissions。截图来源：VS Code Claude Code 自动权限设置教程。

若权限模式列表未更新，先新建一个会话或重载 VS Code 窗口。

方法 B：让新会话默认进入绕过权限模式

按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），运行：

Preferences: Open User Settings (JSON)

在该文件的最外层 JSON 对象中添加这两项（如果已有其他设置，保留原来的配置，按 JSON 语法用逗号隔开）：

{
  "claudeCode.allowDangerouslySkipPermissions": true,
  "claudeCode.initialPermissionMode": "bypassPermissions"
}

第一项允许显示「绕过权限」模式；第二项将它设置为新会话默认模式。此配置应放在 VS Code 用户设置，不要放在项目的 .vscode/settings.json：较新版本的扩展对 initialPermissionMode 使用用户级设置。

注意： Bypass permissions 会跳过通常的工具批准提示，Claude 可能直接运行命令或改动文件；组织级限制、拒绝规则或 hooks 仍可能生效。请仅在自己掌控、充分信任的隔离开发环境中启用。想恢复正常审批，将 initialPermissionMode 改为 default，或在面板中选回普通权限模式即可。

五、Claude Code 的会话默认存在哪里？

Claude Code 主要把会话历史、用户设置、插件等本地数据放在用户主目录下：

系统	常见默认数据目录
Windows	`%USERPROFILE%\.claude`（通常位于 C 盘）
macOS	`~/.claude`
Linux	`~/.claude`

其中 projects/ 常含历史会话，settings.json 是用户级配置，plugins/ 是插件相关数据。~/.claude.json 可能另存部分账号、MCP 和项目状态；VS Code 插件自身也可能在 VS Code 的存储位置产生额外缓存。更改 Claude Code 数据目录并不代表所有 VS Code / Claude Desktop 缓存都会迁走。

六、修改默认存储位置（Windows：从 C 盘迁到其他盘）

Claude Code 使用环境变量 CLAUDE_CONFIG_DIR 指定用户数据目录。以下以 D:\ClaudeData 为示例；换电脑时，把 D 盘换成该电脑实际存在的磁盘和路径即可。

1. 先退出 Claude Code 和 VS Code

确保没有正在运行的 Claude Code 会话，避免迁移过程中仍写入历史记录。建议先备份原目录。

2. 在 PowerShell 复制现有数据

$source = Join-Path $env:USERPROFILE '.claude'
$target = 'D:\ClaudeData'  # 换成目标电脑希望使用的绝对路径

New-Item -ItemType Directory -Path $target -Force | Out-Null
Get-ChildItem -LiteralPath $source -Force |
    Copy-Item -Destination $target -Recurse -Force

上面只复制数据，不删除 C 盘的原目录。建议先选择一个空的新目标文件夹，防止和已有文件混淆。如果是全新安装、没有旧会话，也可以直接创建目标目录并跳到下一步。

3. 设置长期生效的用户环境变量

[Environment]::SetEnvironmentVariable(
    'CLAUDE_CONFIG_DIR',
    'D:\ClaudeData',
    'User'
)

也可以手动到 Windows「编辑账户的环境变量」→ 新建用户变量：

变量名：CLAUDE_CONFIG_DIR

变量值：D:\ClaudeData（示例，换成自己的绝对路径）

完全关闭再重新打开 VS Code 和终端，新进程才能读取刚刚修改的用户环境变量。

4. 验证目录设置

新开 PowerShell：

[Environment]::GetEnvironmentVariable('CLAUDE_CONFIG_DIR','User')
$env:CLAUDE_CONFIG_DIR

应显示你填写的目标路径。再用 Claude Code 开一个新会话，查看目标目录里是否出现新的 projects/ 会话文件；确认旧会话可正常恢复后，再决定是否手动清理原目录。

5. VS Code 扩展没有跟随系统变量怎么办？

在 VS Code 设置（Ctrl+,）中搜索 Claude Code: Environment Variables，为 Claude 进程设置：

变量名：CLAUDE_CONFIG_DIR

值：目标文件夹的完整绝对路径，例如 D:\ClaudeData

扩展不会自动展开 ~，也不会采用相对路径。只需要系统用户环境变量时，通常无需重复配置这一项；它适合作为扩展未继承系统环境变量时的解决方法。

七、macOS / Linux 修改默认存储位置

以当前用户主目录下 ClaudeData 作为新位置，不涉及 C/D 盘。关闭 Claude Code 后，在终端运行：

如果还没有 ~/.claude，跳过复制命令即可。设置环境变量：

此命令只对当前终端生效。长期生效要把相同的 export 行写入实际使用的 Shell 配置文件，例如 zsh：~/.zshrc，bash：~/.bashrc，并重新打开终端。如果 VS Code 从桌面图标启动而没有继承 Shell 变量，也可在 Claude Code 扩展的 Environment Variables 中填写该目录的展开后的绝对路径（例如 /home/your-user/ClaudeData 或 /Users/your-user/ClaudeData）。

确认迁移生效、旧会话可用之后，再考虑删除旧目录；不要把会话目录直接上传到公开仓库，它可能包含对话、配置及敏感信息。

八、换一台电脑时怎么用这篇教程？

安装 VS Code Claude Code 扩展（或 Claude Code CLI），按该电脑需要完成登录或 API 接入。

VS Code 免确认：按第四节在那台电脑自己的 VS Code 用户设置中配置，不要复制整份包含其他扩展信息的 settings.json。

存储位置：选择该电脑实际存在的目录，设置它自己的 CLAUDE_CONFIG_DIR。旧数据迁移时只复制自己需要的会话、项目和配置文件，不要公开传播令牌或登录状态。

新建会话，尝试 /help、/model、/context；再确认历史会话是否能通过 /resume 访问。

官方资料

Claude Code 命令列表

VS Code 扩展与设置

Claude Code 设置文件与配置位置

Claude Code 环境变量

Claude Code 安装说明

文档整理于 2026-10-27。功能有版本差异时，请以当前安装版本和官方文档为准。

Claude Code 常用使用帮助

Claude Code 常用使用帮助（命令、VS Code 免确认、存储位置迁移）#

一、先分清三种命令在哪里输入#

二、Claude Code 常用斜杠命令#

实用操作组合#

自动压缩阈值：让 Claude Code 提前压缩对话#

三、终端里的常用 Claude 命令#

四、VS Code 插件开启「绕过权限」模式（仅适用 VS Code 扩展）#

方法 A：通过设置界面开启#

方法 B：让新会话默认进入绕过权限模式#

五、Claude Code 的会话默认存在哪里？#

六、修改默认存储位置（Windows：从 C 盘迁到其他盘）#

1. 先退出 Claude Code 和 VS Code#

2. 在 PowerShell 复制现有数据#

3. 设置长期生效的用户环境变量#

4. 验证目录设置#

5. VS Code 扩展没有跟随系统变量怎么办？#

七、macOS / Linux 修改默认存储位置#

八、换一台电脑时怎么用这篇教程？#

官方资料#