Claude Code：AI 编程 CLI 速查手册

Claude Code 是 Anthropic 推出的 AI 编程 CLI 工具，支持接入 DeepSeek 等第三方模型。在终端中运行，以斜杠命令作为主要交互方式，围绕「权限模式 / plan / skill / subagent / sandbox / 上下文 / 回滚 / 历史会话」等核心功能展开。

各类 AI 编程 CLI 工具的交互方式与核心功能高度相似，其余同类工具可类推。

安装与启动

安装：npm install -g @anthropic-ai/claude-code，启动命令 claude。

官方文档：https://code.claude.com/docs

CC Switch 接入第三方模型

Claude Code 支持通过环境变量 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 将请求转发到兼容 Anthropic API 的第三方服务（如 DeepSeek）。

可以通过 CC Switch 这类第三方可视化配置管理工具，维护多组 profile，点击即可切换提供商，无需手动编辑配置文件。

配置文件位置一览

下文涉及配置文件时不再重复路径，统一参考本节。

设置：~/.claude/settings.json（用户级）；.claude/settings.json（项目级）
全局偏好：~/.claude/CLAUDE.md（项目级 ./CLAUDE.md）
skill：.claude/skills/（项目级）；~/.claude/skills/（全局）
会话历史与自动记忆：~/.claude/projects/<项目>/（自动记忆文件为 memory/MEMORY.md）

auto-accept edits 自动批准模式

Shift+Tab：循环切换权限模式（普通 / 自动接受编辑 / plan）。

permissions 权限配置

--dangerously-skip-permissions：命令行 flag，单次会话内自动批准所有工具权限、跳过交互确认。
配置文件中可在 permissions 中设置 "defaultMode": "bypassPermissions" 实现持久化的权限跳过。
可通过 /permissions 指令进行权限设置。
在配置文件 settings.json 中通过 permissions 字段的 allow 和 deny 数组进行配置。

{
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(git status)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

skill

写法为 <name>/SKILL.md，项目级目录 .claude/skills/，全局目录 ~/.claude/skills/。
启动后可通过 / 斜杠命令或自然语言调用 skill。

subagent

Subagent 是 Claude Code 保持主会话高效运行的核心机制之一。主控 Agent（Orchestrator Agent）可以通过将具体的专项任务委派给独立的上下文窗口（Context Window），并在任务完成后仅收回汇总结果，从而避免主会话上下文被大量中间细节填满。

预设了一些子代理，如 Explore （只读代码搜索）、Plan（plan 模式信息收集）和通用任务代理。也支持在 .claude/agents/ 中自定义子代理。

sandbox

沙盒默认关闭，使用 /sandbox 命令开启（面板含 Mode / Overrides / Config）。
沙盒环境可能影响代理网络配置。
支持按文件系统 / 网络 / 凭据粒度配置权限。

plan 模式

Shift+Tab 可切换 plan 模式；
也可直接用 /plan 前缀输入。

记录全局偏好

全局偏好文件使用 CLAUDE.md（不读取 AGENTS.md，如需引用可在 CLAUDE.md 中用 @AGENTS.md 导入）。
使用自动记忆（文件位置见上文「配置文件位置一览」），用 /memory 命令管理；也可用自然语言要求 Claude 记录偏好。

示例（文件路径见上文）：

## 偏好

- Always respond in Chinese (始终使用中文回复)

effort 思考等级设置

/effort [low|medium|high|xhigh|max|auto] 交互式设置思考等级，不带参数会弹出滑杆选择；auto 恢复模型默认。
/effort ultracode：特殊会话模式，启用 xhigh 思考等级并开启自动多代理工作流编排，适用于大规模多阶段任务。仅会话内有效，不可通过配置文件持久化。

usage 查看用量

/usage（别名 /cost），用于查看当前会话各模型用量统计。

init 初始化上下文

/init 命令，用于生成上下文文档并加载既有规则。
生成 CLAUDE.md；无文档化的参数用法，语言等要求作为普通对话文字输入。

context 查看与管理上下文

/context 查看当前会话加载的上下文详情（系统 / 项目规则文档、动态引用、Token 占用分布）。可用 /context all 展开逐项明细。

rewind 回滚

/rewind 选择要回退的对话节点，支持同步回退代码修改与对话记录（只追踪文件编辑改动，不含 bash 改动；双击 Esc 也可呼出）。

resume 历史会话

/resume（命令行启动 flag：-c/--continue、-r/--resume）。
历史会话保存在本地，与项目目录路径绑定，需在原目录启动 CLI 才能看到对应历史（存储位置见上文「配置文件位置一览」）。

shell 命令行执行

行首输入 !（后需空格，如 ! echo hi）。命令及其完整输出（stdout/stderr）会注入会话上下文。
执行 npm run dev 等长时间运行的命令，可使用 Ctrl+B 将进程送入后台。

常用操作

换行：Shift + Enter。
暂存提示（stash）：编辑中的提示按 Ctrl+S 会暂存到记忆而不提交（提示词下方会提示 "Press Ctrl+S to stash the prompt"），可稍后继续编辑。
清空屏幕：/clear 上下文不保留；如需保留上下文可用 /compact。
退出：/exit，可连按两次 Ctrl+C 或 Ctrl+D 退出。
光标定位：按住 Option 键点击目标位置（VS Code 终端特性）。
terminal.integrated.scrollback：VS Code 终端设置（调大缓冲行数以支持向上滚动）。

关联文件（@ 引用）

在输入框输入 @ 唤起文件选择器，把指定文件作为上下文附带给 AI，使其直接基于文件内容回答或操作，省去手动查找文件。
一次提示可同时引用多个文件（如 Tell me about @routes.ts and @schema.ts），输入 @ 追加下一个文件即可；回车后 AI 会自动将各文件读入上下文窗口。

底栏显示 Token 计数

默认未开启，可发送如下自然语言指令，由 Agent 自动完成状态栏配置，以方便监控当前的上下文情况。

请帮我在终端底栏（状态行）实时显示当前 Session 的模型名称以及 Token 使用量和占用百分比。

在配置文件中增加 statusLine 配置，type 为 command，执行一个脚本文件。
注意：statusLine 脚本文件需要先赋予可执行权限（chmod +x）才能生效。
输出例如 🧠 ${model} ⚡ ${tokenStr} tokens · ${pctStr} 格式。
可以使用第三方社区工具，如 ccstatusline 进行配置。

各类 AI 编程 CLI 工具的交互方式与核心功能高度相似，其余同类工具可类推。

安装与启动

安装：npm install -g @anthropic-ai/claude-code，启动命令 claude。

官方文档：https://code.claude.com/docs

CC Switch 接入第三方模型

Claude Code 支持通过环境变量 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 将请求转发到兼容 Anthropic API 的第三方服务（如 DeepSeek）。

可以通过 CC Switch 这类第三方可视化配置管理工具，维护多组 profile，点击即可切换提供商，无需手动编辑配置文件。

配置文件位置一览

下文涉及配置文件时不再重复路径，统一参考本节。

设置：~/.claude/settings.json（用户级）；.claude/settings.json（项目级）
全局偏好：~/.claude/CLAUDE.md（项目级 ./CLAUDE.md）
skill：.claude/skills/（项目级）；~/.claude/skills/（全局）
会话历史与自动记忆：~/.claude/projects/<项目>/（自动记忆文件为 memory/MEMORY.md）

auto-accept edits 自动批准模式

Shift+Tab：循环切换权限模式（普通 / 自动接受编辑 / plan）。

permissions 权限配置

--dangerously-skip-permissions：命令行 flag，单次会话内自动批准所有工具权限、跳过交互确认。
配置文件中可在 permissions 中设置 "defaultMode": "bypassPermissions" 实现持久化的权限跳过。
可通过 /permissions 指令进行权限设置。
在配置文件 settings.json 中通过 permissions 字段的 allow 和 deny 数组进行配置。

{
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(git status)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

skill

写法为 <name>/SKILL.md，项目级目录 .claude/skills/，全局目录 ~/.claude/skills/。
启动后可通过 / 斜杠命令或自然语言调用 skill。

subagent

预设了一些子代理，如 Explore （只读代码搜索）、Plan（plan 模式信息收集）和通用任务代理。也支持在 .claude/agents/ 中自定义子代理。

sandbox

沙盒默认关闭，使用 /sandbox 命令开启（面板含 Mode / Overrides / Config）。
沙盒环境可能影响代理网络配置。
支持按文件系统 / 网络 / 凭据粒度配置权限。

plan 模式

Shift+Tab 可切换 plan 模式；
也可直接用 /plan 前缀输入。

记录全局偏好

全局偏好文件使用 CLAUDE.md（不读取 AGENTS.md，如需引用可在 CLAUDE.md 中用 @AGENTS.md 导入）。
使用自动记忆（文件位置见上文「配置文件位置一览」），用 /memory 命令管理；也可用自然语言要求 Claude 记录偏好。

示例（文件路径见上文）：

## 偏好

- Always respond in Chinese (始终使用中文回复)

effort 思考等级设置

/effort [low|medium|high|xhigh|max|auto] 交互式设置思考等级，不带参数会弹出滑杆选择；auto 恢复模型默认。
/effort ultracode：特殊会话模式，启用 xhigh 思考等级并开启自动多代理工作流编排，适用于大规模多阶段任务。仅会话内有效，不可通过配置文件持久化。

usage 查看用量

/usage（别名 /cost），用于查看当前会话各模型用量统计。

init 初始化上下文

/init 命令，用于生成上下文文档并加载既有规则。
生成 CLAUDE.md；无文档化的参数用法，语言等要求作为普通对话文字输入。

context 查看与管理上下文

/context 查看当前会话加载的上下文详情（系统 / 项目规则文档、动态引用、Token 占用分布）。可用 /context all 展开逐项明细。

rewind 回滚

/rewind 选择要回退的对话节点，支持同步回退代码修改与对话记录（只追踪文件编辑改动，不含 bash 改动；双击 Esc 也可呼出）。

resume 历史会话

/resume（命令行启动 flag：-c/--continue、-r/--resume）。
历史会话保存在本地，与项目目录路径绑定，需在原目录启动 CLI 才能看到对应历史（存储位置见上文「配置文件位置一览」）。

shell 命令行执行

行首输入 !（后需空格，如 ! echo hi）。命令及其完整输出（stdout/stderr）会注入会话上下文。
执行 npm run dev 等长时间运行的命令，可使用 Ctrl+B 将进程送入后台。

常用操作

换行：Shift + Enter。
暂存提示（stash）：编辑中的提示按 Ctrl+S 会暂存到记忆而不提交（提示词下方会提示 "Press Ctrl+S to stash the prompt"），可稍后继续编辑。
清空屏幕：/clear 上下文不保留；如需保留上下文可用 /compact。
退出：/exit，可连按两次 Ctrl+C 或 Ctrl+D 退出。
光标定位：按住 Option 键点击目标位置（VS Code 终端特性）。
terminal.integrated.scrollback：VS Code 终端设置（调大缓冲行数以支持向上滚动）。

关联文件（@ 引用）

在输入框输入 @ 唤起文件选择器，把指定文件作为上下文附带给 AI，使其直接基于文件内容回答或操作，省去手动查找文件。
一次提示可同时引用多个文件（如 Tell me about @routes.ts and @schema.ts），输入 @ 追加下一个文件即可；回车后 AI 会自动将各文件读入上下文窗口。

底栏显示 Token 计数

默认未开启，可发送如下自然语言指令，由 Agent 自动完成状态栏配置，以方便监控当前的上下文情况。

请帮我在终端底栏（状态行）实时显示当前 Session 的模型名称以及 Token 使用量和占用百分比。

在配置文件中增加 statusLine 配置，type 为 command，执行一个脚本文件。
注意：statusLine 脚本文件需要先赋予可执行权限（chmod +x）才能生效。
输出例如 🧠 ${model} ⚡ ${tokenStr} tokens · ${pctStr} 格式。
可以使用第三方社区工具，如 ccstatusline 进行配置。

Claude Code：AI 编程 CLI 速查手册

安装与启动

CC Switch 接入第三方模型

配置文件位置一览

auto-accept edits 自动批准模式

permissions 权限配置

skill

subagent

sandbox

plan 模式

记录全局偏好

effort 思考等级设置

usage 查看用量

init 初始化上下文

context 查看与管理上下文

rewind 回滚

resume 历史会话

shell 命令行执行

常用操作

关联文件（@ 引用）

底栏显示 Token 计数

本文收录于专栏

Vibe Coding 探索

Claude Code：AI 编程 CLI 速查手册

安装与启动

CC Switch 接入第三方模型

配置文件位置一览

auto-accept edits 自动批准模式

permissions 权限配置

skill

subagent

sandbox

plan 模式

记录全局偏好

effort 思考等级设置

usage 查看用量

init 初始化上下文

context 查看与管理上下文

rewind 回滚

resume 历史会话

shell 命令行执行

常用操作

关联文件（@ 引用）

底栏显示 Token 计数

本文收录于专栏

Vibe Coding 探索