【清晰教程】Claude Code 安装教程：从 Node.js 到 settings.json 配 TaoToken

1. 为什么第一次装 Claude Code 总卡在环境上Claude Code 是 Anthropic 推出的终端 AI 编程助手它跑在命令行里能直接读写你本地的项目文件、执行 Git 操作、跑测试命令。适合谁适合已经习惯用终端、想让 AI 真正“动手改代码”而不是只聊天的开发者。但它的安装门槛不在 Claude Code 本身而在它依赖的一整条工具链Node.js、npm、Git缺一个都会在启动时报错。我见过太多人卡在第一步claude命令敲下去要么提示command not found要么弹出一堆 Node 版本不兼容的报错要么 Git Bash 找不到路径。Windows 和 macOS 的坑还不一样。这篇教程就按“先检查环境、再全局安装、最后配 settings.json 接入 TaoToken”的顺序走一遍目标很明确一次跑通安装并且确认请求能正常返回。核心检索词先摆出来Claude Code 安装教程、Node.js、npm、Git、settings.json 配置。你跟着做每一步都有可复制的命令和预期结果。2. 装之前先把 Node.js、npm、Git 三件套验一遍Claude Code 通过 npm 分发npm 又跟着 Node.js 一起来所以 Node.js 是地基。Git 则是 Claude Code 执行命令时的依赖尤其在 Windows 上它会调用 Git Bash。先别急着装 Claude Code把这三个版本号打出来看看。打开终端Windows 用 PowerShell 或 CMDmacOS 用 Terminal依次执行node -v npm -v git --version预期结果类似v20.11.1 10.2.4 git version 2.43.0Node.js 建议 18 以上20 LTS 最稳。如果node -v报“不是内部或外部命令”说明没装或没进 PATH。Windows 可以用 winget 装winget install OpenJS.NodeJS.LTS winget install Git.GitmacOS 用 Homebrewbrew install node brew install git装完关掉终端重开一次让 PATH 生效再跑一遍上面三条验证命令。这一步别偷懒环境没通后面全是玄学报错。注意Windows 上 Git 装完后确认C:\Program Files\Git\bin在系统 PATH 里Claude Code 找 Git Bash 就靠它。3. 全局安装 Claude Code 并确认命令可用环境三件套都返回版本号之后全局安装 Claude Code。命令就一行npm install -g anthropic-ai/claude-code-g是全局安装装完在任何目录都能调用claude。安装过程会拉取依赖网络正常的话一两分钟。装完验证claude --version能打印出版本号就说明二进制已经就位。如果提示claude: command not found多半是 npm 全局 bin 目录没进 PATH。查一下全局路径npm config get prefix把这个路径下的binmacOS/Linux或根目录Windows加进 PATH重开终端再试。Windows 上还有一种情况是 PowerShell 执行策略拦截用管理员权限跑一次Set-ExecutionPolicy RemoteSigned即可。到这一步Claude Code 本体装好了但它还不知道该往哪个 API 通道发请求。接下来配 settings.json。4. settings.json 接入 TaoToken 统一 Key 与 API 通道Claude Code 读取配置的位置分全局和项目级。全局配置在用户目录下WindowsC:\Users\你的用户名\.claude\settings.jsonmacOS~/.claude/settings.json没有这个文件就手动建。TaoToken 提供统一的 Key 和 API 通道把请求指向它即可。配置骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key } }说明一下两个字段ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你在 TaoToken 控制台生成的 Key。Key 的获取入口在控制台的 API Keys 页面先生成再复制别把 Key 提交到 Git 仓库里。如果你想让某个项目单独用不同配置可以在项目根目录建.claude/settings.json字段结构一样项目级会覆盖全局。改完保存Claude Code 下次启动就会读取。提示settings.json 是标准 JSON不能有注释、不能有多余逗号格式错一行整个配置就失效。5. 发一条请求验证连通性配置写完进任意一个项目目录启动claude第一次启动会进入交互界面。直接输入一句测试比如帮我看看当前目录下有哪些文件如果配置正确Claude Code 会调用你配置的 API 通道返回结果并可能请求执行ls之类的命令。看到正常回复说明从 Node.js 到 settings.json 整条链路通了。想更直接地验证 API 通道可以用 curl 打一次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-3-5-sonnet-20241022,max_tokens:64,messages:[{role:user,content:ping}]}返回带content字段的 JSON就证明 Key 和通道都没问题。如果返回 401检查 Key 是否复制完整返回 404检查 BASE_URL 有没有多写或少写路径。6. 安装与接入常见报错排查报错一claude: command not foundnpm 全局 bin 没进 PATH。跑npm config get prefix找到路径加进环境变量重开终端。报错二Error: Cannot find moduleNode.js 版本过低或安装损坏。升级到 20 LTS卸载后重装npm install -g anthropic-ai/claude-code。报错三启动后一直转圈或超时settings.json 里 BASE_URL 写错或者 Key 无效。用第 5 节的 curl 单独测通道先排除配置问题。报错四Windows 下提示找不到 bashGit 没装或 Git Bash 路径不在 PATH。重装 Git勾选“Add to PATH”确认git --version能返回。报错五settings.json 改了不生效JSON 格式错误或者改的是项目级但当前目录不对。用编辑器校验 JSON确认文件位置。排查顺序建议先验 Node/npm/Git 版本再验claude --version最后验 API 通道。逐层排除别一上来就重装。7. 装完之后模型对话、Coding Plan 与文档入口安装跑通只是起点。日常想快速验证模型返回可以直接用模型对话页面试 prompt不用每次开终端。如果你打算长期用 Claude Code 做编码或搭 Agent 工作流Coding Plan 更适合按量长期跑成本比单次调用可控。接入过程中遇到字段疑问接入文档里有完整的参数说明Key 的管理和轮换在 API Keys 页面操作。模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewriteCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_installutm_campaignrewrite最后留一个实操习惯每次换机器或重装系统先把第 2 节那三条版本命令跑一遍再动 Claude Code。环境这层稳了后面 settings.json 和 Key 的问题都好定位。