1. 刚上手 Claude Code 时我踩过的指令坑Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接读写你本地的项目文件、跑 shell 命令、按你的指令改代码。它适合谁适合已经习惯在终端里干活、又想让 AI 真正动手改文件而不是只聊天的开发者。但刚接触的人几乎都会卡在同一个地方指令太多slash 命令、CLI flags、CLAUDE.md 三套东西混在一起不知道哪个该在什么时候用。我一开始也是这样。装完之后只会敲claude进会话然后像用聊天框一样一句句问结果发现它老是忘记项目规范每次都要重新解释一遍技术栈想恢复上次的会话又不知道按哪个键看到别人用引用文件、用!跑命令自己试了半天没反应——后来才发现!前缀得在会话里用不是 shell 里用。更麻烦的是网络调用这一层。Claude Code 默认走官方 endpoint很多人在国内环境下会遇到请求超时、local proxy failed、401之类的报错于是干脆放弃。其实只要把 endpoint 换成一个稳定可达的兼容入口再配合正确的 Base URL、Key、Model ID 三件套整条链路就能跑通。这篇就按指令速查 接入验证两条线走先把 slash 命令、CLI flags、CLAUDE.md 三类高频指令讲清楚再演示怎么把 endpoint 改到 TaoToken然后逐条验证调用是否真的生效。你可以边看边在终端里敲跟着做一遍就有自己的指令工作流了。先说清楚三套指令的分工这是后面所有操作的地基类型在哪用典型场景例子Slash 命令会话内输入框敲/会话管理、上下文控制、代码审查/compact、/rewind、/simplifyCLI flags启动claude时跟在后面非交互、系统提示、权限、模型选择claude -p ...、--append-system-promptCLAUDE.md项目根目录/全局目录的文件固化项目规范、架构说明./CLAUDE.md、~/.claude/CLAUDE.md记住一句话slash 命令管会话里发生什么CLI flags 管这次启动怎么跑CLAUDE.md 管它默认该知道什么。三者组合起来才是完整的指令工作流。2. TaoToken 前置把 endpoint 换成稳定入口在讲具体指令之前得先把调用链路搭好否则你敲再多命令也可能卡在网络上。Claude Code 支持通过环境变量指定 API 入口我们要做的就是把它指向 TaoToken 的兼容地址然后配上 Key 和 Model ID。TaoToken 在这里扮演的是一个统一的模型调用入口你拿到一个 API Key把 Base URL 指向https://taotoken.net/apiClaude Code 的请求就会走这条链路。它不是什么绕过限制的东西就是一个标准的 API 网关你按正常方式配置环境变量即可。第一步去控制台拿 Key。打开 https://taotoken.net/console 登录后在 API Keys 页面创建一个新 Key复制出来。这个 Key 只显示一次建议先存到密码管理器里。第二步配置环境变量。Claude Code 读取的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两个变量不同版本可能略有差异以你本地claude --help为准。Linux/macOS 下写进~/.zshrc或~/.bashrc# 写入 shell 配置持久生效 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 # 让当前终端立即生效 source ~/.zshrcWindows PowerShell 下用$env:临时设置或者写进系统环境变量$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_API_KEY sk-你的TaoToken密钥第三步确认 Model ID。Claude Code 里模型是通过/model命令或启动参数切换的常见的有claude-sonnet-4-6、claude-opus-4-6这类标识。你要保证填的 Model ID 和 TaoToken 侧支持的模型名一致否则会报model not found。可以在模型对话页面先确认可用模型列表https://taotoken.net/models 。这里有个容易忽略的点Base URL 和 Key 是接入层Model ID 是调用层三者必须同时正确。只改 Base URL 不改 Key会 401Key 对了但 Model ID 写错会报模型不存在两个都对但 Base URL 少了/api路径可能直接连不上。后面第 5 节会专门对照这几个报错。配置完先别急着进会话用一条最简单的非交互命令验证链路是否通claude -p 回复一句链路已通如果终端返回了类似链路已通的文本说明 Base URL Key Model 三件套已经生效。如果报错先别往下走回到第 5 节排查。这一步是整个手册的前提链路不通后面所有 slash 命令都是空谈。3. 可复制配置CLAUDE.md 与 settings 片段链路通了之后接下来要把项目规范固化下来否则每次开新会话你都得重新解释一遍技术栈。这就是 CLAUDE.md 的用途——Claude Code 启动时会自动读取它把它当作项目上下文。在项目根目录创建CLAUDE.md内容可以直接抄下面这份按你自己的项目改# Project context ## Coding standards - 所有新代码使用 TypeScript禁止 any - 遵循仓库根目录的 ESLint 配置 - 单元测试用 Jest测试文件放在 __tests__ 目录 ## Architecture - Frontend: Next.js TypeScript - Backend: Node.js Express - Database: PostgreSQL Prisma ## Commands - 安装依赖: npm install - 跑测试: npm test - 本地启动: npm run devCLAUDE.md 支持层级覆盖优先级从低到高是~/.claude/CLAUDE.md全局放你个人的通用偏好→./CLAUDE.md项目级→ 子目录里的CLAUDE.md局部覆盖。我一般把始终用中文回复提交信息用中文这类个人习惯放全局把技术栈和命令放项目级。除了 CLAUDE.mdClaude Code 还有一层 settings 配置用来控制权限、通知、模型等。配置文件通常在~/.claude/settings.json格式是 JSON{ model: claude-sonnet-4-6, preferredNotifChannel: terminal_bell, permissions: { allow: [ Bash(npm test), Bash(git status), Read ], deny: [ Bash(rm -rf *) ] } }这份 settings 里model指定默认模型permissions.allow列出免确认就能跑的命令deny是明确禁止的。把npm test、git status这类只读或安全命令加进 allow能省掉大量是否允许执行的确认弹窗把rm -rf *放进 deny是给自己上一道保险。如果你用的是支持 TOML 配置的客户端比如某些 MCP 集成场景配置片段长这样[model] default claude-sonnet-4-6 [permissions] allow [Bash(npm test), Read] deny [Bash(rm -rf *)]注意路径要和你的实际环境一致全局配置在~/.claude/项目配置在项目根目录的.claude/下。改完配置后用claude config list可以查看当前生效的配置项确认没有写错位置。这里再强调一次三件套的完整性。无论你用 JSON 还是 TOML只要涉及自定义接入就必须同时确认Base URL https://taotoken.net/api、Key 你的 TaoToken 密钥、Model ID 实际可用的模型名。缺任何一个配置看起来对调用照样失败。4. 逐条验证slash 命令与 CLI flags 实测配置就绪后开始逐条验证指令。先讲 CLI flags因为它们决定这次启动怎么跑。最常用的几个启动方式# 启动新会话 claude # 带初始提示直接启动 claude 帮我分析这个项目结构 # 非交互模式适合 CI/CD 或脚本 claude -p 检查代码中的 lint 错误并修复 # 恢复上一次会话 claude --continue # 列出历史会话选择恢复 claude --resume系统提示词相关的 flags 是控制 AI 行为的关键# 替换系统提示 claude --system-prompt 你是一个专注安全审查的代码专家 # 从文件读取系统提示 claude --system-prompt-file ./my-prompt.txt # 追加到默认系统提示推荐保留默认能力 claude --append-system-prompt 始终用中文回复 claude --append-system-prompt-file ./extra-rules.txt我实测下来--append-system-prompt比--system-prompt更实用因为后者会覆盖掉 Claude Code 内置的编码能力提示容易让 AI 变得不会用工具。追加模式则是在保留默认能力的基础上加你的规则。进会话后slash 命令是高频操作。先验证最基础的几个/help # 查看所有可用命令 /status # 查看当前会话状态 /cost # 查看本次会话 token 消耗 /clear # 清除当前对话上下文 /compact # 压缩上下文以节省 token /exit # 退出会话/compact值得单独说长会话里上下文会越来越满/compact会把历史对话压缩成摘要保留关键信息的同时腾出 token 空间。我一般在完成一个大功能、准备开新任务前跑一次。再验证几个进阶命令这些是真正拉开效率差距的/plan # 进入计划模式只分析不修改文件 /rewind # 回退相当于 CtrlZ也可连按两下 Esc /btw # 插一个问题但不污染上下文 /branch # 从当前对话分叉出新会话 /simplify # 三合一代码审查复用/质量/效率 /insights # 生成过去一个月的使用报告 /model # 切换模型/plan是我最推荐的入门习惯在让 AI 动手改代码前先用/plan让它以只读模式分析代码库、给出实现方案你确认后再执行。这样能显著减少改错方向的概率。/btw解决的是上下文污染问题。你让 Claude 重构一个大模块干到一半突然想问那个测试文件在哪个目录直接问会把这句无关对话塞进历史AI 重新干活时可能跑偏。用/btw提问答案给你但不进对话历史。/rewind适合做实验让 AI 试一种新方案不行就回退代码但对话留着AI 还记得刚才聊了什么、知道这条路不通可以直接换方向不用重新解释需求。/simplify会同时启动三个并行 Agent分别从代码复用、代码质量、运行效率三个角度审查你的改动然后汇总。我现在的习惯是每写完几个大功能就顺手跑一遍AI 写的代码常有微妙冗余——多余的 import、重复逻辑、可以更简洁的写法它基本都能挑出来。/model切换模型时有个隐藏用法/model opusplan需要复杂推理时自动用 Opus 做规划然后切到 Sonnet 执行。规划和写代码对模型能力的要求不一样规划需要深度理解架构执行阶段 Sonnet 完全够用且更快这个模式能兼顾质量和成本。文件引用和 shell 命令是会话内的两个高频操作Review ./src/components/Button.tsx Analyze ./src/ and suggest improvements !npm test !git status精确引用文件比说找一下 auth 相关文件更省 token、更准确!前缀直接在会话里跑 shell 命令结果会进入上下文供 AI 判断。最后验证一下会话管理命令确认/continue和/resume能正确恢复历史claude --continue # 恢复最近一次会话 claude --resume # 列出历史会话供选择如果这两条能正常拉起之前的对话说明会话持久化没问题。到这里slash 命令、CLI flags、CLAUDE.md 三类指令都验证过一遍你的指令工作流基本成型了。5. 常见报错排查401、local proxy failed、reading choices指令敲对了但调用失败是新手最容易卡住的地方。下面按真实报错逐条对照。报错一401 UnauthorizedAPI Error: 401 {error:{message:invalid api key}}原因几乎都是 Key 不对。检查三件事ANTHROPIC_API_KEY是否写成了 TaoToken 的 Key不是官方 KeyKey 是否复制完整前后有没有多余空格Key 是否已过期或被删除。改完记得source一下 shell 配置或者重开终端。报错二local proxy failed / connection refusedError: connect ECONNREFUSED 127.0.0.1:xxxx local proxy failed这类报错说明请求被指向了本地某个端口通常是之前配置过本地代理残留。检查ANTHROPIC_BASE_URL是不是还指向http://127.0.0.1:xxxx把它改成https://taotoken.net/api。同时检查 shell 里有没有残留的HTTP_PROXY/HTTPS_PROXY变量有的话清掉。报错三reading choices / unexpected responseError: reading choices: unexpected end of JSON input这个报错一般是响应体不是预期的 JSON 格式常见原因是 Base URL 路径写错。比如写成了https://taotoken.net少了/api或者多写了斜杠。正确写法是https://taotoken.net/api注意结尾不要带/v1之类的多余路径除非文档明确要求。报错四OAuth / authentication failedOAuth error: authentication failed如果你之前登录过官方账号本地可能残留了 OAuth 凭证和 API Key 模式冲突。解决办法是清理~/.claude/下的凭证缓存改用 API Key 模式。具体清理哪个文件以你本地版本为准一般是credentials.json之类的文件。报错五model not foundError: model claude-xxx not foundModel ID 写错了。回到模型对话页面确认可用模型名然后在/model命令或 settings 里改成正确的。注意大小写和版本号后缀claude-sonnet-4-6和claude-sonnet-4.6可能不通用。排查时有个通用方法先用最小命令验证链路再逐步加复杂度。# 最小验证只测链路 claude -p 回复ok # 加系统提示验证 claude --append-system-prompt 用中文回复 -p 回复ok # 加文件引用验证 claude -p 总结 ./package.json 的内容哪一步开始报错问题就在那一层。链路层报错查 Base URL 和 Key调用层报错查 Model ID会话层报错查 CLAUDE.md 和 settings 路径。如果你用的是 Cline MCP 或 Codex 这类客户端配置逻辑一样但字段名不同。以 Codex 的auth.json为例需要写全三件套{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-6 }Cline MCP 的配置则在 MCP 设置里填 Base URL、Key、Model ID 三项。无论哪个客户端Base URL Key Model ID 三件套缺一不可这是排查所有接入问题的第一原则。6. 把指令工作流固定下来指令速查的意义不在于背下来而在于形成肌肉记忆后你能把注意力放回代码本身。我的做法是项目根目录放一份 CLAUDE.md 固化规范全局 settings 里配好 allow/deny 权限日常用/plan先规划、/simplify后审查、/compact控上下文遇到实验性改动用/rewind回退、/branch分叉。接入层则固定成三件套Base URL 指向https://taotoken.net/apiKey 从控制台获取Model ID 按实际可用模型填。这三项配好之后剩下的就是熟练度问题。如果你还没配好 Key可以去 API Keys 页面创建一个https://taotoken.net/api-keys 。想先确认有哪些模型可用去模型对话页面试一条https://taotoken.net/models 。长期做编码和 Agent 任务的话Coding Plan 会更划算https://taotoken.net/coding-plan 。接入文档在 https://taotoken.net/doc 遇到配置细节可以对照查。最后留一个我常用的别名Linux/macOS 下写进 shell 配置alias ccclaude --append-system-prompt 始终用中文回复Windows PowerShell 下function cc { claude --append-system-prompt 始终用中文回复 $args }这样每次敲cc就带着你的默认规则进会话省掉重复输入。指令工作流搭好之后你会发现 Claude Code 真正好用的地方是它能把想清楚和动手改这两件事串在一条终端流水线里。