1. 为什么你需要这份 Claude Code CLI 命令清单Claude Code CLI 是 Anthropic 推出的终端级编码智能体装好之后你会在终端里看到一个提示符然后就能用自然语言让它读代码、改文件、跑测试、提交 PR。它适合已经习惯在终端里干活的开发者尤其是那种不想切窗口、不想复制粘贴到网页对话框的人。但真正上手之后多数人卡在同一个地方命令太多记不住也不知道哪条该在什么时候用。我自己刚开始用的时候最常犯的错就是一路到底对话越来越长Token 烧得飞快AI 还开始串戏——明明在改 A 模块它却把 B 模块的旧思路带进来。后来才发现官方那 60 多个原生命令本质上就是给你一套会话管理 上下文控制 权限隔离的操作面板。你不用全背下来但得知道哪几组是高频的、哪几组是救命的。这篇按初始化、会话、文件、模型、权限、调试六类把 60 个原生命令逐条拆开讲用途和典型调用同时给出settings.json和config.toml的可复制骨架演示怎么用 TaoToken 的统一 Key 和 API 通道接进去。每条命令我都会附上验证动作和预期输出方便你对照排查。读完你至少能做到知道什么时候该/compact、什么时候该/rewind、怎么让 AI 自己跑测试不用每次点确认。2. TaoToken 前置统一 Key 与 API 通道准备在讲命令之前先把接入层搞定。Claude Code CLI 默认走 Anthropic 官方通道但很多开发者手里同时有好几个模型的 Key切换起来很烦。TaoToken 的思路是给你一个统一的 Key 和 API 入口Claude Code、其他 CLI 工具、脚本都能共用同一套凭证省得每个工具配一遍。你需要准备的东西很简单一个 TaoToken 账号然后在控制台生成 API Key。地址是 https://taotoken.net/api 控制台入口在 https://taotoken.net/console 。生成 Key 之后把它写进环境变量别硬编码在配置文件里。# 写入 shell 配置推荐放 ~/.zshrc 或 ~/.bashrc export TAOTOKEN_API_KEYsk-你的key export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY$TAOTOKEN_API_KEY这里有个细节Claude Code CLI 读的是ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL这两个环境变量。你把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址CLI 就会把请求发到统一通道而不是官方端点。这样你换模型、换额度、看用量都在一个地方管。注意环境变量改完要source ~/.zshrc或者重开终端才生效。验证方法是echo $ANTHROPIC_BASE_URL能打印出地址就对了。如果你更习惯用配置文件而不是环境变量Claude Code 支持~/.claude/settings.json。下面这个骨架可以直接抄把 Key 换成你自己的{ apiKeyHelper: echo $TAOTOKEN_API_KEY, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: $TAOTOKEN_API_KEY }, model: claude-sonnet-4-5, permissions: { allow: [ Bash(git status), Bash(git diff:*), Bash(npm run test:*), Read(*) ], deny: [ Bash(rm -rf:*), Bash(curl:*) ] } }apiKeyHelper的作用是让 CLI 每次启动时动态取 Key而不是把明文写死在文件里。permissions.allow里我放了几个只读和测试命令这样 AI 跑git status、git diff、npm run test时不会每次弹确认框。deny里挡掉rm -rf和curl防止误操作。如果你用的是支持 TOML 的封装工具或者自己写脚本调 APIconfig.toml骨架长这样[api] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY timeout_seconds 120 [model] default claude-sonnet-4-5 fallback claude-haiku-4-5 [permissions] allow [Read(*), Bash(git status), Bash(git diff:*)] deny [Bash(rm -rf:*), Write(/etc/*)]配好之后先别急着进交互模式用一条单次命令验证通道通不通claude -p 用一句话说明当前目录是什么项目预期输出是一句简短的项目描述。如果报 401说明 Key 没读到如果报连接超时检查ANTHROPIC_BASE_URL有没有写错。这一步过了再往下看命令。3. 可复制配置六类命令逐条拆解3.1 初始化类进新项目先跑这几条/init是进新项目的第一条命令。它会在项目根目录生成CLAUDE.md这个文件每次启动都会自动加载相当于给 AI 的一份项目说明书。你可以在里面写框架、编译命令、测试命令、代码规范、特殊约束。我试过在一个老项目里跑/init它自动扫出了package.json里的脚本和tsconfig.json的路径别名省了不少手写功夫。/memory用来改项目记忆。它直接打开CLAUDE.md让你编辑也能管理 Claude 自动追加的记忆事实。典型用法是项目换了构建工具跑一次/memory把旧命令改掉。/permissions别名/allowed-tools是权限管理面板。你可以把git status这类只读命令设为自动放行把rm -rf设为永远拒绝。这条命令和上面的settings.json是联动的面板里改完会写回配置文件。/add-dir用来临时加目录。比如你在改主仓库但需要参考另一个仓库的代码跑/add-dir ~/code/another-projectAI 就能读到那个目录的文件。/config别名/settings是设置面板主题、默认模型、输出风格、编辑器模式都在这里调。旧版本的/vim已经合并进来了。验证动作跑完/init后ls一下根目录应该能看到CLAUDE.md。打开它确认里面有项目名和至少一条构建命令。3.2 会话类省 Token 防串戏/clear别名/reset、/new是开新任务前清场。它清空当前对话让 AI 不被之前的代码思路带偏。注意它不会清除CLAUDE.md和已加载的 skills。/compact是上下文快爆了压一压。它把前面多轮对话提炼成一份精简的技术摘要腾出 Token 空间。可以带重点指示比如/compact 重点保留我们对认证模块的设计决策。/context看上下文吃了多少。它用彩色网格展示系统提示、skills、历史对话的占用。接近 80% 时就该/compact了。/resume别名/continue接回历史会话。不带参数时打开交互式选择器也可以带 ID 或会话名。/branch别名/fork开个平行宇宙。分支出去尝试激进重构实验失败就用/resume切回主线。/btw顺嘴问一句。在不污染主对话记忆的前提下为非核心疑问开一个临时通话比如问 axios 最新版本。/rewind别名/checkpoint、/undo改崩了一键还原。时光倒流到之前的任意检查点适合 AI 改崩代码又不知道动了哪里时用。/rename [新名字]给会话改名方便在/resume时辨认。/export [filename]把对话导出成纯文本归档。/recap一句话总结当前进度。/goal condition设定一个目标AI 跨多轮一直推进直到达成。/focus全屏模式下只显示最后一次问答。验证动作跑/context看网格里历史对话占比。如果超过 70%跑/compact再跑一次/context占比应该明显下降。3.3 文件与代码类从规划到验证一条龙/plan是大改动先规划。跨多个文件大改前用它AI 会列出受影响文件、改动顺序和潜在风险此时完全不动代码你确认后再退出规划去执行。/diff看 AI 改了啥。弹出交互式 diff 浏览器方向键切换查看 git 整体 diff 或 AI 单轮改动。/review [PR]本地代码评审挑 Bug 和坏味道。/code-review专扫正确性 Bug可用 effort 调强度。/security-review安全审计专找注入、硬编码密钥、权限漏洞。/run让 AI 真跑起来验证。它读package.json或Makefile把 App 跑起来自己驱动并观察是否生效。/verify更进一步直接看 App 真实表现不靠测试和类型检查兜底。/run-skill-generator如果项目启动姿势复杂跑一次这个命令AI 会把启动配方记成项目级 skill 存进.claude/skills/后续/run和/verify自动按此配方执行。/copy复制上一条回答。敲命令后弹窗选择复制单个代码块或全部内容/copy 2复制倒数第二条按w键直接把内容写进文件。验证动作跑/plan 把 src/utils 下的日期函数统一成 dayjs看它列出的文件清单和改动顺序。确认无误后再让它执行。3.4 模型与算力类在速度和深度之间切分/model切模型opus / sonnet / haiku。不带参数开选择器在一行按d可设为新会话的默认模型。/effort思考强度调节可选 low / medium / high / xhigh / max。改完立刻生效不用等当前回答跑完。/fast极速流开关on / off。牺牲一些复杂推理换响应速度适合写脚手架或改 boilerplate。/output-style输出风格调节让回答更简短直接或更详尽。验证动作跑/model选 opus再跑/effort high然后问一个多文件重构问题观察回答的深度和耗时变化。3.5 权限与扩展类管 AI 能动什么/sandbox沙盒隔离开关。开启后严格限制 AI 的代码执行范围碰不到宿主机文件系统之外的东西。/mcp管 MCP 服务器。管理外部数据库、本地知识库、第三方工具的连接、OAuth 鉴权和状态。/hooks查看当前配的工具事件 hooks在文件保存、prompt 提交、工具调用前后自动插入逻辑。/plugin管理插件的安装、启用与禁用配套/reload-plugins实现免重启重载。/fewer-permission-prompts扫描历史自动给常用的只读命令加白名单减少弹窗。验证动作跑/permissions把Bash(git log:*)加进 allow 列表然后让 AI 跑一次git log --oneline -5确认不再弹确认框。3.6 调试与计费类看花了多少、坏了去哪修/usage别名/cost、/stats查看订阅用户每日剩余额度或按量付费用户的当前会话开销。/usage-credits旧名/extra-usage配置额度触顶后自动转按量付费。/doctor环境一键体检。检查 CLI 安装、二进制依赖、Node 运行时、网络连通按f让 AI 自动尝试修复。/status查看当前状态版本号、当前模型、登录账号、网络质量。/debug [description]开启调试日志精确定位 Bug。/heapdump写一份 JS 堆快照到桌面排查内存爆炸。/release-notes交互式查看更新日志。/help最简交互速查表。验证动作跑/doctor看体检报告。如果有红色项按f让它修修完再跑一次确认变绿。4. 验证请求与成功结果配置和命令都过了一遍现在做一次端到端验证。先确认环境变量echo $ANTHROPIC_BASE_URL # 预期输出https://taotoken.net/api echo $ANTHROPIC_API_KEY | head -c 8 # 预期输出sk-xxxxx前8位然后跑一条单次命令让 AI 读当前目录并总结claude -p 列出当前目录下所有 .json 文件并说明每个文件的用途预期输出是一段列表每个文件名后面跟一句用途说明。如果输出为空或报错往下看排查章节。接着进交互模式跑几条高频命令串起来claude # 进入 提示符后依次执行 /init /context /plan 把 README 里的安装步骤补全 /diff预期结果是/init生成CLAUDE.md/context显示上下文占用网格/plan列出要改的文件/diff弹出交互式 diff 浏览器能看到 README 的改动。最后验证权限配置是否生效claude -p 跑一下 git status 看看有没有未提交的改动如果settings.json里配了Bash(git status)自动放行这条命令应该直接执行不弹确认框。如果弹了说明配置文件没被读到检查路径是不是~/.claude/settings.json。5. 本篇常见错排查报 401 UnauthorizedKey 没读到。先echo $ANTHROPIC_API_KEY确认有值再检查settings.json里的apiKeyHelper路径对不对。如果用的是$TAOTOKEN_API_KEY这种变量引用确认 shell 配置已经source过。报连接超时或 ECONNREFUSEDANTHROPIC_BASE_URL写错了。正确值是https://taotoken.net/api注意结尾没有斜杠。改完重开终端。/compact之后 AI 还是记不住之前的设计决策压缩时没带重点指示。下次用/compact 重点保留 XXX 模块的设计决策把关键信息显式保留。/rewind找不到检查点检查点依赖 git。如果项目不是 git 仓库或者改动没被 git 追踪回滚会失败。先git init并做一次初始提交。/permissions改了但没生效面板改完要确认保存。有些版本需要重启会话才加载新权限。跑/status看当前配置有没有刷新。/doctor报 Node 版本过低Claude Code CLI 对 Node 版本有要求。用node -v看版本低于要求就升级。升级后重跑/doctor。/mcp连不上外部服务先确认 MCP 服务器的地址和鉴权信息。OAuth 类的需要先在浏览器完成授权再回终端跑/mcp看状态。/usage显示额度为 0如果是订阅用户检查订阅是否到期如果是按量付费检查账户余额。额度触顶后可以配/usage-credits自动转按量。6. 接入文档与后续操作命令跑通之后接下来该把接入层固化下来。TaoToken 的 API Key 管理在 https://taotoken.net/api-keys 你可以在这里生成新 Key、吊销旧 Key、看每个 Key 的用量。接入文档在 https://taotoken.net/doc 里面有各语言 SDK 的调用示例和错误码说明。如果你主要用 Claude Code 做长期编码或者搭 Agent建议看一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan 。它把常用模型的额度打包适合每天都要跑 CLI 的场景。想先验证模型对话效果可以直接在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel_chat 里试不用装任何东西。最后提醒一句CLAUDE.md写得好不好直接决定 AI 在你项目里的表现。花十分钟把构建命令、测试命令、目录结构、命名规范写清楚后面能省几十次纠正。命令是工具记忆才是底座。