1. Claude Code 装完别急着用先把环境变量和配置文件过一遍很多人以为npm install -g anthropic-ai/claude-code跑完、终端里能敲出claude命令安装就算结束了。实际上这只是把可执行文件放进了全局目录真正决定它能不能稳定跑起来、能不能连上模型、会不会每次启动都弹一堆报错的是后面这一堆环境变量和配置文件。我自己第一次装完就踩了坑命令行窗口里claude --version能出版本号但一启动就提示登录失败折腾半天才发现是环境变量没刷新加上配置文件里少了一行关键字段。这篇是 Claude Code 安装系列的第三篇专门讲安装完成后的收尾检查。核心围绕四件事npm 全局路径是否正常、Node.js 版本是否达标、Git 是否可被调用、以及settings.json骨架该怎么写。每一步都给可复制的命令和配置片段你照着敲一遍就能确认自己的安装是真可用而不是“看起来装好了”。顺带也会说明怎么通过 TaoToken 把 Key 和 API 通道统一起来避免在多个平台之间来回切换。适合谁看已经装完 Claude Code 但启动报错的人想确认自己环境是否干净的人以及准备把它接进日常编码流程、需要一套稳定配置骨架的人。下面按检查顺序逐项来。2. 前置检查npm、Node.js、Git 三件套是否真的就位Claude Code 是通过 npm 全局安装的所以 npm 和 Node.js 的版本直接决定它能不能跑。Git 则是它读取仓库、做 diff 相关操作时依赖的外部命令。这三样任何一个路径不对后面都会出问题。2.1 确认 Node.js 版本与 npm 全局路径先开一个终端Windows 下建议用管理员身份打开 cmd 或 PowerShell避免全局安装时权限不足。依次执行node -v npm -v npm config get prefixnode -v建议在 18 以上20 或 22 更稳。npm -v跟着 Node 走即可。重点看npm config get prefix的输出这个路径就是全局包安装的位置。Windows 下通常是C:\Users\你的用户名\AppData\Roaming\npmmacOS/Linux 下一般是/usr/local或~/.npm-global。为什么要看这个因为如果这个 prefix 目录没有加进系统 PATH你装完 Claude Code 后敲claude会提示“不是内部或外部命令”。验证方法where claudeWindows 用wheremacOS/Linux 用which claude。如果输出为空说明全局 bin 目录不在 PATH 里需要手动加。2.2 确认 Git 可被调用git --version能出版本号就行。如果提示找不到命令说明 Git 没装或者没进 PATH。Windows 下装 Git 时记得勾选“Add to PATH”那个选项否则后面 Claude Code 调用 git 会失败。装完后同样要重开终端让 PATH 生效。2.3 环境变量刷新这个坑这里有个高频问题你刚用setx设了环境变量当前终端里echo %ANTHROPIC_API_KEY%却是空的。原因是setx写的是注册表里的用户环境变量已经打开的终端不会自动重新读取。解决办法就一个关掉当前终端窗口重新开一个。这一点在后面的验证环节会反复用到。3. TaoToken 前置把 Key 和 API 通道统一起来Claude Code 默认走的是官方通道需要登录且涉及计费。如果你希望用一个统一的 Key 来管理模型调用可以借助 TaoToken 做接入层。它的作用是提供一个兼容 Anthropic 接口规范的 API 地址你只需要把 Claude Code 的ANTHROPIC_BASE_URL指向它再把ANTHROPIC_API_KEY换成在 TaoToken 申请的 Key 就行。具体操作路径是这样先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建完复制那串 Key后面配置环境变量时要用。API 的基础地址是 https://taotoken.net/api 注意这个地址不带任何查询参数配置时原样填入即可。如果你对接口细节有疑问可以查文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。提示Key 只在创建时完整显示一次复制后先存到安全的地方别直接贴在会提交到 Git 的文件里。4. 可复制配置环境变量与 settings.json 骨架这一节是全文的核心分两部分环境变量怎么设配置文件怎么写。4.1 环境变量设置Windows 与 macOS/Linux 分开Windows 下用setx注意每条命令执行完都要重开终端才生效setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_API_KEY 你的TaoToken Key setx ANTHROPIC_MODEL claude-sonnet-4-5macOS/Linux 下写进 shell 配置文件比如~/.zshrc或~/.bashrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的TaoToken Key export ANTHROPIC_MODELclaude-sonnet-4-5改完执行source ~/.zshrc让当前会话生效。三个变量的含义分别是ANTHROPIC_BASE_URL指定请求发往哪个地址ANTHROPIC_API_KEY是身份凭证ANTHROPIC_MODEL指定默认调用的模型名。模型名要和你账号下可用的模型对应填错会报模型不存在。4.2 settings.json 骨架Claude Code 的配置文件在用户目录下Windows 是C:\Users\你的用户名\.claude\settings.jsonmacOS/Linux 是~/.claude/settings.json。如果目录或文件不存在手动创建即可。一个可用的骨架长这样{ hasCompletedOnboarding: true, env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-5 }, permissions: { allow: [], deny: [] } }hasCompletedOnboarding设为true可以跳过首次启动的引导流程避免每次都被问一堆问题。env块里放环境变量这样即使系统环境变量没设Claude Code 启动时也能读到。permissions用来控制工具调用的允许和拒绝列表初期留空即可后面按需加。注意JSON 不支持注释也别留尾逗号否则解析会失败。改完可以用node -e JSON.parse(require(fs).readFileSync(路径,utf8))快速校验格式。4.3 参数对照表配置项作用示例值ANTHROPIC_BASE_URLAPI 请求地址https://taotoken.net/apiANTHROPIC_API_KEY身份凭证控制台创建的 KeyANTHROPIC_MODEL默认模型claude-sonnet-4-5hasCompletedOnboarding跳过引导true5. 验证请求确认安装真正可用配置写完不算完得实际跑一次确认链路通。分三步验证。第一步确认环境变量在当前终端可见echo %ANTHROPIC_BASE_URL% echo %ANTHROPIC_API_KEY%macOS/Linux 用echo $ANTHROPIC_BASE_URL。如果输出为空说明终端没刷新关掉重开。第二步启动 Claude Codeclaude正常的话会进入交互界面不再弹登录报错。如果它问你是否读取当前目录文件初期可以先选否等模型配置确认没问题再让它读。第三步发一条测试请求比如输入“用一句话说明这个项目是做什么的”看是否有正常回复。有回复就说明 Key、地址、模型三者都对上了。如果报 401是 Key 问题报 404多半是模型名或地址写错报连接超时检查网络和 BASE_URL 是否可达。想单独验证模型通道是否通也可以到模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一条消息能正常返回就说明 Key 本身没问题问题出在 Claude Code 的配置侧。6. 本篇常见错排查把高频报错和对应处理列一下方便你对号入座。报错一claude不是内部或外部命令。全局 bin 目录不在 PATH。用npm config get prefix找到路径手动加进系统环境变量重开终端。报错二启动后提示 not login 或登录失败。环境变量没生效或者settings.json里env块没写对。先echo确认变量可见再检查 JSON 格式。报错三401 Unauthorized。Key 错误或已失效。到 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新生成一个替换后重开终端。报错四模型不存在。ANTHROPIC_MODEL填的模型名不在可用列表里。换成账号下确认可用的模型名。报错五改了配置没反应。九成是终端没刷新。setx和 shell 配置文件都需要新会话才生效关掉重开是最省事的办法。报错六JSON 解析失败。检查有没有尾逗号、中文引号、注释。用前面给的 node 命令校验一下。如果你打算长期把 Claude Code 用在日常编码和 Agent 流程里可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 把调用额度统一管理省得每次都要盯着余额。接入相关的细节都在文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里遇到接口层面的问题先翻文档比到处搜答案快。最后补一句实操经验配置改完后养成“关终端、重开、再验证”的习惯能省掉一大半“明明改了却没生效”的困惑。环境变量和配置文件这两块理顺了Claude Code 才算真正装好。