1. 先搞清楚 Claude Code 到底能帮你做什么Claude Code 是 Anthropic 推出的命令行 AI 编程工具你可以把它理解成一个「住在终端里的结对程序员」。它跟 Cursor 那种图形化编辑器不一样Claude Code 直接跑在你的命令行里能读写项目文件、执行 shell 命令、跑 Python 脚本、搜索代码库甚至帮你操作浏览器和整理本地文件。适合谁用第一次接触命令行 AI 工具的新手、需要在服务器环境里写代码的后端同学、以及想把手动操作交给 AI 自动跑的测试和运维人员。我实测下来Claude Code 最舒服的地方是「对话即操作」你用大白话描述需求它自己决定读哪个文件、改哪一行、跑哪条命令。但它默认走的是 Anthropic 官方模型国内直连经常超时而且官方 Key 的获取和计费对新手不太友好。所以这篇教程分两条线走先把 Claude Code 在 Windows 和 macOS 上装起来跑通再通过 TaoToken 统一 Key 把模型接入配置好让你一次跑通不卡在环境上。整篇内容按「装 → 配 → 验 → 排错」的顺序来每一步都给可复制的命令和配置。你不需要提前懂 Node.js 或环境变量跟着敲就行。2. 装 Claude Code 之前先把 TaoToken 的 Key 准备好Claude Code 本身只是个客户端它需要连一个模型服务才能干活。官方默认连 Anthropic但国内网络环境下经常连不上而且新手拿官方 Key 要绑卡、要走海外流程门槛不低。TaoToken 在这里的角色就是「统一入口」你注册一个账号拿到一个 Key就能在 Claude Code 里调用多种模型包括 Claude 系列和国内主流模型切换模型只需要改一个配置文件。注册和拿 Key 的路径很直接打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 注册登录后进控制台在 API Keys 页面创建一个新 Key。这个 Key 就是你后面填进 settings.json 的东西格式一般是一串以特定前缀开头的字符串。创建完先复制存好页面关了就看不到了。注意Key 只显示一次建议先粘到本地记事本再继续。不要把它提交到 Git 仓库也不要贴在公开聊天里。TaoToken 的 API 地址是 https://taotoken.net/api 这个地址后面要写进 Claude Code 的环境变量里。如果你后面想换模型或者查用量可以进模型对话页面直接试如果是长期写代码、跑 Agent 任务建议了解下 Coding Plan按量或包月都行比每次单独买 Key 省心。控制台里还能看到每个 Key 的调用记录排错时很有用。3. Windows 和 macOS 命令行安装全流程3.1 先确认 Node.js 环境Claude Code 通过 npm 分发所以第一步是确认你机器上有 Node.js。打开终端Windows 用 PowerShell 或 CMDmacOS 用 Terminal输入node -v npm -v如果两条都输出版本号Node 建议 18 以上说明环境 OK跳到下一步。如果提示「不是内部或外部命令」说明没装 Node.js。去 Node.js 官网下载 LTS 版本一路下一步装完重开终端再试。macOS 用户如果装了 Homebrew也可以直接brew install node3.2 安装 Claude Code环境确认后用 npm 全局安装npm install -g anthropic-ai/claude-codeWindows 用户如果遇到权限报错用管理员身份打开 PowerShell 再跑一次。macOS 用户如果报 EACCES别急着加 sudo先按官方建议配一下 npm 全局目录或者用 nvm 管理 Node 版本能避开大部分权限坑。装完后验证claude --version看到版本号就说明安装成功了。这一步是整个流程里最容易卡住的地方如果报错先看第 5 节的排查清单。3.3 建一个干净的工作目录正式启动前建议单独建一个空文件夹比如叫cc-demo然后在终端里切进去mkdir cc-demo cd cc-demo这么做的好处是Claude Code 后续的读写和命令执行都局限在这个目录里不会误动你其他项目文件。新手尤其建议这么做安全感高很多。3.4 首次启动和初始化在cc-demo目录下输入claude第一次启动会进一个初始化界面问你主题偏好默认选 1 直接回车。接着是安全注意事项确认按回车继续。然后你就进到 Claude Code 的对话界面了可以直接用大白话输入需求比如「帮我写一个读取 CSV 并统计行数的 Python 脚本」。到这里Claude Code 已经能跑了但它连的还是默认模型。下一步我们把模型切到 TaoToken。4. 用 settings.json 把模型切到 TaoToken4.1 找到配置文件位置Claude Code 的配置分两层全局配置在用户目录下的.claude/settings.json项目级配置在项目根目录的.claude/settings.json。新手建议先用全局配置一次配好所有项目都能用。Windows 路径一般是C:\Users\你的用户名\.claude\settings.jsonmacOS 是~/.claude/settings.json。如果.claude目录不存在手动建一个。4.2 可复制的 settings.json 骨架把下面这段填进去把你的TaoToken密钥替换成第 2 步拿到的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-3-5-haiku-20241022 } }几个字段说明一下ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址这是让 Claude Code 不走官方直连的关键ANTHROPIC_AUTH_TOKEN填你的 KeyANTHROPIC_MODEL是主模型负责写代码和复杂推理ANTHROPIC_SMALL_FAST_MODEL是轻量模型负责补全和简单任务配一个便宜的能省不少额度。提示模型名称要跟你 TaoToken 账号里可用的模型对上。如果调用报「model not found」先去控制台或模型对话页面确认可用模型列表再回来改这个字段。4.3 模型切换的两种方式第一种是改配置文件就是上面这样改完重启 Claude Code 生效。第二种是临时切换启动时用环境变量覆盖ANTHROPIC_MODELclaude-3-5-haiku-20241022 claudemacOS 和 Linux 支持这种写法Windows PowerShell 用$env:ANTHROPIC_MODELclaude-3-5-haiku-20241022; claude如果你经常在多个模型之间切可以装个社区工具 CC Switch 来管理它提供图形界面切换模型、管理 MCP 和提示词对不习惯手改 JSON 的新手很友好。不过核心原理还是改上面那几个环境变量理解了就不怕工具换。5. 验证请求是否真的走通了配置改完别急着写代码先做一次最小验证。在cc-demo目录下启动claude进去后输入一句简单的话比如「你好请回复你当前使用的模型名称」。如果它能正常回复并且你在 TaoToken 控制台的调用记录里看到这次请求说明链路通了。再做一个文件操作验证输入帮我创建一个 hello.py内容是打印 Hello TaoTokenClaude Code 会请求写文件权限你确认后它会在当前目录生成hello.py。然后你手动跑一下python hello.py看到输出就说明读写和执行都正常。这一步能同时验证模型调用、文件权限和命令执行三个环节比单纯聊天更能说明问题。如果验证失败先看终端报错信息再对照下一节排查。6. 新手最常踩的五个坑和排查动作坑一claude命令找不到。说明 npm 全局 bin 目录没进 PATH。Windows 检查npm config get prefix输出的路径有没有加到系统环境变量macOS 检查~/.npm-global/bin或 nvm 的 bin 目录。改完 PATH 要重开终端。坑二401 或 invalid api key。九成是 Key 复制时带了空格或者 settings.json 里字段名写错。检查ANTHROPIC_AUTH_TOKEN拼写确认 Key 前后没有多余空格和换行。改完重启 Claude Code。坑三连接超时或 connection refused。检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api注意结尾不要多加斜杠。如果还是超时去 TaoToken 控制台确认账号状态和额度是否正常。坑四model not found。你填的模型名在 TaoToken 侧不存在或没开通。去模型对话页面确认可用模型把ANTHROPIC_MODEL改成列表里有的名字。坑五每次执行命令都弹确认很烦。这是 Claude Code 的安全机制。想跳过可以用claude --dangerously-skip-permissions启动首次会让你确认一次。但这个模式会放开所有命令执行权限只建议在隔离的测试目录里用别在存有重要文件的主目录下开。排查时有个通用技巧把终端完整报错复制给任意 AI 对话工具让它一步步教你定位比你自己猜快得多。TaoToken 的接入文档里也有针对 Claude Code 的配置示例遇到字段不确定可以直接对照。7. 接下来怎么用得更顺装好只是起点。日常用 Claude Code建议养成两个习惯一是每个项目单独建目录再启动避免它跨项目乱翻文件二是把常用的模型配置写进项目级.claude/settings.json团队协作时别人拉下来就能用。如果你打算长期用它写代码或跑自动化任务去 TaoToken 控制台看看 Coding Plan 的额度方案比零散调用更划算。想先试试不同模型的手感直接进模型对话页面切换着聊几句找到顺手的再写进配置。API Keys 页面可以随时新建和吊销 Key换机器或者 Key 泄露时用得上。这套流程我在 Windows 和 macOS 上都跑过最容易出问题的就是 PATH 和 Key 格式这两处把第 6 节的清单存下来下次换机器十分钟就能重新配好。