AI 学习使用专栏 1 -- Claude code 安装及使用详细介绍：从 settings.json 到 TaoToken 统一 Key 配置

1. 刚装完 Claude Code 却卡在第一步模型从哪来、Key 往哪填Claude Code 是 Anthropic 推出的命令行 AI 编程工具能直接在终端里读代码、改文件、跑命令适合刚接触 AI 编程、又不想折腾复杂 IDE 插件的开发者。它的工作方式很像给终端配了一个懂代码的助手你在项目目录里敲claude它就能理解当前仓库结构按你的自然语言指令去改代码、补测试、解释报错。但很多人第一次装完就懵了。官方默认走 Anthropic 账号登录网络和账号门槛先不说光是「模型从哪来、Key 往哪填、settings.json 到底写什么」这三件事就足够劝退一批人。我见过不少朋友装完npm install -g anthropic-ai/claude-code之后敲claude直接报错或者进去之后发现没有可用模型卡在登录页反复重试。这篇就聚焦「初次安装到首次调用」这个闭环。核心思路是把 Claude Code 的模型通道统一接到 TaoToken 上用一个 Key 管住所有模型调用再通过settings.json把配置固化下来。这样你既不用来回切换账号也不用每次手动 export 环境变量。整篇会给出可直接复制的配置骨架、验证命令以及几个我实际踩过的坑。TaoToken 在这里扮演的角色是「统一 API 通道」它提供兼容 Anthropic 协议的接口地址Claude Code 只要把 base URL 指过去、填上它发的 Key就能正常发请求。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后到控制台拿 Key 即可。2. 前置准备Node 环境、Claude Code 安装与 TaoToken Key2.1 确认 Node 版本Claude Code 是 Node 写的 CLI对 Node 版本有要求。建议 Node 18 以上我本地用的是 20 LTS。先确认node -v npm -v如果版本太低去 Node 官网下 LTS 包重装或者用 nvm 切换。这一步别省Node 版本不对后面会报一堆莫名其妙的错。2.2 全局安装 Claude Codenpm install -g anthropic-ai/claude-code装完验证一下claude --version能打印版本号就说明 CLI 本身没问题。如果提示command not found多半是 npm 全局 bin 目录没进 PATH用npm config get prefix看下路径把它加到环境变量里。2.3 拿 TaoToken 的 Key打开 https://taotoken.net/api 进控制台后到 API Keys 页面创建一个新 Key。建议按用途命名比如claude-code-dev方便以后区分。创建完立刻复制保存页面刷新后通常不再完整显示。这里有个细节TaoToken 的 Key 是统一凭证同一个 Key 可以驱动 Claude Code也能用在其他兼容 Anthropic 协议的工具上。所以别到处建 Key一个项目一个就够。注意Key 属于敏感凭证不要写进会提交到 Git 的文件里。后面配置我会用环境变量引用的方式避免硬编码。3. 可复制的 settings.json 配置骨架Claude Code 的配置分两层全局配置在用户目录下的.claude/settings.json项目级配置在项目根目录的.claude/settings.json。初次上手建议先配全局让所有项目都能用。3.1 配置文件位置macOS / Linux~/.claude/settings.jsonWindowsC:\Users\你的用户名\.claude\settings.json如果.claude目录不存在手动建一个。3.2 配置骨架下面这份是我实测能跑通的骨架把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN用环境变量引用{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: ${TAOTOKEN_API_KEY}, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_SMALL_FAST_MODEL: claude-3-5-haiku-20241022 }, permissions: { allow: [], deny: [] } }几个字段说明一下。ANTHROPIC_BASE_URL是请求入口指向 TaoToken 的 API 地址注意这里不加任何 UTM 参数保持干净。ANTHROPIC_AUTH_TOKEN用${TAOTOKEN_API_KEY}这种占位写法实际值从系统环境变量读这样配置文件本身可以安全地放进 dotfiles 仓库。ANTHROPIC_MODEL是主模型负责复杂推理和代码生成ANTHROPIC_SMALL_FAST_MODEL是轻量模型用于补全、摘要这类快任务配一个便宜快速的能省不少额度。3.3 设置环境变量macOS / Linux写进~/.zshrc或~/.bashrcexport TAOTOKEN_API_KEYsk-你的实际KeyWindows PowerShellsetx TAOTOKEN_API_KEY sk-你的实际Key改完记得重开终端或者source ~/.zshrc让变量生效。验证一下echo $TAOTOKEN_API_KEY能打印出 Key 就对了。3.4 关于 .claude.json 的补充有些版本首次运行claude会提示需要确认或补充.claude.json。这个文件在用户目录下主要存一些运行时状态。如果报错提示缺少字段按提示补一行即可通常和 onboarding 状态有关。它和settings.json不是一回事settings.json管配置.claude.json管状态别混。4. 验证请求一条命令确认配置生效配置写完别急着进项目先用一条命令确认通道通了。4.1 直接发一条测试请求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-20250514, max_tokens: 64, messages: [ {role: user, content: 只回复两个字通了} ] }如果返回 JSON 里content字段有内容说明 Key 和通道都没问题。如果返回 401检查 Key 是否复制完整返回 404检查 base URL 有没有多写或少写路径。4.2 在 Claude Code 里验证进入任意一个项目目录敲claude进去之后输入/model应该能看到当前可用模型列表用上下键切换。再随便问一句「解释一下当前目录的结构」如果它能正常读文件并回答说明整条链路打通了。4.3 常用命令速查命令作用claude在当前目录启动交互会话/model查看并切换模型/help查看所有内置命令/clear清空当前会话上下文/exit退出会话这几个够你跑完第一轮了。/model那个尤其有用切换模型不用改配置文件临时试不同模型很方便。5. 本篇常见错排查5.1 报错command not found: claudenpm 全局 bin 没进 PATH。执行npm config get prefix把输出的路径拼上/bin加到 PATH 里。macOS 上常见的是/usr/local/bin或~/.npm-global/bin。5.2 报错401 Unauthorized三种可能Key 复制时带了空格环境变量没生效重开终端settings.json里写的是字面量${TAOTOKEN_API_KEY}但系统里没这个变量。逐个排查先echo $TAOTOKEN_API_KEY确认变量在。5.3 报错model not foundANTHROPIC_MODEL填的模型名不对。不同通道支持的模型名可能略有差异去 TaoToken 的模型列表页确认当前可用的准确名称别凭记忆写。5.4 配置改了不生效Claude Code 启动时读一次配置。改完settings.json要退出会话重进。另外注意项目级配置会覆盖全局配置如果你在项目里也建了.claude/settings.json检查一下是不是它把全局的盖掉了。5.5 请求超时先确认ANTHROPIC_BASE_URL写的是https://taotoken.net/api没有多余斜杠或路径。再检查本地网络是否能正常访问该域名。如果 curl 能通但 Claude Code 不通多半是配置文件格式问题用python -m json.tool ~/.claude/settings.json校验一下 JSON 合法性。6. 把 Key 和通道固定下来后面就顺了走到这里你应该已经完成了从安装到首次调用的完整闭环Node 环境就绪、Claude Code 装好、TaoToken 的 Key 拿到、settings.json配好、验证命令跑通。后面再开新项目只要环境变量在直接claude就能用不用重复配置。如果你主要做长期编码或者想跑 Agent 类任务建议到 Coding Plan 页面看看https://taotoken.net/api 里有对应的入口按用量规划比零散调用更划算。日常想快速试模型效果用模型对话页面就行。Key 管理和接入文档都在控制台和文档区遇到接入问题优先翻文档比到处问快。最后留一个我自己的习惯把settings.json和~/.zshrc里的 Key 导出一起放进 dotfiles 仓库换机器时 clone 下来、补一个环境变量就恢复全部配置。唯一要记住的是Key 本身永远不进仓库只留占位符。