Mac 部署 Claude 教程：用 brew 装好 git 与 node.js 后把 Base URL 改到 TaoToken

1. Mac 上从零部署 Claude 的真实卡点brew 装完 git 与 node.js 之后该干什么很多人在 Mac 上第一次部署 Claude 相关工具链时会卡在一个很尴尬的位置brew 装好了git 装好了node.js 也装好了然后打开终端一看不知道下一步该敲什么。这个场景我太熟了因为我自己第一次在 M 系列芯片的 MacBook 上折腾 Claude Code 的时候就是装完一堆依赖之后对着黑乎乎的终端发呆。先说清楚这篇要解决什么。Claude 在这里指的是 Anthropic 官方的命令行编码工具 Claude Code它能让你在终端里直接跟模型对话、读写项目文件、跑命令。适合谁适合在 Mac 上做开发、想用命令行方式接入大模型能力、又不想在编辑器插件里绕来绕去的开发者。核心检索词就是 Mac 部署 Claude、brew 安装 git、node.js 环境自检、Base URL 配置。为什么装完 git 和 node.js 还不算完因为 Claude Code 本身是个 Node 生态的命令行程序它启动时要读环境变量、要能调用 git 做版本操作、要能发起 HTTPS 请求到模型服务端点。这三件事缺一个你敲claude的时候就会看到各种莫名其妙的报错比如 command not found、node 版本过低、或者请求直接超时。而 Base URL 这一环是最容易被忽略的。默认情况下 Claude Code 会往 Anthropic 官方端点发请求但很多国内开发者的网络环境直连不稳定于是就需要把 endpoint 改到一个可用的通道上。TaoToken 在这里扮演的就是这个通道角色——它提供兼容 Anthropic 协议的 API 端点你只要把 Base URL 和 Key 配好Claude Code 就能正常跑起来。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。我试过的完整路径是这样的先用 brew 把 git 和 node.js 装利索然后做一次环境自检确认版本没问题接着装 Claude Code最后把 Base URL 改到 TaoToken 并用一次真实请求验证通道。下面按这个顺序拆开讲每一步都给可复制的命令和预期输出。这里要提醒一句环境自检这一步千万别跳过。我见过太多人 node 版本是 16 甚至更老装完 Claude Code 一跑就崩然后回头查半天才发现是版本问题。Mac 上如果用系统自带的 node版本往往很旧所以强烈建议用 nvm 管理 node 版本。2. TaoToken 前置准备拿 Key、认端点、理清 Claude Code 的配置逻辑在动手改配置之前得先把 TaoToken 这边的准备工作做完。这一步不复杂但顺序不能乱否则后面配置片段里的 Key 和端点对不上请求就会 401。第一件事是注册并拿到 API Key。打开 https://taotoken.net/api-keys 登录后创建一个新的 Key复制出来存好。这个 Key 就是后面配置里的ANTHROPIC_AUTH_TOKEN或者ANTHROPIC_API_KEY具体用哪个取决于 Claude Code 的版本和你的配置方式。Key 只显示一次丢了就得重新建所以复制完先粘到备忘录里。第二件事是确认端点地址。TaoToken 的 API 基础地址是 https://taotoken.net/api 注意这里不带任何路径后缀。Claude Code 在拼接请求时会自己加上/v1/messages这类路径所以你配置的 Base URL 只需要到/api这一层。如果你手贱多写了个/v1请求就会变成/api/v1/v1/messages直接 404。第三件事是理解 Claude Code 读配置的优先级。它主要看环境变量其次是配置文件。环境变量里最关键的两个是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。前者告诉它往哪发请求后者是身份凭证。有些版本还会读ANTHROPIC_API_KEY所以稳妥起见两个都设上值一样就行。这里有个坑要提前说Claude Code 的配置文件和 shell 的配置文件是两回事。你在.zshrc里 export 的环境变量只在交互式 shell 里生效如果你用 launchd 或者某些 IDE 内置终端启动 Claude Code可能读不到。所以最稳的做法是既写进 shell 配置又在 Claude Code 自己的 settings 文件里写一份。TaoToken 的模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 你可以先在网页上试一下模型能不能正常回话确认账号和额度没问题再去配命令行。这一步相当于先验证「路是通的」再去修「车怎么开」。另外如果你打算长期用 Claude Code 做编码或者跑 Agent 任务可以了解一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它针对的就是这种高频编码场景比按量计费更划算。不过这是后话先把基础通道打通再说。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 后面查用量、看请求日志都在这里。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 配置遇到不确定的地方可以对照着看。3. 可复制配置brew 装 git 与 node.js、环境自检、Base URL 改到 TaoToken这一节是全文的核心所有命令都可以直接复制粘贴。我按执行顺序排好你从上往下走就行。3.1 安装 Homebrew 并配置环境Homebrew 是 Mac 上的包管理器git 和 node.js 都靠它装。官方安装命令是/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)装完之后终端会提示你把 brew 加进 PATH。Apple Silicon 芯片的 Mac 执行这两条echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zshrc eval $(/opt/homebrew/bin/brew shellenv)Intel 芯片的 Mac 路径是/usr/local/bin/brew把上面命令里的路径换掉即可。执行完敲brew --version能打印出版本号就说明装好了。3.2 用 brew 安装 gitbrew install git装完验证git --version预期输出类似git version 2.43.0。如果提示 command not found说明 PATH 没配好回到 3.1 检查。3.3 用 nvm 安装 node.js 24不推荐直接用brew install node因为版本不好切换。用 nvm 更灵活brew install nvm mkdir -p ~/.nvm echo export NVM_DIR$HOME/.nvm ~/.zshrc echo [ -s /opt/homebrew/opt/nvm/nvm.sh ] . /opt/homebrew/opt/nvm/nvm.sh ~/.zshrc source ~/.zshrc nvm install 24 nvm use 24 nvm alias default 24装完验证node -v npm -v预期node -v输出v24.x.x。如果还是旧版本检查nvm alias default 24有没有执行然后重开一个终端窗口。3.4 环境自检脚本把下面这段存成check-env.sh跑一次能一次性确认 git、node、npm 版本和网络连通性#!/bin/bash echo git git --version || echo git 未安装 echo node node -v || echo node 未安装 echo npm npm -v || echo npm 未安装 echo 端点连通性 curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api执行bash check-env.sh最后一行如果输出 200 或 401说明网络能到 TaoToken 端点401 是因为没带 Key正常。如果输出 000 或者卡住说明网络层有问题先解决网络再往下走。3.5 安装 Claude Codebrew install --cask claude-code装完敲claude --version确认。如果提示找不到命令检查 cask 是否装成功或者用 npm 方式装npm install -g anthropic-ai/claude-code3.6 把 Base URL 改到 TaoToken这一步是重点。Claude Code 的配置可以写在 shell 环境变量里也可以写在它自己的 settings 文件里。先配环境变量编辑~/.zshrc追加export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN你的TaoToken Key export ANTHROPIC_API_KEY你的TaoToken Key保存后source ~/.zshrc。然后配 Claude Code 自己的 settings 文件。路径是~/.claude/settings.json如果目录不存在就手动建mkdir -p ~/.claude写入以下 JSON{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key, ANTHROPIC_API_KEY: 你的TaoToken Key }, model: claude-sonnet-4-5 }注意三件套要齐全Base URL 是https://taotoken.net/apiKey 是你从 api-keys 页面复制的Model ID 填claude-sonnet-4-5或者你在模型对话页面确认可用的其他模型 ID。三个缺一个请求就会失败。如果你用的是 Codex 那套工具链配置写在~/.codex/auth.json结构类似把 base_url 和 api_key 换成 TaoToken 的值即可。Cline 或者 MCP 场景下Base URL 同样填https://taotoken.net/apiKey 和 Model ID 按上面填。4. 验证请求一次真实调用确认通道连通配置写完不代表通了必须发一次真实请求验证。有两种方式建议都做一遍。第一种用 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-sonnet-4-5, max_tokens: 64, messages: [{role: user, content: 说一句你好}] }如果返回 JSON 里带content字段和一段文本说明通道完全通了。如果返回 401是 Key 不对返回 404是 Base URL 多写了路径返回 400多半是 model ID 写错。第二种直接在终端跑 Claude Codeclaude进入交互界面后输入一句「你好帮我列一下当前目录的文件」看它能不能正常回话并调用工具。能回话就说明环境变量和 settings 都生效了。验证通过后你可以去 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 对照一下模型列表确认你用的 model ID 在可用范围内。如果后面要换模型改 settings.json 里的model字段就行不用重装任何东西。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞上的几个报错我按真实遇到的顺序列出来对照着查。401 Unauthorized。这个最常见原因就三个Key 复制错了、Key 前后带了空格、或者环境变量没生效。先echo $ANTHROPIC_AUTH_TOKEN看值对不对注意别把 Key 打印到公开日志里。如果环境变量对但还报 401检查 settings.json 里的 Key 是不是旧值两个地方要一致。local proxy failed / connection refused。这个报错说明 Claude Code 尝试连的地址根本不通。九成是ANTHROPIC_BASE_URL写错了比如写成了https://taotoken.net/api/带尾斜杠或者写成了https://taotoken.net少了/api。正确值就是https://taotoken.net/api一个字符都别多。改完记得重开终端。reading choices 相关报错。这个通常出现在用 OpenAI 兼容格式调用的场景里说明返回结构跟预期对不上。Claude Code 走的是 Anthropic 协议端点路径是/v1/messages不是/v1/chat/completions。如果你在 Cline 或 MCP 里配确认选的协议类型是 Anthropic 而不是 OpenAI。OAuth 相关报错。Claude Code 某些版本会尝试走 OAuth 登录流程如果你已经用 Key 认证要把 OAuth 相关配置关掉。检查 settings.json 里有没有残留的oauth字段有就删掉。另外确认没有同时设ANTHROPIC_AUTH_TOKEN和某个 OAuth token两者冲突会报错。node 版本过低。报错里会明确写requires node 18之类。跑node -v确认低于 18 就nvm install 24 nvm use 24然后重开终端。command not found: claude。brew cask 装完有时 PATH 没刷新执行brew --prefix找到安装路径手动加进 PATH或者直接用 npm 全局装一遍。排查的核心思路就一条先确认网络能到端点curl 测再确认 Key 有效网页端试最后确认配置三件套齐全Base URL Key Model ID。这三层任何一层断了都会报错按顺序查最快。6. 配好之后怎么用把通道用起来的几个实际建议通道打通之后Claude Code 能干的事情比你想的多。它不只是聊天能直接读写你当前目录的文件、跑 git 命令、执行测试。比如你cd到一个项目目录再敲claude然后说「帮我看下这个项目的依赖有没有过期」它会自己去读 package.json 然后给建议。日常使用有几个小技巧。第一把常用的 model ID 固定在一个 settings 里别每次手动改。第二如果做长期编码任务去 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 看下套餐比按量省心。第三请求日志在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 能查出问题先看日志里的状态码和错误信息比瞎猜快。配置文档放在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到没覆盖到的场景可以去翻。Key 管理在 https://taotoken.net/api-keys 建议定期轮换别一个 Key 用到底。最后说个我踩过的坑改完 settings.json 之后一定要完全退出 Claude Code 再重开它不会热加载配置。我有一次改完直接在里面敲命令怎么都不生效折腾了二十分钟才发现是没重启。重开之后一切正常。