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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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.json,macOS/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填你刚创建的 Key;ANTHROPIC_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 骨架就能开工。