1. 为什么 Claude Code 首次接入总卡在环境变量这一步Claude Code 是 Anthropic 推出的终端编程助手能直接在命令行里读文件、改代码、跑测试适合习惯在终端里干活的开发者。它默认走 Anthropic 官方通道但很多国内开发者在首次接入时会遇到同一个问题环境变量没配对或者配了不生效终端里敲claude之后要么报 401要么一直转圈要么提示找不到 API Key。我自己第一次配的时候在 macOS 上export完以为万事大吉结果新开一个终端窗口又失效了后来换 Windows 用setx写完没重开终端怎么试都不对。这些坑其实都不难但第一次踩上去确实会浪费不少时间。这篇教程聚焦 Claude Code 首次接入时的环境变量配置环节把ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两个关键变量讲透。你会看到 macOS/Linux 和 Windows PowerShell 两套写法、可复制的 settings 配置片段、逐条验证命令以及 401 报错的定位思路。目标很简单跟着走一遍一次配置跑通对话调用。适合谁看刚装好 Claude Code 想在终端里用起来的开发者之前配过但总是报错的需要在多台机器或多个项目里统一配置的。不需要你懂 Anthropic 协议细节照着填就行。核心检索词先明确Claude Code 接入配置、环境变量、ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY。这四个词贯穿全文你只要记住两个变量名剩下的都是填值的事。在开始之前先理清一个概念。Claude Code 通过两个环境变量识别请求出口和身份ANTHROPIC_BASE_URL告诉它请求发到哪里ANTHROPIC_API_KEY告诉它你是谁。这两个变量配对Claude Code 就能正常工作。配错任何一个都会在启动或首次请求时报错。下面按顺序来先拿 Key 和地址再设环境变量然后验证最后排错。2. TaoToken 前置准备拿到 Key 和 Anthropic 原生协议地址在配置环境变量之前你需要先准备好两样东西一个 API Key和一个 Anthropic 原生协议的接入地址。这两样都在 TaoToken 平台上获取。TaoToken 的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台。API 地址是 https://taotoken.net/api 注意这个地址不加 UTM 参数配置时直接用这个。具体操作步骤第一步登录 TaoToken 控制台找到 API Keys 管理页面。地址是 https://taotoken.net/console/api-keys 在这里新建一个 Key。新建的时候给它起个名字比如claude-code-mac或者claude-code-win方便以后区分是哪台机器在用。创建完成后复制这个 Key它就是你后面ANTHROPIC_API_KEY要填的值。这里有个安全提醒这个 Key 只显示一次复制后妥善保管。不要把它提交到 Git 仓库不要写在会被同步的配置文件里。如果不小心泄露了回控制台吊销重新生成一个就行。第二步确认 Claude Code 用的接入地址。Claude Code 走的是 Anthropic 原生协议对应的 base_url 形如https://taotoken.net/api/anthropic注意这里的关键点base_url 的域名和门户域名可能不一样。你注册、管理密钥、查用量是在 taotoken.net 这个门户上但实际请求走的地址以平台文档给出的为准。Claude Code 走 Anthropic 原生协议时通常直接用到/anthropic这一级即可不需要手动再加/v1。如果你不确定当前该填哪个地址可以打开 TaoToken 的接入文档页面 https://taotoken.net/doc 对照确认。文档里会给出当前推荐的 base_url 写法。第三步记下你的 Key 和地址准备进入环境变量配置环节。这里补充一个概念方便你理解后面为什么这么配。Claude Code 启动时会读取环境变量如果ANTHROPIC_BASE_URL存在它就把请求发到那个地址如果不存在就走默认的 Anthropic 官方地址。ANTHROPIC_API_KEY则是身份凭证每次请求都会带上。两个变量都配对请求才能正常发出并返回结果。如果你之前用过其他接入方式可能会看到ANTHROPIC_AUTH_TOKEN这个变量名。Claude Code 主要认ANTHROPIC_API_KEY但部分版本也兼容ANTHROPIC_AUTH_TOKEN。为了稳妥本文统一用ANTHROPIC_API_KEY。准备好 Key 和地址后就可以开始配置了。下面分 macOS/Linux 和 Windows 两套写法你按自己的系统选一套。3. 可复制配置macOS/Linux 与 Windows 的 settings 片段这一节给出可直接复制的配置片段。我按系统分开写你选自己对应的那套。配置的核心就是设置两个环境变量但临时设置和永久设置写法不同这里都说清楚。3.1 macOS / Linuxbash / zsh如果你只是想当前终端会话临时用一下直接 exportexport ANTHROPIC_BASE_URLhttps://taotoken.net/api/anthropic export ANTHROPIC_API_KEY你的TaoToken密钥这两行只在当前终端窗口有效关掉窗口就失效。适合快速测试。想永久生效把上面两行写进 shell 配置文件。zsh 用户写进~/.zshrcbash 用户写进~/.bashrcecho export ANTHROPIC_BASE_URLhttps://taotoken.net/api/anthropic ~/.zshrc echo export ANTHROPIC_API_KEY你的TaoToken密钥 ~/.zshrc source ~/.zshrc如果你用的是 bash把~/.zshrc换成~/.bashrc。写完 source 一下让配置立即生效。这里有个细节不要把 Key 直接写在会提交到 Git 的文件里。如果你想把配置放在项目里可以用.env文件并把它加入.gitignore或者用 direnv 这类工具按目录加载。最稳妥的还是写在用户级 shell 配置里。3.2 Windows PowerShell临时设置当前窗口有效$env:ANTHROPIC_BASE_URL https://taotoken.net/api/anthropic $env:ANTHROPIC_API_KEY 你的TaoToken密钥永久设置用setx写入用户环境变量setx ANTHROPIC_BASE_URL https://taotoken.net/api/anthropic setx ANTHROPIC_API_KEY 你的TaoToken密钥注意setx写完不会立即在当前窗口生效需要重开一个终端窗口。这是很多人踩的坑——写完 setx 直接在当前窗口敲claude发现还是旧值或者没值以为配置失败其实是没重开终端。3.3 用 settings 文件固化配置除了环境变量Claude Code 也支持通过 settings 文件配置。你可以在项目根目录或用户目录下创建.claude/settings.json写入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api/anthropic, ANTHROPIC_API_KEY: 你的TaoToken密钥 } }这个文件的好处是配置跟着项目走团队协作时可以统一。但要注意如果这个文件会被提交到 GitKey 就泄露了。所以要么把 Key 放在环境变量里、settings 文件只放 base_url要么把 settings 文件加入.gitignore。我个人的做法是base_url 写在 settings 文件里跟着项目走Key 放在用户级环境变量里。这样既统一了接入地址又不会泄露密钥。3.4 三件套对照表配置 Claude Code 接入本质上就是填对三样东西。下面这张表帮你对照配置项变量名值说明Base URLANTHROPIC_BASE_URLhttps://taotoken.net/api/anthropic请求出口地址API KeyANTHROPIC_API_KEY你的TaoToken密钥身份凭证Model ID由 Claude Code 内部指定claude-sonnet 等一般无需手动填Model ID 这一项Claude Code 会根据你选的模型自动带上通常不需要手动配置。如果你在 settings 里想指定默认模型可以加model: claude-sonnet-4-20250514这样的字段但首次接入先不用管跑通再说。配置写完后进入下一节验证。4. 验证请求变量生效检查与连通性测试配置写完不代表生效必须验证。这一节给出逐条验证命令从变量检查到实际请求一步步确认。4.1 检查环境变量是否生效macOS / Linuxecho $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEYWindows PowerShellecho $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY如果输出为空说明变量没设上。检查是不是写错了配置文件或者 setx 之后没重开终端。如果输出的是旧值说明有多个地方设置了同名变量后加载的覆盖了前面的需要排查 shell 配置文件的加载顺序。4.2 用 curl 测试连通性在启动 Claude Code 之前先用 curl 直接测一下地址通不通。这一步能帮你区分是网络问题还是配置问题。curl -X POST $ANTHROPIC_BASE_URL/v1/messages \ -H x-api-key: $ANTHROPIC_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 你好}] }如果返回一段 JSON里面有content字段和回复文本说明地址和 Key 都正确。如果返回 401说明 Key 有问题返回 404说明地址尾部路径有问题返回连接超时说明网络或地址域名有问题。Windows PowerShell 里 curl 是Invoke-WebRequest的别名写法不同。建议用 Git Bash 或者 WSL 来跑上面的 curl 命令更接近 Linux 环境。4.3 启动 Claude Code 并对话变量和连通性都确认后在项目目录里直接运行claude如果配置正确Claude Code 会进入交互界面。随便发一句「你好介绍下自己」能得到正常回复就说明通道打通了。你也可以让它读一个文件、改一行代码确认工具调用链路完整。比如读一下当前目录的 README.md总结一下这个项目是做什么的如果它能正确读取文件并给出总结说明文件读取和模型调用都正常。4.4 验证成功的结果长什么样成功的标志有三个一是claude能正常启动进入交互界面二是发消息能得到回复三是让它读文件能正确读取。三个都满足配置就算跑通了。如果只满足前两个第三个失败可能是工具调用权限或者路径问题跟接入配置无关单独排查即可。验证通过后你就可以正常用 Claude Code 干活了。如果遇到报错看下一节。5. 常见报错排查401、404、local proxy failed 怎么定位配置期报错大多集中在几个固定位置。这一节按报错类型给出定位思路你对照自己的报错找。5.1 401 报错Key 无效或没带上401 是最常见的报错意思是身份验证失败。可能原因有三个一是 Key 填错了。检查ANTHROPIC_API_KEY的值是不是完整复制了有没有多余空格。TaoToken 的 Key 一般是一串固定长度的字符复制时注意别漏字符。二是 Key 没生效。用echo $ANTHROPIC_API_KEY确认当前终端读到的值是不是你刚设的。如果为空说明变量没设上。三是 Key 被吊销或过期。回 TaoToken 控制台 https://taotoken.net/console/api-keys 检查这个 Key 的状态如果被禁用就重新生成一个。排查顺序先 echo 确认变量值再用 curl 直接测如果 curl 也 401就是 Key 本身的问题如果 curl 正常但 Claude Code 401就是 Claude Code 读取变量的方式有问题检查是不是有多个配置文件冲突。5.2 404 报错尾部路径拼错404 几乎都是 base_url 尾部路径的问题。这是新手最容易踩的坑。不同工具在拼接请求路径时逻辑不同有的会自动补/v1有的不会。Claude Code 走 Anthropic 原生协议时通常直接用到/anthropic这一级即可不需要手动再加/v1。如果你当前填的是https://taotoken.net/api/anthropic/v1试着去掉/v1如果填的是https://taotoken.net/api试着加上/anthropic。原则是404 先看尾部路径这一步能解决大多数配置期报错。5.3 local proxy failed本地代理干扰如果你看到local proxy failed或类似的代理相关报错说明系统里有代理设置干扰了请求。检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY、ALL_PROXY这些echo $HTTP_PROXY echo $HTTPS_PROXY echo $ALL_PROXY如果有值且你不需要代理可以临时清掉unset HTTP_PROXY unset HTTPS_PROXY unset ALL_PROXY然后重新启动 Claude Code 测试。如果清掉后正常说明是代理配置的问题需要根据你的网络环境调整。5.4 reading choices 报错响应格式异常reading choices这类报错通常出现在响应格式不符合预期时。可能原因是 base_url 指向了非 Anthropic 原生协议的地址返回了 OpenAI 格式的响应Claude Code 解析不了。确认你的 base_url 是 Anthropic 原生协议地址形如https://taotoken.net/api/anthropic。如果你填的是 OpenAI 兼容协议的地址就会出这个问题。5.5 OAuth 相关报错认证方式冲突如果你之前登录过 Anthropic 官方账号Claude Code 可能缓存了 OAuth 凭证跟环境变量里的 Key 冲突。排查方法是检查 Claude Code 的配置目录看有没有残留的登录状态。一般在~/.claude/目录下可以备份后清理再试。5.6 排查速查表报错最可能原因第一步排查401Key 无效/没生效echo 变量值curl 直测404base_url 尾部路径错检查 /anthropic 和 /v1local proxy failed代理环境变量干扰echo 代理变量unsetreading choices协议地址不对确认是 Anthropic 原生协议OAuth 报错官方登录缓存冲突清理 ~/.claude 缓存排查的核心思路是分层先确认变量生效再确认地址通最后确认 Claude Code 读取正常。一层层排除问题定位就快了。6. 配置跑通之后把接入固化下来并长期使用配置跑通只是第一步接下来要考虑怎么长期稳定地用。这一节说几个实用建议。第一把环境变量做成永久配置。macOS/Linux 写进~/.zshrc或~/.bashrcWindows 用setx。这样每次开终端都自动生效不用重复设置。如果你在多个项目里都用 Claude Code这一步能省不少事。第二团队协作时给每个成员分发独立 Key。在 TaoToken 控制台 https://taotoken.net/console/api-keys 为不同成员创建不同的 Key既方便按人核算用量也便于出问题时单独吊销某个 Key不影响其他人。这比所有人共用一个 Key 要安全得多。第三定期检查 Key 状态和用量。回控制台看看有没有异常调用如果发现某个 Key 用量突增可能是泄露了及时吊销重新生成。第四如果你需要长期跑编码任务或者 Agent 类工作流可以了解一下 Coding Plan。地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合需要稳定额度和长期使用的场景。第五验证模型能力或者快速试对话可以用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 不用配环境就能直接测。第六接入过程中遇到问题先查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 文档里有最新的地址写法和常见问题。需要管理 Key 就去 API Keys 页面 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后说一个我自己的习惯把 base_url 和 Key 分开管理。base_url 写在项目 settings 里跟着项目走Key 放在用户级环境变量里。这样换项目不用改 Key换机器也不用改项目配置。配置一次长期受用。如果你还没开始配现在就可以打开终端按第 3 节的片段填上两个变量然后跑第 4 节的验证命令。整个过程不超过五分钟跑通之后 Claude Code 就能稳定用起来了。