1. 为什么小白第一次装 Claude Code 总会卡在环境变量Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接在命令行里读写项目文件、跑测试、改 bug适合想用自然语言驱动开发的程序员。但它不像普通 npm 包那样装完就能用第一次接触的人最容易卡在三个地方Node.js 版本不对、git 没装导致部分功能报错、以及最关键的 API 通道没配好。我见过太多人npm install -g跑完输入claude回车结果要么提示找不到命令要么连上后一直转圈最后报鉴权失败。前者是全局安装路径没进 PATH后者是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN没配对。这篇教程面向完全没碰过 Claude Code 的开发者从 Windows 和 macOS 两条线走一遍装 Node.js、装 git、装 CLI、写 settings.json、配环境变量、最后用一条真实请求验证通道是否打通。统一 Key 和 API 通道这块我用的是 TaoToken 的接入方式官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。下面所有配置片段你都可以直接复制把 Key 换成自己的就行。2. 前置准备Node.js、git 与 TaoToken Key2.1 装 Node.js版本必须 ≥ 18Claude Code 依赖 Node.js 运行时版本低于 18 会在启动时直接报错。Windows 和 macOS 都去 https://nodejs.org 下载 LTS 版本安装时一路默认即可。装完打开终端验证node --version npm --version正常会输出类似v20.11.0和10.2.4。如果提示command not found说明安装没进 PATHWindows 重新跑一遍安装包勾选 Add to PATHmacOS 检查是否装到了/usr/local/bin。2.2 装 gitgit 不是 Claude Code 启动的硬性依赖但它的文件 diff、版本对比、部分工具调用会用到。Windows 去 https://git-scm.com/install/windows 下载安装包macOS 直接brew install git或去官网下 pkg。验证git --version2.3 拿 TaoToken 统一 Key打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来先存到记事本。这个 Key 就是后面ANTHROPIC_AUTH_TOKEN的值。注意不要把它提交到任何公开仓库。TaoToken 的 API 基地址统一用https://taotoken.net/api这个地址填到ANTHROPIC_BASE_URLClaude Code 的所有请求都会走这条通道。3. 安装 Claude Code CLI 并写入 settings.json3.1 全局安装 CLIWindows 打开 PowerShell 或 CMDmacOS 打开终端运行npm install -g anthropic-ai/claude-code2.1.31指定版本号是为了避免最新版偶发的兼容问题。装完验证claude --version能打印出版本号就说明 CLI 本身没问题。如果报claude: command not found是 npm 全局 bin 目录没进 PATHWindows 可以运行npm config get prefix看路径手动加进环境变量。3.2 Windows写 settings.json在C:\Users\你的用户名\.claude\目录下创建settings.json目录不存在就手动建。内容如下{ env: { ANTHROPIC_AUTH_TOKEN: 替换为你的TaoToken API Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, CLAUDE_CODE_MAX_OUTPUT_TOKENS: 12000 }, permissions: { allow: [], deny: [] } }三个字段的作用ANTHROPIC_AUTH_TOKEN是鉴权凭证ANTHROPIC_BASE_URL指向 TaoToken 通道CLAUDE_CODE_MAX_OUTPUT_TOKENS控制单次输出上限12000 对大多数场景够用。3.3 Windows配环境变量双保险settings.json 有时会被某些启动方式忽略所以再配一份系统环境变量。新建一个setup_claude_env.bat内容echo off echo echo Claude Code Environment Setup echo echo. set /p API_KEYPlease enter your API Key: if %API_KEY% ( echo Error: API Key cannot be empty! pause exit /b 1 ) echo. echo Setting environment variables... setx ANTHROPIC_AUTH_TOKEN %API_KEY% setx ANTHROPIC_BASE_URL https://taotoken.net/api setx CLAUDE_CODE_MAX_OUTPUT_TOKENS 12000 echo. echo Setup Complete! Please restart your terminal. pause双击运行粘贴 Key 回车即可。setx写入的是用户级永久变量重启终端后生效。3.4 macOS写 settings.json 或 shell 配置macOS 推荐先写 settings.jsonmkdir -p ~/.claude cat ~/.claude/settings.json EOF { env: { ANTHROPIC_AUTH_TOKEN: 替换为你的TaoToken API Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, CLAUDE_CODE_MAX_OUTPUT_TOKENS: 12000 }, permissions: { allow: [], deny: [] } } EOF如果发现不生效再往 shell 配置里追加。zsh 用户echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc echo export ANTHROPIC_AUTH_TOKEN替换为你的TaoToken API Key ~/.zshrc echo export CLAUDE_CODE_MAX_OUTPUT_TOKENS12000 ~/.zshrc source ~/.zshrcbash 用户把~/.zshrc换成~/.bash_profile即可。4. 验证请求确认通道真的打通了4.1 先查环境变量是否读到Windows PowerShellecho $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKENmacOS / Linuxecho $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN能打印出https://taotoken.net/api和你的 Key 就说明变量生效。如果为空说明终端没重启或配置文件路径写错。4.2 发起一次真实对话进入任意项目目录运行claude首次启动会进入交互界面。直接输入一句测试帮我解释一下当前目录下 package.json 的作用如果配置正确Claude Code 会读取文件并返回解释。这一步能返回内容说明 Key、Base URL、网络通道三者全部正常。4.3 用 curl 单独验证 API 通道如果 Claude Code 里报鉴权错误可以先用 curl 排除是 CLI 问题还是通道问题curl https://taotoken.net/api/v1/messages \ -H x-api-key: 你的TaoToken Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 100, messages: [{role: user, content: ping}] }返回 JSON 里带content字段就说明通道没问题问题出在 CLI 配置层。5. 本篇常见报错排查5.1claude: command not foundnpm 全局 bin 没进 PATH。Windows 运行npm config get prefix把输出路径加进系统环境变量 Path。macOS 检查npm bin -g的输出是否在$PATH里。5.2 启动后一直转圈或报401 Unauthorized九成是 Key 或 Base URL 写错。检查 settings.json 里ANTHROPIC_BASE_URL是不是https://taotoken.net/api注意不要多写/v1Claude Code 会自己拼路径。Key 前后不要有空格。5.3settings.json改了不生效Claude Code 读取的是用户目录下的.claude/settings.json不是项目目录。Windows 路径是C:\Users\用户名\.claude\settings.jsonmacOS 是~/.claude/settings.json。改完要完全退出终端再重开。5.4 Node.js 版本过低报错运行node --version如果低于 18去官网下最新 LTS 覆盖安装。装完node -v确认版本号变了再重装 CLI。5.5 git 相关功能报错部分工具调用依赖 git如果报git not found装完 git 后重启终端。Windows 装 git 时选 Git from the command line 选项。6. 后续接入与进阶入口通道打通后你可以把同一套 Key 接到更多工具里。VS Code 装 Claude Code 插件后不用额外配置只要终端里claude能用插件就能用。Cherry Studio 里供应商选 AnthropicAPI 地址填https://taotoken.net/api再手动添加模型即可。如果你打算长期用 Claude Code 做编码和 Agent 任务建议看一下 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先在网页里试模型效果直接开模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 管理和新建入口在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档里有各工具的完整配置示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句settings.json 里的 Key 不要截图发群也不要提交到 git 仓库泄露了直接去控制台吊销重建。
