1. Claude Code 命令速查与实践手册TaoToken 统一 Key 接入 settings.json 配置骨架Claude Code 是 Anthropic 推出的命令行编程助手它把「读代码、改文件、跑命令、做审查」这些动作收进一个 CLI 里适合习惯在终端里干活的开发者。它最实用的地方在于斜杠命令和权限模式斜杠命令让你在会话里切换模型、压缩上下文、管理 MCP权限模式决定 Claude 是「每步都问你」还是「放手让它改」。这篇手册聚焦两件事一是把常用命令和权限模式整理成能直接查的速查表二是给出用 TaoToken 统一 Key 接入settings.json的配置骨架让你在本地把 API 通道配好之后再用命令验证配置是否生效。如果你正在找 Claude Code 的命令清单、CLI 启动参数、斜杠命令和权限模式切换方式这篇可以当作手边参考。我试过在几个项目里反复调settings.json踩过的坑大多集中在环境变量和权限模式这两块下面按「先接通道、再查命令、最后排障」的顺序展开。2. TaoToken 前置统一 Key 与 API 通道准备Claude Code 默认走 Anthropic 官方通道需要ANTHROPIC_API_KEY。如果你希望用一个统一 Key 管理多个模型的调用可以先把 TaoToken 的 API 通道准备好再把它写进 Claude Code 的配置里。TaoToken 提供统一的 API 入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。准备工作分三步。第一步在控制台创建一个 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建后复制保存Key 只在创建时完整显示一次。第二步确认你要用的模型名Claude Code 里常用的是 sonnet、opus、haiku 这几个别名具体可用模型以控制台列表为准。第三步决定配置写在哪项目级配置放在项目根目录的.claude/settings.json全局配置放在~/.claude/settings.json。项目级优先于全局团队协作时建议项目级个人机器上可以全局。注意API Key 属于敏感信息不要提交到 Git。项目级settings.json里如果写了 Key记得加进.gitignore或者改用环境变量注入。这里要区分两个概念settings.json管的是 Claude Code 的行为模型、权限、工具白名单而 API 通道管的是「请求发到哪」。两者配合才能让统一 Key 真正生效。3. 可复制配置settings.json 配置骨架下面这份骨架可以直接复制把YOUR_TAOTOKEN_API_KEY换成你自己的 Key。核心思路是通过env字段把 API 基址和 Key 注入 Claude Code 的运行环境再用permissions控制工具权限。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: YOUR_TAOTOKEN_API_KEY, ANTHROPIC_MODEL: sonnet, ANTHROPIC_SMALL_FAST_MODEL: haiku }, permissions: { allow: [ Read, Edit, Bash(git:*), Bash(npm:*) ], deny: [ Bash(rm:*), Bash(curl:*) ], defaultMode: acceptEdits }, model: sonnet }几个字段说明一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 基址这是统一通道的关键ANTHROPIC_API_KEY填你的 KeyANTHROPIC_MODEL是主模型ANTHROPIC_SMALL_FAST_MODEL用于轻量任务能省费用。permissions.allow是工具白名单Bash(git:*)表示允许所有 git 开头的命令deny优先级高于allow把危险命令挡在外面。defaultMode设成acceptEdits表示自动接受文件编辑但其他操作仍会询问。如果你不想把 Key 写进文件可以只保留ANTHROPIC_BASE_URL然后在 shell 里导出 Keyexport ANTHROPIC_API_KEYYOUR_TAOTOKEN_API_KEY export ANTHROPIC_BASE_URLhttps://taotoken.net/api这样settings.json里就不含敏感信息适合放进版本库。两种方式选一种即可同时存在时环境变量通常优先。4. 命令速查与验证请求配置写好后先用claude doctor做健康检查它会诊断安装和配置问题包括 API 通道是否可达。然后跑一个最小请求验证通道claude -p 用一句话说明当前使用的模型如果返回正常文本说明 Key 和基址都通了。接着验证settings.json是否被加载claude -p --output-format json 输出当前配置的模型名--output-format json会返回结构化结果方便脚本解析。下面把常用斜杠命令和 CLI 参数整理成速查表。4.1 交互式斜杠命令速查在交互模式里输入/开头的命令控制会话。会话控制类/help显示所有命令/clear清空上下文适合切换任务/compact [指令]压缩历史并保留重点/undo回退最近一次文件更改/exit退出。模式切换类/plan进入计划模式先给方案/fast切换快速模式/model opus|sonnet|haiku切换模型/effort low|medium|high|max设置推理深度。会话管理类/resume恢复历史会话/sessions列出会话/tasks查看后台任务/name命名当前会话。工具与配置类/config打开 settings.json/permissions管理权限/mcp管理 MCP 服务器/cost查看费用/doctor健康检查/status查看连接状态。4.2 CLI 启动参数速查核心参数-p单次输出模式-c继续最近会话-r恢复指定会话--model指定模型--file输入文件--effort推理深度--output-format text|json|stream-json输出格式--permission-mode权限模式--allowedTools允许的工具--max-budget-usd费用上限-w创建 git worktree--verbose详细日志--debug调试模式。子命令claude doctor健康检查claude auth管理认证claude mcp管理 MCPclaude update更新claude setup-token设置长期 token。4.3 权限模式对照权限模式用--permission-mode指定或在会话里按 ShiftTab 循环切换。default每次操作需确认适合初次使用acceptEdits自动接受文件编辑适合信任代码修改plan先计划再执行适合复杂任务auto自动执行所有操作适合快速迭代dontAsk不询问直接执行适合自动化流水线bypassPermissions跳过所有权限检查仅限沙箱环境。注意bypassPermissions和--dangerously-skip-permissions只应在隔离的沙箱或测试环境使用不要在包含真实数据的机器上开启。4.4 自定义斜杠命令在项目目录.claude/commands/或全局~/.claude/commands/下创建.md文件文件名即命令名。文件头部用 frontmatter 声明元信息--- allowed-tools: Edit, Bash model: sonnet description: 审查当前分支的代码变更 --- 审查当前分支相对于 main 的所有变更 1. 检查代码质量 2. 发现潜在 bug 3. 给出改进建议 $ARGUMENTS$ARGUMENTS会捕获命令后的参数比如/review 关注并发问题会把「关注并发问题」传进去。5. 本篇常见错排查配置过程中最容易卡在几个地方。第一个是ANTHROPIC_BASE_URL写错比如漏了/api或多了斜杠导致请求 404。验证方法是claude doctor它会显示当前基址。第二个是 Key 无效或过期表现为 401去控制台重新生成即可入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第三个是settings.json格式错误JSON 不允许尾随逗号用编辑器校验一下。第四个是权限模式没生效检查defaultMode拼写以及是否被命令行参数覆盖。第五个是模型名不存在ANTHROPIC_MODEL要填控制台里实际可用的名字填错会报模型不可用。如果claude -p一直卡住不返回先确认网络能访问 API 基址再用--verbose看详细日志。如果返回内容被截断检查--max-budget-usd是否设得太低。如果斜杠命令列表里没有你自定义的命令确认文件放在正确的目录且扩展名是.md。6. 语义一致 CTA配置和命令都跑通之后接下来按你的使用场景选入口。如果你主要在排障和接入阶段建议先看 API Keys 管理和接入文档把 Key 和基址确认清楚API Keys 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你想先验证模型对话效果可以直接在模型对话页测试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你打算长期用 Claude Code 做编码和 Agent 任务Coding Plan 更适合按量规划https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。控制台总入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 需要管理多个 Key 或查看用量时从这里进。最后补一个实用技巧把settings.json里的permissions.allow按项目实际用到的命令逐步放开不要一上来就全开。我习惯先只放Read和Edit跑几天确认没问题再加Bash(git:*)这样即使模型判断失误影响范围也可控。权限模式同理从default起步熟悉之后再切acceptEdits。