1. 为什么你的 Claude Code 越用越不顺手很多人把 Claude Code 装好、API 通道配通之后就停在“能用”这一步了。用一阵子你会发现三个特别典型的问题它怎么把我文件改坏了、它怎么用着用着变笨了、它对每个人都一样怎么让它懂我。这三个问题其实都指向同一件事——你还没把settings和记忆体系改到位。这篇是零基础实战教程的第三部分专门讲 Claude Code 的深度使用与进阶技巧。核心检索词就是 Claude Code 进阶配置我会围绕settings.json文件与 API 通道的对接展开给你可复制的配置片段和逐步验证动作帮你确认 Claude Code 能正常发起请求并排查常见报错。目标很明确从零跑通一条稳定的 AI Coding 工作流。先说清楚适合谁看。如果你已经完成了前两部分——装好了 Node.js、Git、VS Code也把 Claude Code 装上并配好了基础 API——那这篇就是给你准备的。如果你还没配通 API也没关系第二节我会把前置动作再走一遍确保你手里有一个能用的 Key 和 Base URL。我自己的习惯是模型能力是地板配置质量才是天花板。花时间把配置做好比追最新模型版本更有实际收益。这句话你会在后面反复体会到。Claude Code 的能力可以按 7 层扩展来理解CLAUDE.md 是项目说明书每次会话自动加载Hooks 是事件触发器Skills 是专业知识包Plugins 把前几者打包分发LSP 给 AI 装上 IDE 级代码导航MCP 连接外部工具和数据源子 Agent 独立上下文并行干活。前 3 层是基础配置后 4 层是高级扩展。本篇重点落在前 3 层尤其是settings.json和记忆体系。2. TaoToken 前置把 API 通道和 Key 准备好在动settings.json之前你得先有一个能用的 API 通道。Claude Code 默认走 Anthropic 官方接口但很多零基础读者会遇到网络、计费、模型选择的问题。这里我用 TaoToken 作为统一入口来演示因为它把模型对话、Coding Plan、控制台、API Keys 都放在一个地方配置起来路径清晰。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台 https://taotoken.net/console 在左侧找到 API Keys 页面 https://taotoken.net/api-keys 点“创建新的 API Key”。创建完一定要立刻复制因为很多平台只显示一次。这个 Key 就是你后面要写进环境变量或settings.json的凭证。第二步确认你的 Base URL。TaoToken 的 API 地址是 https://taotoken.net/api 注意这个地址不带任何查询参数。Claude Code 通过ANTHROPIC_BASE_URL环境变量来识别接口地址所以你要把它设成这个值。如果你用的是 Claude Code 的 Anthropic 兼容模式Base URL 就填这个如果你走的是 OpenAI 兼容的客户端路径可能略有不同以接入文档 https://taotoken.net/doc 为准。第三步选模型。TaoToken 的模型对话页面 https://taotoken.net/models 可以让你先在线试一下模型是否可用。对于 Claude Code 日常编码我建议先用 Sonnet 级别的模型速度快、质量稳、成本适中。遇到复杂架构或疑难 Bug 再切 Opus。Haiku 适合大批量简单任务比如格式化、小修改。你可以在模型对话里发一句“用 Python 写一个快速排序”看返回是否正常确认通道通了再往下走。这里有个关键点Claude Code 读取的是环境变量不是你在网页上选的模型。所以网页测试只是确认 Key 和通道没问题真正生效的是你本地的配置。第四步把 Key 和 Base URL 记在一个安全的地方别直接提交到 Git。后面我会教你怎么用.gitignore和settings.local.json把它隔离好。如果你打算长期用 Claude Code 做编码和 Agent 任务可以看一下 Coding Plan https://taotoken.net/coding-plan 它更适合高频调用场景。但零基础阶段先用按量计费的 API Key 跑通流程就够了别一上来就买套餐。3. 可复制配置settings.json 与三层记忆体系这一节是全文的核心我会给你可以直接复制的配置片段。Claude Code 的配置分好几层从全局到项目级层层覆盖。先记住三个位置全局配置在~/.claude/settings.json影响所有项目项目级配置在项目根目录的.claude/settings.json只影响当前项目可以提交 Git 给团队共享个人私有配置在.claude/settings.local.json不提交 Git优先级最高。先看最基础的settings.json。这个文件控制权限、默认模型、自动压缩阈值等。下面这段可以直接复制路径是~/.claude/settings.json{ permissions: { allow: [ Read, Glob, Grep, Edit, MultiEdit, Write(src/**), Write(tests/**), Bash(npm *), Bash(pnpm *), Bash(git status), Bash(git diff *), Bash(git log *), Bash(git add *), Bash(git commit *) ], deny: [ Read(**/.env*), Read(**/*.pem), Read(**/*.key), Write(**/.env*), Bash(rm -rf *), Bash(sudo *), Bash(git push *), Bash(git rebase *) ], defaultMode: acceptEdits }, model: sonnet, autoCompactThreshold: 80 }allow是白名单日常安全操作不该每次都问你deny是黑名单安全红线自动封堵。defaultMode设成acceptEdits表示文件编辑自动接受但危险命令仍然会拦。如果你更谨慎可以把它改成default让每次操作都确认。model字段设默认模型autoCompactThreshold设成 80 表示上下文用到 80% 时自动压缩。注意allow要按你的工具链改。用 yarn 就加Bash(yarn *)用 bun 就加Bash(bun *)。deny那几行建议原样留着它们是安全底线。权限设置要谨慎过于宽松的权限可能导致 AI 执行你不期望的操作。初学者建议先保持默认让自己有机会审查每一步。接下来是 API 通道的对接。Claude Code 通过环境变量读取 Base URL 和 Key。你可以在 shell 配置文件里写比如 macOS 的~/.zshrc或 Linux 的~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的_TaoToken_API_Key export ANTHROPIC_MODELsonnetWindows PowerShell 用户可以在系统环境变量里设置或者用$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api临时设置。设完记得重启终端让环境变量生效。验证方式是echo $ANTHROPIC_BASE_URLmacOS/Linux或echo $env:ANTHROPIC_BASE_URLPowerShell看输出是不是你设的值。如果你不想用环境变量也可以在settings.json里配。但 Key 写在settings.json里有泄露风险所以更推荐放在settings.local.json并且确保它被.gitignore忽略。下面是一个settings.local.json的示例路径是项目根目录的.claude/settings.local.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的_TaoToken_API_Key, ANTHROPIC_MODEL: sonnet } }然后是三层记忆体系。第一层是 CLAUDE.md你主动写会话启动时全量加载。它分三级全局级~/.claude/CLAUDE.md写个人习惯比如“永远用中文回答”项目级在项目根目录CLAUDE.md写技术栈、架构、规范、进度可以提交 Git文件夹级在子目录CLAUDE.md写模块专属约定。三层叠加生效优先级是文件夹级 项目级 全局级。一个项目级 CLAUDE.md 模板可以直接复制修改# 项目名称 ## 项目概述 一句话描述这个项目做什么。 ## 技术栈 - 前端Next.js 14 TypeScript Tailwind CSS - 后端Next.js API Routes - 数据库Prisma SQLite ## 编码规范 - 使用函数式组件 React Hooks - 组件文件使用 PascalCase 命名 - API 路由返回统一格式{ success: boolean, data?: any, error?: string } ## 当前开发状态 - 项目初始化完成 - 书签 CRUD API 开发中 - 前端页面待开发 ## 注意事项 - 不要修改 prisma/migrations/ 目录 - 环境变量在 .env 文件中不要提交到 Git第二层是 Auto Memorycc 自己记的笔记。在会话里输入/memory选“启用 Auto Memory”。它会记录你的偏好、反馈、项目决策只在当前项目生效按需读取占 token 很少。第三层是自建参考文档仿照 Skill 的渐进式披露机制。比如品牌视觉规范放docs/brand-visual.md然后在 CLAUDE.md 里加指引“修改前端视觉时必读 docs/brand-visual.md”。这样 cc 只在需要时才读完整文档不占多余上下文。最后是.claudeignore类似.gitignore告诉 Claude Code 哪些文件不用关注node_modules/ .next/ dist/ *.log .env配完这些你的 Claude Code 就有了一个稳定的配置底座。下一节我们来验证它到底能不能正常发起请求。4. 验证请求从启动到成功返回的完整动作配置写完不代表生效必须验证。这一节我给你一套逐步验证动作从启动 Claude Code 到确认请求成功返回每一步都有预期结果。第一步确认环境变量生效。打开终端运行echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY预期输出是你的 TaoToken Base URL 和 Key。如果输出为空说明环境变量没生效检查你是不是写在了正确的 shell 配置文件里或者有没有重启终端。Windows PowerShell 用echo $env:ANTHROPIC_BASE_URL。第二步直接用 curl 测试 API 通道。这一步能排除 Claude Code 本身的干扰确认 Key 和 Base URL 是通的curl https://taotoken.net/api/v1/messages \ -H x-api-key: 你的_TaoToken_API_Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-6, max_tokens: 100, messages: [{role: user, content: 说一句你好}] }预期返回是一段 JSON里面有content字段内容是模型回复的“你好”之类。如果返回 401说明 Key 错了如果返回连接超时说明 Base URL 或网络有问题。这一步过了说明通道没问题。第三步启动 Claude Code。在项目目录下运行claude预期进入交互式界面底部显示当前模型和上下文余量。如果启动时报Invalid API Key回到第二步检查 Key。如果报local proxy failed说明 Base URL 配错了或者本地有代理干扰检查ANTHROPIC_BASE_URL是不是https://taotoken.net/api。第四步发一个最小请求。在 Claude Code 里输入请用一句话介绍你自己不要调用任何工具。预期它返回一句自我介绍并且不触发文件读写。如果它开始读文件或执行命令说明你的权限配置太宽松或者提示词触发了工具调用。这一步成功说明 Claude Code 能正常发起请求并拿到回复。第五步测试文件操作。输入请创建一个 hello.txt内容是一行 Hello AI Coding。预期它请求确认创建文件你按 Enter 确认后文件出现在当前目录。用cat hello.txt验证内容。这一步成功说明权限配置和文件操作都正常。第六步测试上下文压缩。输入/context看上下文占比。如果超过 60%输入/compact预期它把历史压缩成摘要腾出空间。这一步是解决“用久了变笨”的核心武器。第七步测试模型切换。输入/model看当前模型然后输入/model opus切换。预期状态栏模型名变化。再切回/model sonnet。这一步确认模型切换生效。走完这七步你的 Claude Code 就算真正跑通了。如果哪一步失败下一节我列了常见报错和排查方法。5. 常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易卡在几个报错上。这一节我按真实报错来对照给你排查路径。每个报错都对应一个具体原因别慌按顺序查。第一个401 Unauthorized。这个最常见意思是 Key 无效或没带上。排查顺序先确认ANTHROPIC_API_KEY环境变量有没有值用echo验证再确认 Key 有没有复制完整有没有多余空格然后确认 Key 有没有过期或被删除去控制台 https://taotoken.net/api-keys 看一眼最后确认请求头字段对不对Anthropic 兼容接口用x-api-key不是Authorization: Bearer。如果 curl 测试也 401那一定是 Key 问题重新创建一个。第二个local proxy failed。这个报错通常出现在 Claude Code 启动或请求时意思是本地代理连接失败。排查顺序先确认ANTHROPIC_BASE_URL是不是https://taotoken.net/api有没有多写路径或参数再确认本地有没有残留的代理环境变量比如HTTP_PROXY、HTTPS_PROXY如果有就临时 unset 掉然后确认网络能访问 TaoToken用curl -I https://taotoken.net/api看返回最后确认 Claude Code 版本是不是太旧升级到最新版。这个报错九成是 Base URL 写错或本地代理干扰。第三个reading choices 相关报错。这个通常出现在 OpenAI 兼容客户端里报错信息类似reading choices或Cannot read properties of undefined (reading choices)。原因是客户端期望 OpenAI 格式的响应但接口返回的是 Anthropic 格式或者反过来。排查顺序确认你用的客户端是 Anthropic 兼容还是 OpenAI 兼容如果是 Claude Code它走 Anthropic 格式Base URL 用https://taotoken.net/api如果是其他客户端走 OpenAI 格式路径可能是https://taotoken.net/api/v1具体以接入文档 https://taotoken.net/doc 为准确认模型名写对了别用了一个不存在的模型 ID。这个报错本质是格式不匹配不是 Key 问题。第四个OAuth 相关报错。如果你用的是 Claude 官方订阅登录可能会遇到 OAuth 流程失败。排查顺序确认你是用/login走官方订阅还是用 API Key如果用 API Key就不该走 OAuth检查有没有残留的登录态如果确实要用官方订阅确认账号有 Pro/Max 会员OAuth 失败时清掉~/.claude下的登录缓存再试。零基础阶段我建议直接用 API Key别碰 OAuth少一层复杂度。除了这四个还有几个高频问题。Rate limit exceeded是请求太频繁等一分钟再试或者升级套餐。ENOENT: no such file or directory是 npm 缓存损坏运行npm cache clean --force重装。claude 命令找不到是全局安装路径没进 PATH运行npm config get prefix把输出路径加进系统 PATH。Windows 报“禁止运行脚本”是 PowerShell 执行策略限制管理员身份运行Set-ExecutionPolicy RemoteSigned。排查的核心心法先隔离变量。用 curl 测通道排除 Claude Code 干扰用环境变量测 Key排除配置文件干扰用最小请求测模型排除提示词干扰。一层层剥问题一定定位得到。6. 把配置变成习惯长期稳定的 AI Coding 工作流配置跑通只是开始真正让 Claude Code 顺手的是把几个动作变成肌肉记忆。这一节我分享几个实测下来最有用的习惯帮你把 AI Coding 工作流稳定下来。第一个习惯改之前先存档。Git 就是你的游戏存档系统。让 AI 做大修改之前先git add . git commit -m 存档。改坏了就git checkout .回退。我踩过的坑就是没 commit 就让 AI 大改结果改坏了无法回退。记住这句话改之前先存档。Claude Code 有不确定性同一个需求问两次可能得到不同实现这不是 bug 是特性有 Git 兜底你才能安心让它尝试。第二个习惯上下文高于 60% 就/compact。别等到接近满载、cc 自动压缩才动手那时候它已经开始遗忘了。先用/context看占比看到哪个 MCP 或 Skill 吃 token 多再决定压缩还是清理。宁可多/clear几次重新介绍背景也不要一直聊一直聊。每个/clear都是给 AI 一次重新聚焦的机会。第三个习惯复杂任务从 Plan Mode 起手。按两次ShiftTab进入 Plan Mode或者输入/plan。在 Plan Mode 下 AI 只能读、搜、分析不能改文件、不能跑命令。先让它探索和出方案你审核满意后再切出来执行。一句话准则如果你能用一句话说清期望的 diff就不用规划如果你说不清就先规划。Windows 某些终端ShiftTab跳不到 Plan Mode用AltM。第四个习惯每被坑一次就更新 CLAUDE.md。最有生产力的一句话是“更新 CLAUDE.md让这件事不再发生”。三个月下来这个文件就是你这个项目 Claude 犯过的所有错误的预防清单。同时每 3-6 个月审查一次配置问三个问题这条还需要吗现在有更好的写法吗这条是在弥补哪代模型的缺陷第五个习惯用 Skills 把检查清单变成命令。把上线前的心理检查清单写成.claude/skills/review/SKILL.md以后敲个/review就按你的规矩跑完。写一次以后每次都是它替你查。常用的还有/commit、/deploy-check、/test、/security。第六个习惯大型代码库从子目录启动。在 monorepo 里别从仓库根目录启动 Claude进入你要改的子目录再启动工作范围被精准限定。每个子目录放一份小 CLAUDE.md写明该目录专用的测试和 lint 命令。最后如果你要长期做编码和 Agent 任务可以了解 Coding Plan https://taotoken.net/coding-plan 它更适合高频场景。日常验证模型是否可用用模型对话 https://taotoken.net/models 快速试。需要管理 Key 就去 API Keys https://taotoken.net/api-keys 遇到配置问题查接入文档 https://taotoken.net/doc 。把这些入口存进书签下次配置就不用到处找了。配置这件事做一次受益很久。你现在花半小时把settings.json和 CLAUDE.md 改到位后面每个项目都能直接复用。模型会更新但一套好的配置习惯不会过时。