常识篇 · 速查表 / 排错 / 工具怎么选

chapter/11 · 速查篇

Claude Code 常用命令 & 快捷键速查

斜杠命令(在对话框里输入)

命令	作用	什么时候用
`/init`	扫描项目,生成 CLAUDE.md 项目说明	每个新项目第一次使用时
`/clear`	清空当前对话,开始新任务	切换到完全不同的任务时
`/compact`	压缩对话历史,腾出上下文空间	同一任务聊太久、上下文超 70~80% 时
`/context`	查看当前上下文用了多少	随时,配合 /compact 使用
`/model`	切换模型	想换更强或更省钱的模型时
`/cost`	查看本次会话花了多少钱	用 API 计费时关注成本
`/resume`	恢复之前的历史会话	昨天聊到一半今天接着干
`/diff`	查看所有文件改动对比	让 AI 干完活后做最终检查
`/memory`	编辑记忆文件(CLAUDE.md)	想让它长期记住某些规矩
`/help`	查看帮助	忘了命令时
`/exit`	退出 Claude Code	收工

💡 记不住也没关系直接用中文说"帮我压缩一下上下文""切到规划模式",它会自动执行对应操作。

快捷键

快捷键	作用
Shift + Tab	循环切换三种模式:普通 → 自动接受 → 计划模式(最重要!)
Esc	打断 Claude 当前的输出/操作
Esc 连按两次	回退到之前的对话节点,重新编辑你的提问
Ctrl + C	取消当前输入或生成
Ctrl + B	把正在跑的慢命令(测试/构建)放到后台,继续聊
Ctrl + R	搜索历史命令
Ctrl + L	清屏(对话内容还在)
Shift + Enter	输入框里换行(不发送)
↑ / ↓	翻看之前输入过的消息
Ctrl + Shift + ?	查看完整快捷键列表
Ctrl + D	退出 Claude Code

Codex 常用命令速查

命令	作用
`codex`	进入交互式对话
`codex "任务描述"`	直接执行单次任务
`codex --model 模型名`	临时用指定模型(不改配置文件)
`codex doctor`	诊断配置文件和网络是否正常
`codex --version`	查看版本
界面内输入 `/`	打开命令菜单(切模型、调权限、总结对话等)
界面内 Ctrl + C	打断 / 退出

Codex 的配置文件在 ~/.codex/config.toml,不过既然用了 CC Switch,一般不需要手动碰它。两个记忆点:改了配置要重启终端/IDE 才生效;项目文件夹里如果也有 .codex/config.toml,会覆盖全局配置。

chapter/13 · 速查篇

终端(命令行)基础命令速查

这些是 macOS 终端本身的命令,和 AI 工具无关,但天天要用。

文件夹导航

命令	作用	例子
`pwd`	显示我现在在哪个文件夹	`pwd`
`ls`	列出当前文件夹里的东西	`ls -la` 可显示隐藏文件
`cd 文件夹名`	进入某个文件夹	`cd Desktop`
`cd ..`	返回上一级文件夹
`cd ~`	回到自己的用户主目录
`cd ~/Desktop/项目名`	直接跳到指定路径
`open .`	用访达打开当前文件夹(超实用)
`mkdir 名字`	新建文件夹	`mkdir my-project`
`clear`	清屏

💡 偷懒技巧输入 cd (带空格)后,直接把访达里的文件夹拖进终端窗口,路径会自动填上,回车即可。

终端通用快捷键

快捷键	作用
Tab	自动补全文件名/命令(打前几个字母按 Tab,神器)
↑ / ↓	翻看之前执行过的命令,不用重打
Ctrl + C	强制停止当前正在跑的程序
Ctrl + A / Ctrl + E	光标跳到行首 / 行尾
Ctrl + U	清空当前这一行输入
Cmd + K	彻底清屏
Cmd + T	新开一个终端标签页

chapter/14 · 附录

常见问题排错

Q1:装完后输入 claude 或 codex 提示 "command not found"

先关掉终端重新开一个窗口再试。还不行的话,npm 装的工具可能路径没配好——最省事的办法是重新用第 1 章的 curl 原生方式装 Claude Code。

Q2:CC Switch 里切换了供应商,但 Claude Code(终端或插件)还在要求登录官方账号

在终端执行这条命令跳过初始化引导,然后重新启动 claude / 重启 VS Code:

Terminal

$ echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

(注意:如果你之前已经正常用过 Claude Code,不要随便执行这条,它会覆盖已有配置。)

Q3:请求一直报错 / 超时

按顺序检查:① Base URL 末尾是不是多了 /;② 在 CC Switch 里点"健康检查"看是否通过;③ 中转服务商的余额是否用完;④ 模型名是否和服务商提供的一致;⑤ Codex 的话,是否忘了重开终端/重启 VS Code。

Q4:之前手动配置过环境变量,现在切换供应商不生效

旧的环境变量会和 CC Switch 冲突。检查 ~/.zshrc 文件里有没有 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、OPENAI_API_KEY 之类的行,有就删掉,保存后重开终端。可以让 Claude Code 自己帮你检查:"帮我看看 ~/.zshrc 里有没有 ANTHROPIC 或 OPENAI 相关的环境变量"。

Q5:npm 安装特别慢或卡住

Terminal

$ npm config set registry https://registry.npmmirror.com/
# 换成国内镜像后,重新执行安装命令

Q6:VS Code 里插件图标不显示 / 面板打不开

Claude Code 插件:确认打开了一个文件(仅打开文件夹不够)、VS Code ≥ 1.98、重启窗口、暂时禁用其他 AI 插件、信任工作区。Codex 插件:首次启动要下载依赖,多等几分钟;确认发布者是 OpenAI 的正版插件。

Q7:怎么更新这些工具?

Claude Code:claude update(原生安装的会自动更新)。Codex:npm update -g @openai/codex。VS Code 插件:扩展市场会自动提示更新。桌面客户端(Claude App / Codex App):启动时自动检查更新。CC Switch:去 GitHub Releases 下载新版覆盖安装。

Q8:Codex 客户端在 CC Switch 换了供应商后不生效

和 CLI 同一个原因:配置只在启动时读取。Cmd + Q 完全退出 Codex App 再重新打开(点左上角红点关窗口是不够的,进程还在后台)。另外检查中转平台的 Key 是否选了 codex 类型/分组。

chapter/15 · 附录

一页纸总结

cheatsheet.txt

# ── 安装 ──────────────────────────────
curl -fsSL https://claude.ai/install.sh | bash   ← 装 Claude Code
装 Node.js (nodejs.org 下载 LTS 版 pkg 双击装)
npm install -g @openai/codex                     ← 装 Codex
GitHub 下载 CC Switch.dmg 拖进应用程序

# ── 绑定中转 ───────────────────────────
CC Switch → 选应用(Claude/Codex) → ➕ 填 Key 和 Base URL(末尾无斜杠)
→ 健康检查 → 启用 → 重开终端
有官方会员可免中转:claude 里 /login 选订阅账号;codex 选 Sign in with ChatGPT(第 4 章)

# ── 日常使用(CLI)──────────────────────
cd 项目文件夹 → claude 或 codex → 中文描述需求
Claude Code 三板斧:/init 初始化、Shift+Tab 计划模式、/compact 省上下文

# ── 日常使用(VS Code)─────────────────
扩展市场装 "Claude Code"(Anthropic) 和 "Codex"(OpenAI)
和 CLI 共用配置,CC Switch 换供应商后:Claude 即时生效,Codex 重启 IDE

# ── 桌面客户端(App)───────────────────
Codex App:openai.com/codex 下载,和 CLI 共用配置,中转直接能用,改配置重启 App
Claude App:claude.com/download 下载,主要面向官方订阅;中转用户优先 CLI/插件

祝使用顺利!遇到任何报错,把报错信息原样粘贴给 Claude 问"这是什么意思、怎么解决"——这本身就是这些工具最好的用法。

chapter/17 · 进阶篇

CLI、VS Code 插件、桌面客户端,到底用哪个?

学完前面的章节你已经见过三种形态了。它们背后是同一个 AI、同一套配置、同一份额度——就像同一位大厨,区别只是你在哪里"点菜"。

同一位"大厨",三种点菜方式:功能越强的,离"生肉和火"越近

一张表看懂差异

	命令行 CLI	VS Code 插件	桌面客户端
上手门槛	最高,需要会用终端	中,会用编辑器即可	最低,像用微信一样
功能完整度	最全,新功能最先上	接近全量	核心功能齐,细节略少
看改动方式	文字确认提示	红绿高亮 diff,最直观	可视化 diff + 按钮
多任务并行	开多个终端窗口	多标签对话	✅ 原生多会话,最强
中转 API 友好度	✅ 最好	✅ 好(跟随 CLI)	Codex ✅ / Claude ❌
适合的活	批量处理、自动化、重活	写代码、改代码	轻任务、整理文件、多项目盯进度

按人对号入座

纯小白、几乎不写代码 → 客户端起步,顺手后学 CLI;
要写代码、改项目 → VS Code 插件为主,CLI 为辅;
批量任务、想玩自动化 → CLI,它是三者的"根",另外两个都是它的皮肤;
同时盯好几个项目 → 客户端的多会话侧边栏最舒服。

💡 不用二选一三种形态共享登录态和配置,很多人的日常是:白天在 VS Code 里写代码,顺手开个客户端会话让它后台整理文档,偶尔开终端跑一句批量命令。哪个顺手用哪个。

chapter/11 · 速查篇

Claude Code 常用命令 & 快捷键速查

斜杠命令(在对话框里输入)

命令	作用	什么时候用
`/init`	扫描项目,生成 CLAUDE.md 项目说明	每个新项目第一次使用时
`/clear`	清空当前对话,开始新任务	切换到完全不同的任务时
`/compact`	压缩对话历史,腾出上下文空间	同一任务聊太久、上下文超 70~80% 时
`/context`	查看当前上下文用了多少	随时,配合 /compact 使用
`/model`	切换模型	想换更强或更省钱的模型时
`/cost`	查看本次会话花了多少钱	用 API 计费时关注成本
`/resume`	恢复之前的历史会话	昨天聊到一半今天接着干
`/diff`	查看所有文件改动对比	让 AI 干完活后做最终检查
`/memory`	编辑记忆文件(CLAUDE.md)	想让它长期记住某些规矩
`/help`	查看帮助	忘了命令时
`/exit`	退出 Claude Code	收工

💡 记不住也没关系直接用中文说"帮我压缩一下上下文""切到规划模式",它会自动执行对应操作。

快捷键

快捷键	作用
Shift + Tab	循环切换三种模式:普通 → 自动接受 → 计划模式(最重要!)
Esc	打断 Claude 当前的输出/操作
Esc 连按两次	回退到之前的对话节点,重新编辑你的提问
Ctrl + C	取消当前输入或生成
Ctrl + B	把正在跑的慢命令(测试/构建)放到后台,继续聊
Ctrl + R	搜索历史命令
Ctrl + L	清屏(对话内容还在)
Shift + Enter	输入框里换行(不发送)
↑ / ↓	翻看之前输入过的消息
Ctrl + Shift + ?	查看完整快捷键列表
Ctrl + D	退出 Claude Code

Codex 常用命令速查

命令	作用
`codex`	进入交互式对话
`codex "任务描述"`	直接执行单次任务
`codex --model 模型名`	临时用指定模型(不改配置文件)
`codex doctor`	诊断配置文件和网络是否正常
`codex --version`	查看版本
界面内输入 `/`	打开命令菜单(切模型、调权限、总结对话等)
界面内 Ctrl + C	打断 / 退出

Codex 的配置文件在 C:\Users\你的用户名\.codex\config.toml(.codex 是隐藏文件夹,资源管理器里要开启"显示隐藏的项目"才能看到),不过既然用了 CC Switch,一般不需要手动碰它。两个记忆点:改了配置要重启 PowerShell/IDE/App 才生效;项目文件夹里如果也有 .codex\config.toml,会覆盖全局配置。

chapter/13 · 速查篇

PowerShell 基础命令速查

这些是 Windows PowerShell 本身的命令,和 AI 工具无关,但天天要用。

文件夹导航

命令	作用	例子
`pwd`	显示我现在在哪个文件夹	`pwd`
`ls`	列出当前文件夹里的东西	`ls`
`cd 文件夹名`	进入某个文件夹	`cd Desktop`
`cd ..`	返回上一级文件夹
`cd ~`	回到自己的用户主目录
`cd ~\Desktop\项目名`	直接跳到指定路径
`start .`	用资源管理器打开当前文件夹(超实用)
`mkdir 名字`	新建文件夹	`mkdir my-project`
`cls`	清屏

💡 偷懒技巧输入 cd (带空格)后,直接把资源管理器里的文件夹拖进 PowerShell 窗口,路径会自动填上,回车即可。

PowerShell 通用快捷键

快捷键	作用
Tab	自动补全文件名/命令(打前几个字母按 Tab,神器)
↑ / ↓	翻看之前执行过的命令,不用重打
Ctrl + C	强制停止当前正在跑的程序
Esc	清空当前这一行输入
Home / End	光标跳到行首 / 行尾
Ctrl + Shift + T	新开一个终端标签页(Windows Terminal)
右键	在 PowerShell 窗口里右键 = 粘贴

chapter/14 · 附录

常见问题排错(Windows)

Q1:装完后输入 claude 或 codex 提示"无法将……识别为 cmdlet"

先关掉 PowerShell 重新开一个窗口再试。还不行就是 PATH 没配好:按 Win + R,输入 sysdm.cpl 回车 → "高级"选项卡 → "环境变量" → 在用户变量的 Path 里点"新建",添加 %USERPROFILE%\.local\bin(这是 claude 的安装位置),确定后重开所有终端窗口。

Q2:CC Switch 里切换了供应商,但 Claude Code(终端或插件)还在要求登录官方账号

在 PowerShell 执行这条命令跳过初始化引导,然后重新启动 claude / 重启 VS Code:

PowerShell

PS> Set-Content -Path "$env:USERPROFILE\.claude.json" -Value '{"hasCompletedOnboarding": true}' -Encoding utf8

两个注意:① 别用 echo > 来写这个文件,PowerShell 默认编码会导致文件读不出来;② 如果你之前已经正常用过 Claude Code,不要随便执行这条,它会覆盖已有配置。

Q3:请求一直报错 / 超时

按顺序检查:① Base URL 末尾是不是多了 /;② 在 CC Switch 里点"健康检查"看是否通过;③ 中转服务商的余额是否用完;④ 模型名是否和服务商提供的一致;⑤ Codex 的话,是否忘了重开 PowerShell / 重启 VS Code / 重启 App。

Q4:npm 报"禁止运行脚本"(about_Execution_Policies)

PowerShell

PS> Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
# 弹出确认时输入 Y 回车,然后重试刚才的 npm 命令

Q5:之前手动配置过环境变量,现在切换供应商不生效

旧的环境变量会和 CC Switch 冲突。按 Win + R → sysdm.cpl → 高级 → 环境变量,检查用户变量和系统变量里有没有 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、OPENAI_API_KEY 之类的条目,有就删掉,确定后重开终端。

Q6:npm 安装特别慢或卡住

PowerShell

PS> npm config set registry https://registry.npmmirror.com/
# 换成国内镜像后,重新执行安装命令

Q7:VS Code 里插件图标不显示 / 面板打不开

Q8:Claude App 的 Code 标签页报 Git 错误

去 git-scm.com 安装 Git for Windows(一路 Next),装完重启 Claude App 即可。

Q9:怎么更新这些工具?

Claude Code:claude update(原生安装的会自动更新;winget 装的用 winget upgrade Anthropic.ClaudeCode)。Codex:npm update -g @openai/codex。VS Code 插件:扩展市场自动提示更新。桌面客户端:启动时自动检查更新(微软商店装的由商店管理)。CC Switch:去 GitHub Releases 下载新版覆盖安装。

chapter/15 · 附录

一页纸总结(Windows)

cheatsheet.txt

# ── 安装(都在 PowerShell 里,认准 PS 前缀)──
irm https://claude.ai/install.ps1 | iex          ← 装 Claude Code
装 Node.js (nodejs.org 下载 LTS 版 .msi 双击装)
npm install -g @openai/codex                     ← 装 Codex
GitHub 下载 CC Switch.msi 安装(SmartScreen → 更多信息 → 仍要运行)
顺手装 Git for Windows(git-scm.com,一路 Next)

# ── 绑定中转 ───────────────────────────
CC Switch → 选应用(Claude/Codex) → ➕ 填 Key 和 Base URL(末尾无斜杠)
→ 健康检查 → 启用 → 重开 PowerShell
有官方会员可免中转:claude 里 /login 选订阅账号;codex 选 Sign in with ChatGPT(第 4 章)

# ── 日常使用(CLI)──────────────────────
cd 项目文件夹 → claude 或 codex → 中文描述需求
Claude Code 三板斧:/init 初始化、Shift+Tab 计划模式、/compact 省上下文

# ── 日常使用(VS Code)─────────────────
Ctrl+Shift+X 装 "Claude Code"(Anthropic) 和 "Codex"(OpenAI)
和 CLI 共用配置,CC Switch 换供应商后:Claude 即时生效,Codex 重启 IDE

# ── 桌面客户端(App)───────────────────
Codex App:微软商店搜 Codex(OpenAI),和 CLI 共用配置,改配置重启 App
Claude App:claude.com/download,Code 功能要先装 Git;主要面向官方订阅

祝使用顺利!遇到任何报错,把报错信息原样粘贴给 Claude 问"这是什么意思、怎么解决"——这本身就是这些工具最好的用法。

chapter/17 · 进阶篇

CLI、VS Code 插件、桌面客户端,到底用哪个?

学完前面的章节你已经见过三种形态了。它们背后是同一个 AI、同一套配置、同一份额度——就像同一位大厨,区别只是你在哪里"点菜"。

同一位"大厨",三种点菜方式:功能越强的,离"生肉和火"越近

一张表看懂差异

	命令行 CLI	VS Code 插件	桌面客户端
上手门槛	最高,需要会用 PowerShell	中,会用编辑器即可	最低,像用微信一样
功能完整度	最全,新功能最先上	接近全量	核心功能齐,细节略少
看改动方式	文字确认提示	红绿高亮 diff,最直观	可视化 diff + 按钮
多任务并行	开多个终端窗口	多标签对话	✅ 原生多会话,最强
中转 API 友好度	✅ 最好	✅ 好(跟随 CLI)	Codex ✅ / Claude ❌
适合的活	批量处理、自动化、重活	写代码、改代码	轻任务、整理文件、多项目盯进度

按人对号入座

纯小白、几乎不写代码 → 客户端起步,顺手后学 CLI;
要写代码、改项目 → VS Code 插件为主,CLI 为辅;
批量任务、想玩自动化 → CLI,它是三者的"根",另外两个都是它的皮肤;
同时盯好几个项目 → 客户端的多会话侧边栏最舒服。

💡 不用二选一三种形态共享登录态和配置,很多人的日常是:白天在 VS Code 里写代码,顺手开个客户端会话让它后台整理文档,偶尔开 PowerShell 跑一句批量命令。哪个顺手用哪个。

Claude Code 常用命令 & 快捷键速查

斜杠命令(在对话框里输入)

快捷键

推荐的标准工作流(抄作业)

Codex 常用命令速查

终端(命令行)基础命令速查

文件夹导航

终端通用快捷键

常见问题排错

Q1:装完后输入 claude 或 codex 提示 "command not found"

Q2:CC Switch 里切换了供应商,但 Claude Code(终端或插件)还在要求登录官方账号

Q3:请求一直报错 / 超时

Q4:之前手动配置过环境变量,现在切换供应商不生效

Q5:npm 安装特别慢或卡住

Q6:VS Code 里插件图标不显示 / 面板打不开

Q7:怎么更新这些工具?

Q8:Codex 客户端在 CC Switch 换了供应商后不生效

一页纸总结

CLI、VS Code 插件、桌面客户端,到底用哪个?

一张表看懂差异

按人对号入座

Claude Code 常用命令 & 快捷键速查

斜杠命令(在对话框里输入)

快捷键

推荐的标准工作流(抄作业)

Codex 常用命令速查

PowerShell 基础命令速查

文件夹导航

PowerShell 通用快捷键

常见问题排错(Windows)

Q1:装完后输入 claude 或 codex 提示"无法将……识别为 cmdlet"

Q2:CC Switch 里切换了供应商,但 Claude Code(终端或插件)还在要求登录官方账号

Q3:请求一直报错 / 超时

Q4:npm 报"禁止运行脚本"(about_Execution_Policies)

Q5:之前手动配置过环境变量,现在切换供应商不生效

Q6:npm 安装特别慢或卡住

Q7:VS Code 里插件图标不显示 / 面板打不开

Q8:Claude App 的 Code 标签页报 Git 错误

Q9:怎么更新这些工具?

一页纸总结(Windows)

CLI、VS Code 插件、桌面客户端,到底用哪个?

一张表看懂差异

按人对号入座