1. Claude Code 日常开发里最容易卡住的三个地方Claude Code 是一个跑在终端里的 AI 编码助手能读项目文件、执行命令、改代码、跑测试适合已经习惯命令行、又想让 AI 深度参与工程的人。它和网页版对话最大的区别是它真的会动你的文件系统所以配置一旦不对要么连不上模型要么权限乱放要么每次都要重复交代项目背景。我把它日常使用拆成三条主线CLAUDE.md 负责项目记忆MCP 负责把外部工具接进来VS Code 负责把编辑器里的上下文喂给它。这三条线各自都有坑而且坑的位置很固定——大多集中在 settings.json、config.toml 和几个斜杠命令上。这篇按十五个技巧来写每个技巧都给出可复制的配置骨架和验证动作。模型通道部分统一走 TaoToken 的 Key/API这样你只需要维护一份凭证不用在多个供应商之间来回换环境变量。下面从接入配置开始一路写到 MCP 和排错。2. TaoToken 前置把 Key 和 API 通道准备好在动 Claude Code 之前先把通道打通。TaoToken 提供统一的 API 入口Claude Code 这类兼容 Anthropic 协议的工具可以直接把 base URL 指过来。你需要做两件事拿一个 API Key确认接入地址。打开 https://taotoken.net/api-keys 创建 Key复制出来先放一边。接入文档在 https://taotoken.net/doc 里面写了不同工具的填法遇到字段不确定时对着看。API 根地址是 https://taotoken.net/api 注意这个地址后面不加任何查询参数。注意Key 只显示一次创建后立刻保存到本地密码管理器或环境变量文件里不要直接写进会提交到 git 的配置。如果你只是先验证模型能不能通可以打开 https://taotoken.net/model-chat 发一条消息试试确认 Key 有效再往下配 Claude Code。长期跑编码任务、想让 Claude Code 持续读项目的话可以看 https://taotoken.net/coding-plan 按用量选合适的档位比每次临时试要省心。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是环境变量或 settings.json 决定它连哪个模型通道另一层是 config.toml 这类文件决定 MCP 和工具行为。先把最小可用骨架搭起来。3.1 settings.json 接入骨架在项目根目录或用户目录下建.claude/settings.json写入下面内容。把ANTHROPIC_AUTH_TOKEN换成你刚才拿到的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, API_TIMEOUT_MS: 600000 }, permissions: { allow: [ Read, Glob, Grep ], ask: [ Bash(git commit:*), Write ] } }这里allow里放的是只读类操作让它自己跑不用每次问ask里放写文件和提交动手前先确认。超时设成 600000 毫秒是因为大项目首次索引和长上下文推理会慢默认值容易中途断掉。3.2 config.toml 的 MCP 骨架MCP 的配置可以写在~/.claude/config.toml或项目级配置里。下面是一个接两个 MCP 服务的最小例子[mcp_servers.context7] command npx args [-y, upstash/context7-mcp] [mcp_servers.filesystem] command npx args [-y, modelcontextprotocol/server-filesystem, /Users/you/project]context7用来拉取库文档filesystem用来限定它能访问的目录范围。写完保存重启 Claude Code 让它重新加载。3.3 用环境变量做临时切换不想改文件时直接在 shell 里导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥这种方式适合临时验证验证通过后再固化进 settings.json。如果你之前用过 claude-code-router 那类工具做格式转换现在通道本身兼容 Anthropic 协议就不需要中间层了少一层就少一个出错点。4. 十五个技巧逐项验证配置搭好后按下面顺序逐条验证。每条都给动作和预期结果出问题直接跳到第 5 节对照。4.1 CLAUDE.md 项目记忆在项目根目录执行/init它会扫描代码结构并生成CLAUDE.md里面是项目概览、技术栈、目录说明。生成后手动补几条规则比如「所有新接口必须写单元测试」「不要改 migrations 目录」。之后每次会话它都会先读这个文件省去重复交代。全局规则放在~/.claude/CLAUDE.md按 1、2、3 罗列即可。4.2 会话恢复退出后想接着上次聊输入/resume会列出历史 session 让你选。适合跨天开发同一个模块时用上下文不用重建。4.3 终端主题输入/config选主题退出重进生效。这个纯观感但长时间盯着终端配色舒服能少点疲劳。4.4 代码回滚到检查点改坏了想退输入/rewind选一个检查点回退。它按会话里的改动点记录比手动 git 回滚更细。4.5 plan 模式先聊透再写连续按两次Shift Tab进入 plan 模式。这个模式下它只讨论方案不动代码适合需求还没想清楚时先把边界聊明白再切回执行。4.6 VS Code 联动在 VS Code 里装Claude Code for VS Code插件进入交互模式后输入/ide选 VS Code。之后你在编辑器里选中的代码Claude Code 能直接读到不用再复制粘贴。4.7 聊天中指定文件交互模式输入会弹出文件列表选中的文件作为上下文带进去。比用自然语言描述「那个 utils 文件」准确得多。4.8 权限设置输入/permissions进入权限管理选择保存到全局还是项目。命令权限和工具权限分开管项目级的写进项目配置跟着仓库走。4.9 临时执行终端命令交互模式里用!加命令比如!ls就是执行 ls。适合快速看一眼目录不用退出会话。4.10 压缩对话历史聊太久 token 涨得快输入/compact做压缩保留关键信息、丢掉冗余。长会话里定期压一次能明显降消耗。4.11 一次性提问不想进交互模式时用claude -p 你的问题执行完自动退出。比如claude -p go 语言如何用通道适合脚本里调用或快速查一个点。4.12 清理上下文/clear清掉当前上下文。有些临时会话不想留记录或者想换个干净状态重新开始用它。4.13 安装 MCP命令行加 MCPclaude mcp add context7 --scope user -- npx -y upstash/context7-mcp--scope user表示全局可用去掉就是项目级。加完用/mcp查看已接入的服务列表。4.14 验证 MCP 是否生效接入后问一个需要外部文档的问题比如「context7 里 react 的 useEffect 最新用法」如果它能引用到库文档说明 MCP 通了。没通就检查 config.toml 里的 command 和 args 路径。4.15 用 TaoToken 统一通道做最终验证所有配置就位后跑一次完整请求确认通道没问题claude -p 读取当前目录的 CLAUDE.md 并总结项目结构如果返回了项目结构总结说明 Key、base URL、CLAUDE.md 三者都正常。这一步是整个配置的收口验证。5. 本篇常见错排查配置报错大多集中在几个固定位置对照下面查。报 401 或认证失败先确认ANTHROPIC_AUTH_TOKEN没有多余空格Key 是否已过期。去 https://taotoken.net/api-keys 重新生成一个对比测试。base URL 必须是https://taotoken.net/api结尾不要带斜杠或路径。连接超时把API_TIMEOUT_MS调到 600000 以上。大项目首次索引慢是正常的别急着判定通道有问题。MCP 服务起不来检查npx是否在 PATH 里args里的包名拼写是否正确。用claude mcp list看状态失败的服务会标出来。filesystem 类 MCP 的目录参数必须是绝对路径。VS Code 联动失效确认插件已启用/ide里能选到 VS Code 窗口。如果同时开了多个编辑器窗口选错窗口会导致上下文对不上。CLAUDE.md 没被读取确认文件在项目根目录文件名大小写正确。全局规则在~/.claude/CLAUDE.md项目规则在项目根目录两个位置别搞混。权限反复弹窗把常用只读操作加进 settings.json 的allow数组写操作留在ask里。改完重启生效。6. 把通道和工具链固定下来十五个技巧里真正每天用到的其实就那几个CLAUDE.md 定规则、带文件、/compact省 token、MCP 拉文档、VS Code 联动喂上下文。其余的是在特定场景下救急。配置这件事我的建议是一次性把 settings.json 和 config.toml 写扎实之后就别频繁改。通道统一走 TaoToken 之后你只需要维护一个 Key换项目、换机器都是复制同一份骨架。需要长期跑编码任务的话去 https://taotoken.net/coding-plan 看合适的方案接入细节对着 https://taotoken.net/doc 核对字段验证模型通不通直接开 https://taotoken.net/model-chat 发一条。把这几步走完Claude Code 基本就能稳定陪你干活了。