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.json，macOS 和 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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册登录后进入控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console ，在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-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_source=taotoken_aicg_blog_end&utm_content=model_chat 发一条测试消息，看到正常回复说明 Key 和通道都没问题，再去配 Claude Code 就少一层变量。对于长期要跑编码任务、Agent 场景比较多的，可以顺带看下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan ，按需选择即可，这里不展开。
拿到 Key 和 Base URL 之后，三平台的差异就只剩「配置文件放哪、环境变量怎么设」了。下面分平台给完整步骤。
3. 三平台可复制的 settings 配置片段与文件位置
这一节是全文的核心，直接给可复制的 JSON 和 shell 片段。先记住一个总原则：Claude Code 会同时读环境变量和settings.json，环境变量优先级通常更高。所以如果你两边都配了且值不一样，以环境变量为准，排查时先看环境变量。
3.1 Windows：settings.json 与 PowerShell 永久变量
先装 Node.js，去 nodejs.org 下 LTS 版本（要求 18 以上），装完验证：
node --version npm --version然后装 Claude Code，国内网络建议带镜像源：
npm install -g @anthropic-ai/claude-code --registry=https://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 macOS：zsh 环境变量与 settings.json 双保险
Mac 上用 Homebrew 装 Node 最省事：
brew install node npm install -g @anthropic-ai/claude-codeMac 默认 shell 是 zsh，永久变量写进~/.zshrc：
echo 'export ANTHROPIC_BASE_URL="https://taotoken.net/api"' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.zshrc source ~/.zshrc同时也可以放一份~/.claude/settings.json，内容和 Windows 那份完全一致：
{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥", "ANTHROPIC_BASE_URL": "https://taotoken.net/api" } }3.3 Linux：bash 环境变量与 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永久变量写进~/.bashrc：
echo 'export ANTHROPIC_BASE_URL="https://taotoken.net/api"' >> ~/.bashrc echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"' >> ~/.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、模型、provider：
model_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_source=taotoken_aicg_blog_end&utm_content=coding_plan 看下额度方案；接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc ，遇到字段疑问先查文档再改配置，比反复试错快得多。
