1. 终端里跑通 Claude Code从 CLAUDE.md 到斜杠命令的完整路径Claude Code 是 Anthropic 推出的终端 AI 编码助手它直接住在你的命令行里能读项目文件、改代码、跑命令、生成提交信息。和网页版对话不同它的核心优势是“项目感知”——只要项目根目录有一份 CLAUDE.md它每次启动都会先读这份文件相当于给 AI 同事一本随身的项目手册。斜杠命令则是你在会话里控制它的方向盘/init生成记忆、/compact压缩上下文、/clear重置对话、/model切换模型、/cost看花费。这套组合适合谁适合已经在终端里写代码、希望把重复的读代码/改代码/写提交交给 AI 的开发者尤其是接手陌生仓库、需要快速摸清结构的人。这篇教程按“先配通道、再写记忆、后跑命令”的顺序展开每一步都能直接复制执行。2. 用 TaoToken 统一 Key 与 API 通道Claude Code 默认走 Anthropic 官方通道但很多人在国内环境里会遇到连通性和计费管理的问题。我试过用 TaoToken 作为统一的 Key/API 通道来接入好处是 Key 集中管理、模型调用走同一个入口切换模型时不用改一堆环境变量。TaoToken 的 API 地址是https://taotoken.net/api官网入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。你需要先拿到一个 API Key。登录后进入控制台在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面会写进 Claude Code 的 settings.json作为ANTHROPIC_AUTH_TOKEN的值。注意 Key 只在创建时完整显示一次丢了就重新生成。提示Key 属于敏感凭据不要提交进 Git 仓库。建议放在用户级配置文件里而不是项目级文件。如果你打算长期在多个项目里用 Claude Code可以顺手看一下 Coding Plan 的额度说明避免按量计费时 token 飙升。模型对话入口可以用来单独验证某个模型是否可用接入文档则列出了完整的参数和环境变量清单。3. 可复制的 settings.json 与 CLAUDE.md 骨架3.1 配置 settings.json 接入通道Claude Code 读取配置的位置通常在用户目录下的.claude/settings.json。Windows 路径类似C:\Users\你的用户名\.claude\settings.jsonmacOS/Linux 是~/.claude/settings.json。如果文件不存在就新建一个写入下面的内容{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }三个字段的作用分别是ANTHROPIC_BASE_URL指定请求走 TaoToken 的 API 入口ANTHROPIC_AUTH_TOKEN填你刚创建的 KeyANTHROPIC_MODEL指定默认模型可以先填 Sonnet 系列后面用/model动态切换。保存后重启终端里的 Claude Code配置才会生效。3.2 写一份能用的 CLAUDE.md 骨架CLAUDE.md 是项目记忆文件放在项目根目录。你可以手动创建也可以用/init让 Claude 扫描代码库自动生成再手动补充。下面是一份可以直接改的骨架# 项目名称 ## 项目简介 一句话说明这个项目做什么、面向谁。 ## 技术栈 - 语言TypeScript / Python / Go - 框架React / FastAPI / Gin - 包管理pnpm / uv / go mod - 测试Vitest / pytest ## 目录结构 - src/ 核心源码 - src/api/ 接口层 - src/models/ 数据模型 - tests/ 测试用例 ## 代码规范 - 缩进 2 空格使用单引号 - 函数命名用 camelCase常量用 UPPER_SNAKE_CASE - 提交信息遵循 Conventional Commits ## 常用命令 - 安装依赖pnpm install - 启动开发pnpm dev - 跑测试pnpm test - 构建pnpm build ## 注意事项 - 不要修改 generated/ 目录下的文件 - 数据库迁移文件放在 migrations/命名带时间戳 - 新增接口必须补测试这份骨架覆盖了 Claude 最需要知道的四类信息项目是什么、用什么技术、代码怎么组织、有哪些规矩。写完之后每次在该目录启动 Claude Code它都会先读这份文件回答和改代码时就会贴合你的项目习惯而不是给通用模板。4. 验证请求跑通第一个斜杠命令配置写好后进入项目目录在终端输入claude启动。第一次启动会看到欢迎界面和当前工作目录。先执行/status确认环境/status输出里会显示工作目录、当前模型、加载的记忆文件路径。如果ANTHROPIC_BASE_URL生效模型调用会走 TaoToken 通道如果显示未登录或凭据无效回到 settings.json 检查 Key 是否填对、有没有多余空格。接着执行/init让 Claude 扫描项目并生成 CLAUDE.md/init它会读取目录结构、主要模块、依赖列表在根目录写出 CLAUDE.md。生成后你可以用/memory打开编辑补充业务术语和团队约定。改完保存再执行/clear清空对话然后问一句“这个项目的入口文件在哪”看它是否能基于 CLAUDE.md 准确回答。能答对说明记忆文件加载成功。再验证模型切换和费用统计/model opus /cost/model opus会切到能力更强的模型适合复杂重构/cost显示当前会话的 token 用量和预估费用。如果/cost报错或显示为零通常是通道配置没生效回到第 5 节排查。5. 本篇常见错排查5.1 启动后提示凭据无效最常见的原因是 settings.json 里的 Key 写错或过期。先确认ANTHROPIC_AUTH_TOKEN的值是完整的sk-开头字符串没有换行和空格。然后检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api注意结尾不要多加斜杠。改完保存后必须重启 Claude Code环境变量不会热加载。5.2 /init 没有生成 CLAUDE.md/init依赖当前工作目录有可读的代码文件。如果你在一个空目录里执行它没有内容可扫描自然不会生成。先用/add-dir 你的工作目录把目标目录加进来或者直接在项目根目录启动 Claude Code。另外确认当前用户对目录有写权限否则文件创建会静默失败。5.3 对话变长后回答开始跑偏这是上下文累积导致的。用/compact 保留当前任务相关讨论压缩历史让 Claude 保留重点、丢弃冗余。如果任务已经切换直接用/clear重置比压缩更干净。养成习惯完成一个独立模块就/clear一次避免旧话题干扰新需求。5.4 /model 切换后没反应部分模型代号需要通道支持。如果/model opus之后请求报错先用/status看当前模型名是否真的变了。没变的话检查 settings.json 里的ANTHROPIC_MODEL是否被写死成了某个固定值某些版本会优先读环境变量。可以临时删掉这一行让/model命令接管。5.5 工具调用失败读不到文件执行/doctor做环境健康检查。它会验证 git、ripgrep 等依赖是否安装以及文件权限是否足够。常见问题是 ripgrep 没装导致 Claude 无法搜索代码库。按/doctor的报告逐项修复再重试之前的操作。6. 把命令串成工作流单个命令解决单点问题串起来才是完整工作流。接手新项目时我的顺序是/init生成记忆 → 问“总结这个项目”摸清结构 →/model opus切强模型做架构规划 → 写代码 →/compact压缩上下文 →/clear切换模块 → 最后用!前缀执行 git 命令提交。!是终端模式输入!git status会直接执行命令结果进入对话上下文不用另开窗口。#是记忆模式输入# 这个项目用 pnpm 不用 npm会把这句话写进 CLAUDE.md成为长期记忆。这套流程跑顺之后终端就不再只是敲命令的地方而是一个能记住项目、能切换模型、能控制成本的 AI 编码助手。配置一次后面每个项目复制一份 CLAUDE.md 骨架就能开工。