尧图网页设计 
1. 为什么你的 Claude Code 只发挥了 20%Claude Code 内置了 50 多个命令但绝大多数开发者日常只反复用其中 3 到 5 个。这不是懒而是没人系统梳理过哪些命令属于终端启动参数、哪些是会话内斜杠命令、哪些是键盘快捷键它们各自解决什么问题、什么时候该用哪个。结果就是上下文爆了才想起压缩、改错了代码只能手动回滚、每次新会话都要重新解释项目规范。这篇把 Claude Code 的命令体系按三种类型、七大分类拆开讲清楚覆盖斜杠命令、CLI 标志、键盘快捷键与 CLAUDE.md 的配合方式并给出 settings.json 与 config.toml 的可复制配置骨架。同时演示如何通过统一 Key/API 通道接入让命令速查和配置基线可查、可改、可复现。适合已经装好 Claude Code、但感觉效率没拉满的开发者也适合想给团队建立统一配置规范的 Tech Lead。三种命令类型的边界先划清楚CLI 标志在终端启动时生效比如claude -c恢复最近会话斜杠命令在交互式会话内部输入/触发比如/compact压缩上下文键盘快捷键在会话期间直接按键生效比如ShiftTab切换模式。搞混这三类就会出现为什么我输入 /model 没反应这种问题——因为你可能是在 shell 里而不是会话里敲的。七大分类则是按用途划分会话管理、上下文控制、模型与成本、代码审查、任务与 Agent、配置与记忆、启动与输出。下面逐类拆解。2. 前置准备统一 Key/API 通道与配置骨架在深入命令之前先把接入层配好。Claude Code 支持通过环境变量指定 API 端点和 Key这样你可以在不同项目间复用同一套凭证也方便团队统一管理。TaoToken 提供统一的 API 通道官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址为 https://taotoken.net/api 。你需要先在控制台创建一个 API Key然后把它写进配置。2.1 settings.json 配置骨架Claude Code 的用户级配置位于~/.claude/settings.json项目级配置位于项目根目录的.claude/settings.json。项目级会覆盖用户级同名项。下面是一份可直接复制的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-key-here, CLAUDE_CODE_TASK_LIST_ID: my-project-tasks }, permissions: { allow: [ Bash(npm test), Bash(git status), Bash(git diff), Read ], deny: [ Bash(git push), Bash(rm -rf) ] }, model: claude-sonnet-4-20250514 }env块里的ANTHROPIC_BASE_URL指向统一通道ANTHROPIC_API_KEY填你在控制台生成的 Key。permissions.allow列出可以跳过确认直接执行的操作deny列出永远需要人工确认的危险操作。CLAUDE_CODE_TASK_LIST_ID用于跨会话共享任务列表。2.2 config.toml 配置骨架如果你用的是支持 TOML 的封装工具或自建网关可以用下面这份等价配置[api] base_url https://taotoken.net/api api_key sk-your-key-here timeout_seconds 120 [model] default claude-sonnet-4-20250514 fallback claude-haiku-4-20250514 [context] compact_threshold 0.75 auto_compact true [permissions] auto_approve [Read, Bash(git status), Bash(npm test)] require_approval [Bash(git push), Write]compact_threshold 0.75表示上下文用到 75% 时自动触发压缩这个值比等到 90% 再手动处理要稳妥得多。auto_approve和require_approval对应 settings.json 里的 allow/deny。2.3 环境变量方式临时验证用不想改配置文件时可以直接在 shell 里导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-your-key-here claude --print say hello这种方式适合快速验证通道是否通但不适合长期使用因为每次开新终端都要重新导出。3. 七大分类命令速查与可复制配置3.1 会话管理类这类命令控制会话的启动、恢复和切换。CLI 标志为主。claude # 在当前目录启动新会话 claude -c # 恢复当前目录最近的会话 claude --resume # 从会话列表中选择恢复 claude --resume auth-fix # 按名称恢复指定会话 claude --from-pr 123 # 恢复与 PR #123 关联的会话会话数据保存在~/.claude/projects/下按项目路径分目录。/resume斜杠命令在会话内也能触发恢复菜单。切换任务时用/clear硬重置继续同一任务时用/compact压缩保留。3.2 上下文控制类上下文窗口是 Claude Code 最稀缺的资源。这类命令决定你什么时候该压缩、什么时候该清空。/context # 查看当前上下文占用百分比 /compact # 压缩对话历史保留关键决策 /compact retain the auth module changes and error patterns /clear # 完全清空对话历史/context输出类似Context usage: 67% (134,400 / 200,000 tokens)。实测下来70% 到 80% 之间主动执行/compact效果最好等到 90% 以上 Claude 已经开始遗忘早期决策了。/compact后面可以跟保留指令告诉它哪些内容必须留下。3.3 模型与成本类/model # 交互式选择模型 /model sonnet # 切到 Sonnet /model opus # 切到 Opus /model haiku # 切到 Haiku /cost # 查看当前会话 Token 消耗和费用 /fast # 切换 Fast Mode日常策略是 Sonnet 起步遇到复杂多步规划切 Opus简单编辑和模板生成交给 Haiku。/cost输出会显示输入输出 Token 数和估算费用。Fast Mode 运行的是同一个 Opus 模型但调整了 API 配置以降低延迟适合快速迭代写生产代码时建议关掉。3.4 代码审查类/diff # 查看当前会话所有代码改动 /diff src/auth.ts # 只看指定文件的改动 /simplify # 三 Agent 并行代码审查/diff是提交前的必跑命令。每个功能做完执行/diff审查改动确认无误再提交。/simplify会从代码质量、安全、最佳实践、性能、测试覆盖五个维度并行审查替代了早期的/review。3.5 任务与 Agent 类/todos # 查看持久化任务列表 CtrlT # 切换任务列表显示 /agents # 管理子 Agent agent-create test-writer Writes comprehensive Jest tests任务列表跨会话持久保存/compact也不会影响它。设置CLAUDE_CODE_TASK_LIST_ID环境变量可以让多个会话共享同一份任务列表。子 Agent 用于把专项工作比如写测试委派出去主对话保持干净。3.6 配置与记忆类/init # 在项目根目录生成 CLAUDE.md /memory # 在会话内编辑 CLAUDE.md # 快速记忆语法 # Use async/await for all database queries/init生成的 CLAUDE.md 包含项目描述、技术栈、代码风格和常见模式。每个项目从/init开始能消除大量重复的上下文设置。以#开头的输入会直接追加到 CLAUDE.md不用退出会话打开编辑器。3.7 启动与输出类claude --print question # 一次性查询后退出 claude --print ... --output-format json # JSON 结构化输出 claude --append-system-prompt Always use TypeScript strict mode claude --agents {test-writer: {role: Write Jest tests}}--print适合脚本和 CI/CD 流水线。--output-format json让输出可被程序解析。--append-system-prompt在保留默认能力的基础上追加规则比--system-prompt安全得多——后者会完全替换默认指令集只在需要完全控制时使用。4. 验证请求确认通道与命令生效配置写完后先验证 API 通道是否通再验证命令是否按预期工作。4.1 验证 API 通道export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-your-key-here claude --print Reply with exactly: channel-ok预期输出就是channel-ok。如果返回认证错误检查 Key 是否复制完整、是否有多余空格。如果返回连接超时检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api注意结尾没有斜杠。4.2 验证配置文件被读取claude --print What is your base URL? --output-format json返回的 JSON 里如果包含你配置的端点信息说明 settings.json 被正确加载。也可以直接检查cat ~/.claude/settings.json | python3 -m json.tool确保 JSON 格式合法没有尾随逗号。4.3 验证斜杠命令与快捷键启动交互式会话后claude在会话内依次输入/context、/cost、/help确认都有输出。按ShiftTab观察模式是否在 normal → auto-accept → plan 之间循环。按CtrlT确认任务列表显示切换。这些动作都正常说明命令体系已经就绪。4.4 验证 CLAUDE.md 生效在项目根目录执行/init然后检查生成的 CLAUDE.mdcat CLAUDE.md接着在会话里问一个项目相关的问题比如这个项目用什么测试框架如果 Claude 能直接答出来而不是反问你说明 CLAUDE.md 被正确读取了。5. 本篇常见错排查5.1/model输入后没反应最常见的原因是你在 shell 里而不是会话里敲的。斜杠命令只在claude交互式会话内部生效。先运行claude进入会话再输入/model。5.2/compact后关键信息丢失/compact默认会摘要对话历史但可能丢掉你认为重要的细节。解决办法是在命令后跟保留指令/compact retain the database schema decisions and auth module changes另外把长期有效的规则写进 CLAUDE.md而不是依赖对话历史。CLAUDE.md 的内容在压缩时会被保留。5.3--print在脚本里返回空检查是否在非交互环境下缺少 API Key。--print模式不会读取交互式登录态必须通过环境变量或配置文件提供凭证。另外确认--output-format json时输出被正确解析有些 shell 会把 JSON 里的引号吃掉建议用jq处理claude --print list files --output-format json | jq -r .result5.4ShiftTab在 WSL 或 Windows Terminal 里无效WSL 环境下某些键位绑定可能被终端拦截。执行/terminal-setup安装对应的键位绑定即可。macOS 上如果Alt相关快捷键无效需要在 iTerm2 的 Settings → Profiles → Keys 里把 Option 键设为 Esc。5.5 配置文件改了但不生效Claude Code 读取配置的优先级是项目级.claude/settings.json 用户级~/.claude/settings.json 环境变量。如果你在用户级改了但项目级有同名项项目级会覆盖。检查两个文件是否有冲突。另外 JSON 格式错误会导致整个文件被忽略用python3 -m json.tool验证一下。5.6/cost显示的费用和预期不符/cost显示的是当前会话的累计消耗。如果你在会话中途切换了模型比如从 Haiku 切到 Opus费用会按各模型的实际用量分别计算。Fast Mode 开启后之前积累的上下文会按 Fast Mode 费率重新计费这是费用跳升的常见原因。6. 把命令体系变成团队基线命令速查只是起点真正有价值的是把配置固化成团队可复用的基线。建议把.claude/settings.json和CLAUDE.md一起提交到项目仓库新成员克隆后直接就有统一的权限规则、模型选择和项目记忆。API Key 不要写进仓库用环境变量或本地覆盖文件处理。团队统一使用同一个 API 通道时把ANTHROPIC_BASE_URL写进项目级配置Key 通过 CI/CD 的 secret 注入。需要长期跑编码任务或 Agent 工作流的可以了解 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先在网页里验证模型对话效果用模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。生成和管理 Key 在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 列表页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。从核心 10 个命令开始用起每周加一个新命令把关键会话用/export导出保留。命令体系熟悉之后Claude Code 才真正从终端版聊天框变成可编程的编码伙伴。 Claude Code 命令体系全拆解：三种类型、七大分类、50+ 命令与 TaoToken 配置骨架
1. 为什么你的 Claude Code 只发挥了 20%Claude Code 内置了 50 多个命令但绝大多数开发者日常只反复用其中 3 到 5 个。这不是懒而是没人系统梳理过哪些命令属于终端启动参数、哪些是会话内斜杠命令、哪些是键盘快捷键它们各自解决什么问题、什么时候该用哪个。结果就是上下文爆了才想起压缩、改错了代码只能手动回滚、每次新会话都要重新解释项目规范。这篇把 Claude Code 的命令体系按三种类型、七大分类拆开讲清楚覆盖斜杠命令、CLI 标志、键盘快捷键与 CLAUDE.md 的配合方式并给出 settings.json 与 config.toml 的可复制配置骨架。同时演示如何通过统一 Key/API 通道接入让命令速查和配置基线可查、可改、可复现。适合已经装好 Claude Code、但感觉效率没拉满的开发者也适合想给团队建立统一配置规范的 Tech Lead。三种命令类型的边界先划清楚CLI 标志在终端启动时生效比如claude -c恢复最近会话斜杠命令在交互式会话内部输入/触发比如/compact压缩上下文键盘快捷键在会话期间直接按键生效比如ShiftTab切换模式。搞混这三类就会出现为什么我输入 /model 没反应这种问题——因为你可能是在 shell 里而不是会话里敲的。七大分类则是按用途划分会话管理、上下文控制、模型与成本、代码审查、任务与 Agent、配置与记忆、启动与输出。下面逐类拆解。2. 前置准备统一 Key/API 通道与配置骨架在深入命令之前先把接入层配好。Claude Code 支持通过环境变量指定 API 端点和 Key这样你可以在不同项目间复用同一套凭证也方便团队统一管理。TaoToken 提供统一的 API 通道官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址为 https://taotoken.net/api 。你需要先在控制台创建一个 API Key然后把它写进配置。2.1 settings.json 配置骨架Claude Code 的用户级配置位于~/.claude/settings.json项目级配置位于项目根目录的.claude/settings.json。项目级会覆盖用户级同名项。下面是一份可直接复制的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-key-here, CLAUDE_CODE_TASK_LIST_ID: my-project-tasks }, permissions: { allow: [ Bash(npm test), Bash(git status), Bash(git diff), Read ], deny: [ Bash(git push), Bash(rm -rf) ] }, model: claude-sonnet-4-20250514 }env块里的ANTHROPIC_BASE_URL指向统一通道ANTHROPIC_API_KEY填你在控制台生成的 Key。permissions.allow列出可以跳过确认直接执行的操作deny列出永远需要人工确认的危险操作。CLAUDE_CODE_TASK_LIST_ID用于跨会话共享任务列表。2.2 config.toml 配置骨架如果你用的是支持 TOML 的封装工具或自建网关可以用下面这份等价配置[api] base_url https://taotoken.net/api api_key sk-your-key-here timeout_seconds 120 [model] default claude-sonnet-4-20250514 fallback claude-haiku-4-20250514 [context] compact_threshold 0.75 auto_compact true [permissions] auto_approve [Read, Bash(git status), Bash(npm test)] require_approval [Bash(git push), Write]compact_threshold 0.75表示上下文用到 75% 时自动触发压缩这个值比等到 90% 再手动处理要稳妥得多。auto_approve和require_approval对应 settings.json 里的 allow/deny。2.3 环境变量方式临时验证用不想改配置文件时可以直接在 shell 里导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-your-key-here claude --print say hello这种方式适合快速验证通道是否通但不适合长期使用因为每次开新终端都要重新导出。3. 七大分类命令速查与可复制配置3.1 会话管理类这类命令控制会话的启动、恢复和切换。CLI 标志为主。claude # 在当前目录启动新会话 claude -c # 恢复当前目录最近的会话 claude --resume # 从会话列表中选择恢复 claude --resume auth-fix # 按名称恢复指定会话 claude --from-pr 123 # 恢复与 PR #123 关联的会话会话数据保存在~/.claude/projects/下按项目路径分目录。/resume斜杠命令在会话内也能触发恢复菜单。切换任务时用/clear硬重置继续同一任务时用/compact压缩保留。3.2 上下文控制类上下文窗口是 Claude Code 最稀缺的资源。这类命令决定你什么时候该压缩、什么时候该清空。/context # 查看当前上下文占用百分比 /compact # 压缩对话历史保留关键决策 /compact retain the auth module changes and error patterns /clear # 完全清空对话历史/context输出类似Context usage: 67% (134,400 / 200,000 tokens)。实测下来70% 到 80% 之间主动执行/compact效果最好等到 90% 以上 Claude 已经开始遗忘早期决策了。/compact后面可以跟保留指令告诉它哪些内容必须留下。3.3 模型与成本类/model # 交互式选择模型 /model sonnet # 切到 Sonnet /model opus # 切到 Opus /model haiku # 切到 Haiku /cost # 查看当前会话 Token 消耗和费用 /fast # 切换 Fast Mode日常策略是 Sonnet 起步遇到复杂多步规划切 Opus简单编辑和模板生成交给 Haiku。/cost输出会显示输入输出 Token 数和估算费用。Fast Mode 运行的是同一个 Opus 模型但调整了 API 配置以降低延迟适合快速迭代写生产代码时建议关掉。3.4 代码审查类/diff # 查看当前会话所有代码改动 /diff src/auth.ts # 只看指定文件的改动 /simplify # 三 Agent 并行代码审查/diff是提交前的必跑命令。每个功能做完执行/diff审查改动确认无误再提交。/simplify会从代码质量、安全、最佳实践、性能、测试覆盖五个维度并行审查替代了早期的/review。3.5 任务与 Agent 类/todos # 查看持久化任务列表 CtrlT # 切换任务列表显示 /agents # 管理子 Agent agent-create test-writer Writes comprehensive Jest tests任务列表跨会话持久保存/compact也不会影响它。设置CLAUDE_CODE_TASK_LIST_ID环境变量可以让多个会话共享同一份任务列表。子 Agent 用于把专项工作比如写测试委派出去主对话保持干净。3.6 配置与记忆类/init # 在项目根目录生成 CLAUDE.md /memory # 在会话内编辑 CLAUDE.md # 快速记忆语法 # Use async/await for all database queries/init生成的 CLAUDE.md 包含项目描述、技术栈、代码风格和常见模式。每个项目从/init开始能消除大量重复的上下文设置。以#开头的输入会直接追加到 CLAUDE.md不用退出会话打开编辑器。3.7 启动与输出类claude --print question # 一次性查询后退出 claude --print ... --output-format json # JSON 结构化输出 claude --append-system-prompt Always use TypeScript strict mode claude --agents {test-writer: {role: Write Jest tests}}--print适合脚本和 CI/CD 流水线。--output-format json让输出可被程序解析。--append-system-prompt在保留默认能力的基础上追加规则比--system-prompt安全得多——后者会完全替换默认指令集只在需要完全控制时使用。4. 验证请求确认通道与命令生效配置写完后先验证 API 通道是否通再验证命令是否按预期工作。4.1 验证 API 通道export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-your-key-here claude --print Reply with exactly: channel-ok预期输出就是channel-ok。如果返回认证错误检查 Key 是否复制完整、是否有多余空格。如果返回连接超时检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api注意结尾没有斜杠。4.2 验证配置文件被读取claude --print What is your base URL? --output-format json返回的 JSON 里如果包含你配置的端点信息说明 settings.json 被正确加载。也可以直接检查cat ~/.claude/settings.json | python3 -m json.tool确保 JSON 格式合法没有尾随逗号。4.3 验证斜杠命令与快捷键启动交互式会话后claude在会话内依次输入/context、/cost、/help确认都有输出。按ShiftTab观察模式是否在 normal → auto-accept → plan 之间循环。按CtrlT确认任务列表显示切换。这些动作都正常说明命令体系已经就绪。4.4 验证 CLAUDE.md 生效在项目根目录执行/init然后检查生成的 CLAUDE.mdcat CLAUDE.md接着在会话里问一个项目相关的问题比如这个项目用什么测试框架如果 Claude 能直接答出来而不是反问你说明 CLAUDE.md 被正确读取了。5. 本篇常见错排查5.1/model输入后没反应最常见的原因是你在 shell 里而不是会话里敲的。斜杠命令只在claude交互式会话内部生效。先运行claude进入会话再输入/model。5.2/compact后关键信息丢失/compact默认会摘要对话历史但可能丢掉你认为重要的细节。解决办法是在命令后跟保留指令/compact retain the database schema decisions and auth module changes另外把长期有效的规则写进 CLAUDE.md而不是依赖对话历史。CLAUDE.md 的内容在压缩时会被保留。5.3--print在脚本里返回空检查是否在非交互环境下缺少 API Key。--print模式不会读取交互式登录态必须通过环境变量或配置文件提供凭证。另外确认--output-format json时输出被正确解析有些 shell 会把 JSON 里的引号吃掉建议用jq处理claude --print list files --output-format json | jq -r .result5.4ShiftTab在 WSL 或 Windows Terminal 里无效WSL 环境下某些键位绑定可能被终端拦截。执行/terminal-setup安装对应的键位绑定即可。macOS 上如果Alt相关快捷键无效需要在 iTerm2 的 Settings → Profiles → Keys 里把 Option 键设为 Esc。5.5 配置文件改了但不生效Claude Code 读取配置的优先级是项目级.claude/settings.json 用户级~/.claude/settings.json 环境变量。如果你在用户级改了但项目级有同名项项目级会覆盖。检查两个文件是否有冲突。另外 JSON 格式错误会导致整个文件被忽略用python3 -m json.tool验证一下。5.6/cost显示的费用和预期不符/cost显示的是当前会话的累计消耗。如果你在会话中途切换了模型比如从 Haiku 切到 Opus费用会按各模型的实际用量分别计算。Fast Mode 开启后之前积累的上下文会按 Fast Mode 费率重新计费这是费用跳升的常见原因。6. 把命令体系变成团队基线命令速查只是起点真正有价值的是把配置固化成团队可复用的基线。建议把.claude/settings.json和CLAUDE.md一起提交到项目仓库新成员克隆后直接就有统一的权限规则、模型选择和项目记忆。API Key 不要写进仓库用环境变量或本地覆盖文件处理。团队统一使用同一个 API 通道时把ANTHROPIC_BASE_URL写进项目级配置Key 通过 CI/CD 的 secret 注入。需要长期跑编码任务或 Agent 工作流的可以了解 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先在网页里验证模型对话效果用模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。生成和管理 Key 在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 列表页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节查文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。从核心 10 个命令开始用起每周加一个新命令把关键会话用/export导出保留。命令体系熟悉之后Claude Code 才真正从终端版聊天框变成可编程的编码伙伴。