1. 三平台装完 Claude 却连不上先把 settings 路径这件事捋清楚Claude Code 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯用 CLI 干活的开发者。它本身只是个客户端真正决定它请求发往哪里的是settings.json里的ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN这两个字段。很多人装完npm install -g anthropic-ai/claude-code之后直接敲claude结果卡在登录或者报 401问题八成不在安装而在配置文件没写对、或者写对了但放错了位置。Windows、macOS、Linux 三个系统上Claude Code 读取配置的优先级和默认路径并不一样。Windows 习惯放在C:\Users\你的用户名\.claude\settings.jsonmacOS 和 Linux 则更多依赖~/.claude/settings.json加上 shell 里的环境变量。你要是只按某一篇教程抄换台机器就翻车。这篇就把三平台的安装、settings 文件位置差异、可复制的配置片段、以及验证连通性的命令一次讲完让你从装完到真正能跑通 API 通道形成闭环。我试过在 Windows 上用 PowerShell 设永久环境变量、在 Mac 上改.zshrc、在 Ubuntu 上改.bashrc三种方式都能通但排查思路完全不同。下面按「先装 Node、再装 Claude Code、然后写 settings、最后验证」的顺序走每一步都给完整命令和结果说明你照着敲就行。2. 接入前的前置准备TaoToken 的 Key 与 Base URL 怎么拿在动配置文件之前得先有一个可用的 API 通道。TaoToken 提供的就是这样一个统一入口你注册后在控制台生成 API Key就能拿到两样东西一个 Base URL 和一个以sk-开头的密钥。这两样会分别填进ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。具体操作路径是这样的打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsole 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keys 点「创建密钥」复制那串sk-开头的字符串。Base URL 统一用https://taotoken.net/api注意这个地址后面不加任何 UTM 参数直接原样填。这里有个容易踩的坑很多人把 Base URL 写成带/v1或者带斜杠结尾的形式结果 Claude Code 拼接请求路径时多了一层直接 404。Claude Code 的ANTHROPIC_BASE_URL填到域名加/api这一层就够了剩下的/v1/messages由客户端自己拼。密钥则要完整复制前后不要带空格Windows 上从网页复制有时会带不可见字符粘进 JSON 后解析报错建议粘完手动检查一遍。如果你还想在接入前先确认模型能不能正常对话可以打开模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chat 发一条测试消息看到正常回复说明 Key 和通道都没问题再去配 Claude Code 就少一层变量。对于长期要跑编码任务、Agent 场景比较多的可以顺带看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_plan 按需选择即可这里不展开。拿到 Key 和 Base URL 之后三平台的差异就只剩「配置文件放哪、环境变量怎么设」了。下面分平台给完整步骤。3. 三平台可复制的 settings 配置片段与文件位置这一节是全文的核心直接给可复制的 JSON 和 shell 片段。先记住一个总原则Claude Code 会同时读环境变量和settings.json环境变量优先级通常更高。所以如果你两边都配了且值不一样以环境变量为准排查时先看环境变量。3.1 Windowssettings.json 与 PowerShell 永久变量先装 Node.js去 nodejs.org 下 LTS 版本要求 18 以上装完验证node --version npm --version然后装 Claude Code国内网络建议带镜像源npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com配置文件放在C:\Users\你的用户名\.claude\settings.json如果.claude目录不存在就手动建一个。内容如下{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_BASE_URL: https://taotoken.net/api } }如果你更习惯用环境变量PowerShell 里设永久变量对当前用户生效[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, [System.EnvironmentVariableTarget]::User) [System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, sk-你的密钥, [System.EnvironmentVariableTarget]::User)设完要重开一个终端窗口才生效旧窗口读不到新变量。之后敲claude就能进交互界面。3.2 macOSzsh 环境变量与 settings.json 双保险Mac 上用 Homebrew 装 Node 最省事brew install node npm install -g anthropic-ai/claude-codeMac 默认 shell 是 zsh永久变量写进~/.zshrcecho export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc echo export ANTHROPIC_AUTH_TOKENsk-你的密钥 ~/.zshrc source ~/.zshrc同时也可以放一份~/.claude/settings.json内容和 Windows 那份完全一致{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的密钥, ANTHROPIC_BASE_URL: https://taotoken.net/api } }3.3 Linuxbash 环境变量与 NodeSource 安装Ubuntu/Debian 上装 Node 用 NodeSource 仓库curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs npm install -g anthropic-ai/claude-code永久变量写进~/.bashrcecho export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.bashrc echo export ANTHROPIC_AUTH_TOKENsk-你的密钥 ~/.bashrc source ~/.bashrc~/.claude/settings.json同样可以放一份三平台内容一致方便你跨机器同步。3.4 VSCode / Cursor 扩展的 config.json 别搞混如果你用 VSCode 或 Cursor 的 Claude Code 扩展注意它读的是.claude/config.json不是settings.json字段名也不一样{ primaryApiKey: sk-你的密钥 }前提是 CLI 已经按对应系统配好。很多人把primaryApiKey写进settings.json扩展死活不认就是文件名搞错了。4. 验证连通性一条命令确认 API 通道真的通了配置写完不代表通了得实际发一次请求。最直接的方式是进 Claude Code 交互界面后随便问一句比如「用一句话解释什么是递归」能正常流式返回就说明通道没问题。如果卡住或报错先别急着改配置按下面顺序验证。第一步确认环境变量在当前终端里读到了echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKENWindows PowerShell 用echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN如果输出为空说明变量没生效重开终端或检查写错了哪个文件。第二步直接用 curl 打一次接口绕过 Claude Code 本身确认是通道问题还是客户端问题curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5-20250929, max_tokens: 64, messages: [{role: user, content: ping}] }返回里带content字段和一段文本就说明 Key、Base URL、模型名三者都对。如果这里就报 401问题在密钥报 404问题在 Base URL 多写了路径报模型不存在就是 model 字段写错了。第三步回到 Claude Code 里跑一次真实任务比如让它读一个文件claude 读一下当前目录的 package.json告诉我项目名能正确读到文件并回答说明从安装到 API 通道的完整闭环已经打通。这一步比单纯 ping 更有意义因为它同时验证了工具调用链路。5. 常见报错排查401、local proxy failed、reading choices 逐个拆配置过程中最常撞见的就是下面这几类报错我按真实遇到的顺序列出来对照着改。401 Unauthorized / invalid api key九成是密钥问题。先确认ANTHROPIC_AUTH_TOKEN里没有多余空格或换行Windows 从网页复制尤其容易带不可见字符。再确认这个 Key 在控制台里是启用状态、没被删。如果环境变量和settings.json都配了检查是不是环境变量里那份是旧的。local proxy failed / connection refused这类通常出现在你本地还开着某个代理工具或者环境变量里残留了HTTP_PROXY、HTTPS_PROXY。Claude Code 会走系统代理设置代理不通就报这个。检查一下echo $HTTP_PROXY echo $HTTPS_PROXY有值且你不需要的话unset HTTP_PROXY HTTPS_PROXY再试。Windows 上在「环境变量」面板里删掉对应的用户变量。reading choices / unexpected response这个报错一般意味着返回体不是预期的 JSON 结构常见原因是 Base URL 写成了带/v1的形式导致请求路径变成/v1/v1/messages服务端返回了 HTML 错误页。把ANTHROPIC_BASE_URL改回https://taotoken.net/api即可。OAuth / 登录循环Claude Code 首次启动可能引导你走 OAuth 登录但你已经配了自定义 Base URL 和 Token这时它会尝试用官方登录流程和你的配置冲突。解决办法是确保ANTHROPIC_AUTH_TOKEN已设置启动时它检测到 Token 就不会再走 OAuth。如果还是弹登录删掉~/.claude下的缓存凭证文件再启动。Codex 的 auth.json 与 config.toml 三件套如果你同时用 Codex它的配置是另一套。~/.codex/config.toml里要写全 Base URL、模型、providermodel_provider custom model gpt-5.3-codex model_reasoning_effort xhigh disable_response_storage true [model_providers.custom] name custom wire_api responses requires_openai_auth true base_url https://taotoken.net/api/v1~/.codex/auth.json里放密钥{ OPENAI_API_KEY: sk-你的密钥 }注意 Codex 的 Base URL 是带/v1的和 Claude Code 不一样别混用。三件套缺一不可Base URL、Key、Model ID少一个就连不上。CC Switch / Cline MCP 场景如果你用 CC Switch 或 Cline 的 MCP 配置同样要写全 Base URL、Key、Model ID 三件套字段名按各自文档来但值都来自同一套 TaoToken 凭证。MCP 不要直连生产数据库配置时只填 API 通道信息即可。6. 把配置沉淀成可复用模板下次换机十分钟搞定三平台折腾下来真正花时间的不是安装而是记住每个系统配置文件放哪、环境变量写哪个文件。我的做法是把三份配置片段存成一个私有笔记Windows 的settings.json、Mac 的.zshrc追加行、Linux 的.bashrc追加行外加 VSCode 的config.json。换机器时按系统复制对应那份改一下密钥就能用。密钥建议单独管理不要和配置片段混在一起存。配置模板里用占位符sk-你的密钥实际填的时候从控制台现取。这样即使模板泄露也不至于直接暴露密钥。验证环节固定用第 4 节那条 curl先确认通道通再进 Claude Code 跑真实任务两步都过才算配置完成。如果你后面要跑更重的编码或 Agent 任务可以到 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_plan 看下额度方案接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 遇到字段疑问先查文档再改配置比反复试错快得多。