1. 为什么小白装 Claude Code 总卡在第一步Claude Code 是 Anthropic 推出的命令行 AI 编程助手简单说就是一个住在你终端里的 AI 程序员。你在终端里敲一句话它能帮你写代码、调试排错、读取和编辑本地文件、解释技术概念。对刚接触命令行的人来说它最大的价值是不用打开 IDE、不用切浏览器直接在黑框里把活干了。但我在帮朋友装的时候发现零基础用户卡住的地方高度集中基本就三类第一类是 Node.js 环境没准备好。Claude Code 是通过 npm 分发的npm 又跟着 Node.js 一起装。很多人电脑里压根没有 Node.js或者装了但版本太老敲npm install直接报错。第二类是权限和路径问题。Mac 上全局安装经常遇到EACCES权限拒绝Windows 上则是装完了敲claude提示「无法识别的命令」本质是 npm 全局路径没进环境变量。第三类是 API 通道没配好。Claude Code 启动后要连模型服务如果你只装了软件没配 Key 和地址首次启动会卡在认证环节或者连上了但请求一直失败。这篇教程就是按「环境准备 → 安装 → 配置通道 → 首次运行验证 → 排错」的顺序把 Mac 和 Windows 两条线都走一遍。全程命令都可以直接复制你跟着敲就行。我实测下来网络正常的话 5 到 10 分钟能跑通第一个任务。需要提前说明的是本文用 TaoToken 作为统一的 Key 和 API 通道来演示接入配置这样 Mac 和 Windows 用同一套地址和密钥省得你到处找不同的服务。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 后面配置环节会用到它的 API 地址。先明确一下你需要的准备项一台 Mac 或 Windows 10/11 电脑、系统自带的终端工具Mac 用「终端」Windows 用 PowerShell、Node.js 环境、一个可用的 API Key。下面逐项搞定。2. Node.js 与 npm 环境准备Mac 和 Windows 分别怎么装这一步是整个安装流程的地基。Claude Code 的安装命令是npm install -g anthropic-ai/claude-code如果 npm 不存在后面全免谈。2.1 先检查你电脑里有没有 Node.js打开终端。Mac 用户在启动台搜索「终端」或按 Command 空格 搜 TerminalWindows 用户按 Win R 输入powershell回车或者开始菜单搜 PowerShell。Windows 强烈建议用 PowerShell 而不是 CMD体验好很多。然后输入node -v npm -v如果两行都输出了版本号比如v20.11.0和10.2.4说明环境已经就绪直接跳到第 3 节。如果提示command not foundMac或「无法识别的命令」Windows就继续往下装。2.2 macOS 安装 Node.js方法一用 Homebrew 装这是 Mac 上最省心的方式。先确认有没有 Homebrewbrew -v如果没有先装 Homebrew/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)装好后再装 Node.jsbrew install node方法二去 Node.js 官网下载 macOS 的.pkg安装包双击一路下一步。对完全不想碰命令行的用户这个方法最直观。装完记得关掉终端重新打开再敲node -v验证。2.3 Windows 安装 Node.js方法一官网下载 LTS 版本长期支持版的.msi安装包双击运行一路 Next 保持默认即可。这里有个坑要提醒安装向导里有个「Add to PATH」的选项默认是勾上的千万别取消否则装完命令还是找不到。方法二用 winget 一条命令搞定winget install OpenJS.NodeJS.LTS方法三如果你用 Scoopscoop install nodejs-ltsWindows 用户特别注意装完 Node.js 后务必关闭当前 PowerShell 再重新打开否则node和npm命令可能识别不了。这是因为环境变量在进程启动时就加载了不重启窗口读不到新路径。2.4 验证环境并处理 npm 网络慢的问题重新打开终端后再跑一次node -v npm -v两个都出版本号就说明环境 OK。如果你在国内网络下发现 npm 装包特别慢或者超时可以先把镜像源切一下npm config set registry https://registry.npmmirror.com这条命令是全局生效的之后所有 npm 安装都会走这个源。想切回官方源就把地址换成https://registry.npmjs.org。这一步不是必须的但能明显减少安装等待时间。环境准备好之后你的终端里就有了node和npm两个命令接下来就能装 Claude Code 本体了。3. 安装 Claude Code 并配置 TaoToken 统一通道这一节是核心分两步先把 Claude Code 装上再把 API 通道配好。两步都做完才能启动。3.1 安装 Claude CodeMac 和 Windows 的安装命令是一样的npm install -g anthropic-ai/claude-codeMac 用户如果遇到权限报错通常是EACCES或permission denied在命令前加sudosudo npm install -g anthropic-ai/claude-codeWindows 用户建议以管理员身份运行 PowerShell开始菜单搜 PowerShell右键选「以管理员身份运行」再执行安装命令。安装完成后验证一下claude --version能输出版本号就说明装好了。如果提示找不到命令先别急第 5 节有专门的排查。3.2 配置 TaoToken 的 API 地址和密钥Claude Code 需要知道两件事请求发到哪个地址Base URL以及用什么身份API Key。TaoToken 把这两样统一了Mac 和 Windows 用同一套值你只需要去控制台拿一次。先去 TaoToken 控制台创建 API Key入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 之后API 地址统一填https://taotoken.net/api注意这个地址不带任何查询参数直接就是 API 根路径。3.3 Mac 上设置环境变量临时设置只对当前终端窗口有效适合先测试export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的API密钥永久设置推荐写进 shell 配置文件echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc echo export ANTHROPIC_API_KEY你的API密钥 ~/.zshrc source ~/.zshrc如果你的 Mac 用的是 Bash 而不是 Zsh把~/.zshrc换成~/.bash_profile。怎么判断敲echo $SHELL输出带zsh就是 Zsh。3.4 Windows 上设置环境变量临时设置仅当前 PowerShell 窗口有效$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的API密钥永久设置推荐[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, 你的API密钥, User)设置永久变量后必须关闭并重新打开 PowerShell 才生效。如果你更习惯图形界面也可以走这条路按 Win S 搜「环境变量」→ 点「编辑系统环境变量」→ 点「环境变量」按钮 → 在「用户变量」里点「新建」分别添加ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个变量值填上面的内容确定保存后重开 PowerShell。3.5 用 settings 文件固化配置可选但推荐除了环境变量Claude Code 还支持通过配置文件固化设置。在用户目录下创建.claude/settings.json写入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的API密钥 } }Mac 路径是/Users/你的用户名/.claude/settings.jsonWindows 路径是C:\Users\你的用户名\.claude\settings.json。这个文件的好处是配置跟着项目或用户走换终端窗口也不用重新 export。环境变量和这个文件二选一即可同时存在时环境变量优先级更高。配置完成后验证环境变量是否生效Macecho $ANTHROPIC_API_KEY echo $ANTHROPIC_BASE_URLWindows PowerShellecho $env:ANTHROPIC_API_KEY echo $env:ANTHROPIC_BASE_URL能正确输出你设置的值就说明通道配好了。接下来启动 Claude Code。4. 首次启动验证从认证到跑通第一个任务配置就绪后在终端输入claude这个命令 Mac 和 Windows 完全一样。如果你想指定模型启动可以加--model参数claude --model deepseek-v4-pro首次启动会走几个配置步骤别慌跟着选就行。第 1 步选择认证方式。界面会出现两个选项1. API Key和2. OAuth。因为我们已经在环境变量里配好了 Key选1. API Key按回车。第 2 步安全提示页面。会出现一段免责声明大意是 Claude 可能会犯错让你按 Enter 继续。直接回车。第 3 步终端设置优化。会问你要不要启用推荐设置选项是1. Yes, use recommended settings和2. No, skip。建议选 1多行输入会更方便不影响使用。第 4 步信任文件夹。会问Do you trust this folder?选1. Yes, I trust this folder。这是允许 Claude Code 读取和操作当前目录下的文件默认目录通常是你的用户主目录信任它是安全的。四步走完你就进入了 Claude Code 的主交互界面会看到一个等待输入的提示符 _。现在验证一下是否正常。输入一句你好如果它返回了正常的问候回复说明整条链路通了。再试个实际任务帮我用 Java 写一个快速排序算法Claude Code 会自动创建QuickSort.java文件、编译并运行输出排序结果。到这一步你的第一个任务就跑通了。日常使用中几个快捷键记一下Ctrl C中断当前任务/help查看帮助/exit或Ctrl D退出。想换模型可以在对话里用/model命令或者启动时用--model指定。如果你后面想长期用它做编码和 Agent 任务可以了解下 Coding Plan入口https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先单独验证模型对话效果可以用模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5. 常见报错排查401、command not found、执行策略限制装的过程中报错是正常的这一节把最常见的几个坑列出来对照着修。5.1 报错 401 / API 连接失败这是最典型的认证问题通常是 Key 或 Base URL 配错了。先检查环境变量Macecho $ANTHROPIC_API_KEY echo $ANTHROPIC_BASE_URLWindows PowerShellecho $env:ANTHROPIC_API_KEY echo $env:ANTHROPIC_BASE_URL如果输出为空说明变量没设上重新按第 3 节设置一遍。如果输出有值但请求还是 401检查 Key 有没有多余空格、Base URL 是不是写成了https://taotoken.net/api不要带结尾斜杠也不要带其他路径。另外确认 Key 没有过期或被删除可以去控制台重新生成一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5.2 报错 command not found / 无法识别的命令claude说明 Claude Code 没装成功或者 npm 全局路径没进环境变量。先重新装一次npm install -g anthropic-ai/claude-code然后检查命令路径Macwhich claudeWindows PowerShellGet-Command claude如果which找不到但 npm 说装成功了多半是 npm 全局 bin 目录不在 PATH 里。查一下 npm 全局路径npm config get prefixMac 上通常是/usr/local或/opt/homebrew对应的 bin 目录加到~/.zshrc里export PATH$PATH:$(npm config get prefix)/binWindows 上通常是C:\Users\你的用户名\AppData\Roaming\npm把这个路径加到用户变量的 Path 里重开 PowerShell。5.3 报错 local proxy failed / 连接超时这类报错通常是网络层的问题请求没到达服务端。先确认你的网络能正常访问外网然后检查 Base URL 有没有写错。如果公司网络有代理设置需要确认代理配置不会拦截 API 请求。另外可以试试用 curl 直接测一下地址连通性curl -I https://taotoken.net/api能返回 HTTP 状态码说明地址可达。如果这一步就失败问题在网络环境不在 Claude Code 本身。5.4 报错 reading choices / 模型不支持这个报错一般是模型名称和服务端不匹配。启动时指定正确的模型claude --model deepseek-v4-pro或者在对话里用/model切换。如果你不确定有哪些模型可用可以先去模型对话页面看看当前支持的模型列表https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5.5 Windows 执行策略限制Windows 上如果出现「无法加载文件因为在此系统上禁止运行脚本」是 PowerShell 的执行策略拦住了。以管理员身份运行 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认然后重新启动 Claude Code。5.6 npm 安装慢或超时切镜像源npm config set registry https://registry.npmmirror.com npm install -g anthropic-ai/claude-code5.7 OAuth 认证卡住如果你在首次启动时误选了 OAuth会跳转到浏览器认证流程国内环境下可能卡住。解决办法是退出 Claude Code确认环境变量里的 API Key 已设置重新启动时选1. API Key。如果已经进了 OAuth 流程按Ctrl C中断重新claude启动即可。排查完这些基本能覆盖 90% 的安装问题。如果还遇到其他报错可以去接入文档看看更详细的说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6. 把 Claude Code 用起来的几个实用建议装好只是开始怎么用顺手才是关键。分享几个我实际用下来觉得有用的点。第一项目目录要选对。Claude Code 启动时会信任当前目录它会读写这个目录下的文件。所以建议你先cd到具体项目文件夹再启动claude而不是在用户主目录下启动。这样它操作的文件范围可控也不会误改到系统文件。第二善用/model切换。不同任务对模型要求不一样写复杂逻辑可以用强一点的模型简单改个配置用轻量模型更快。启动时用claude --model 模型名或者在对话里直接/model切换不用退出重进。第三多行输入用快捷键。首次启动如果选了推荐设置多行输入会方便很多。写长指令的时候不用一行行挤直接换行写清楚需求Claude Code 理解得更准。第四环境变量和 settings.json 选一个就好。如果你经常换终端或者用多个 shell建议用 settings.json 固化配置省得每次都要 source。如果只是临时测试export 更灵活。第五遇到请求失败先看环境变量。大部分连接问题都是 Key 或地址配错echo一下就能定位。养成配完就验证的习惯能省很多排查时间。如果你打算把 Claude Code 接入到日常编码流程里比如配合 CI 或者做自动化 Agent可以看看 Coding Plan 的说明它针对长期编码场景做了优化https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content整个流程走下来从装 Node.js 到跑通第一个任务正常网络下 5 到 10 分钟。Mac 和 Windows 的差异主要集中在环境变量设置和权限处理上安装命令和启动命令是完全一致的。把第 3 节的配置做扎实后面基本不会出问题。