window11开启wsl2后，把开发环境Base URL改到TaoToken的完整配置

1. WSL2 里改 Base URL 到底在改什么Windows 11 上装好 WSL2 和 Ubuntu 之后很多人第一反应是「我在 Windows 里配过环境变量了子系统里应该也能用吧」。实际并不是。WSL2 是一台跑在 Hyper-V 轻量虚拟机里的独立 Linux它有自己的文件系统、自己的 shell、自己的环境变量。你在 PowerShell 里setx的那些东西进到 Ubuntu 里echo $OPENAI_API_KEY大概率是空的。所以「把开发环境 Base URL 改到 TaoToken」这件事本质是在 WSL2 的 Ubuntu 内部让所有会发 HTTP 请求的 AI 编程工具把默认指向官方域名的请求统一改到https://taotoken.net/api这个入口。TaoToken 是一个兼容 OpenAI / Anthropic 接口规范的 API 聚合通道能做什么简单说就是你原来写https://api.openai.com/v1的地方换成 TaoToken 的地址Key 换成 TaoToken 发的 Key其余代码几乎不用动。适合谁适合在 WSL2 里跑 Claude Code、Cline、Codex CLI、Continue、Aider 这类工具又希望统一管理调用入口的开发者。我试过最省事的做法不是一个个工具去点设置而是先在子系统里把环境变量打通再让各工具去读。这样后面换工具、加工具都只改一处。下面按「先确认 WSL2 状态 → 配环境变量 → 写工具配置文件 → curl 验证 → 排错」的顺序走一遍每一步都能复制粘贴。先确认你确实在 WSL2 里而不是 WSL1。打开 PowerShellwsl -l -v输出里 VERSION 那列应该是 2。如果是 1执行wsl --set-default-version 2然后进 Ubuntu 子系统确认网络和基础工具在uname -a curl --versionuname -a里带microsoft-standard-WSL2就对了。curl 没有的话sudo apt update sudo apt install -y curl。这两步做完才轮到改 Base URL否则后面报错你分不清是网络问题还是配置问题。2. TaoToken 前置Key、Base URL 与 WSL2 环境变量落点在动手改配置之前先把三样东西准备好Base URL、API Key、Model ID。Base URL 用https://taotoken.net/api注意这里不带任何路径后缀具体到/v1还是/v1/messages由各工具自己拼。API Key 去控制台生成地址是 https://taotoken.net/api-keys 生成后复制出来只显示一次。Model ID 按你实际要用的模型填比如claude-sonnet-4-5或gpt-4o这类以控制台模型列表为准。WSL2 里环境变量有两个落点别搞混。一个是当前 shell 会话export一下只在当前终端有效关掉就没了。另一个是写进~/.bashrc或~/.zshrc每次开终端自动加载。我建议写进~/.bashrc因为 Ubuntu 默认就是 bash。如果你用的是 zsh换成~/.zshrc即可。先确认你当前 shellecho $SHELL然后编辑配置文件nano ~/.bashrc在文件末尾追加这几行# TaoToken 统一入口 export TAOTOKEN_BASE_URLhttps://taotoken.net/api export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥 export ANTHROPIC_MODELclaude-sonnet-4-5保存后source ~/.bashrc再验证echo $OPENAI_BASE_URL echo $ANTHROPIC_BASE_URL两个都输出https://taotoken.net/api就说明环境变量生效了。这里有个坑OPENAI_API_KEY和ANTHROPIC_API_KEY我填的是同一个 TaoToken Key因为 TaoToken 用一套 Key 兼容两种协议具体以你控制台看到的为准。如果你只用一个协议另一个可以不填。注意不要把 Key 直接写进会提交到 Git 的文件里。~/.bashrc是本机文件相对安全但如果你有 dotfiles 仓库记得把 Key 那行排除掉或者用单独的~/.env.local并在.gitignore里忽略。环境变量这层打通后很多工具会自动读取比如 Codex CLI 认OPENAI_BASE_URLClaude Code 认ANTHROPIC_BASE_URL。但有些工具只认自己的配置文件所以下一步要逐个写。3. 可复制配置settings.json、config.toml 与 auth.json 三件套这一节是核心给你可以直接复制的配置文件片段。路径都按 WSL2 Ubuntu 的默认位置写你照着建目录、贴内容就行。先说 Claude Code。它的配置在~/.claude/settings.json。如果目录不存在先建mkdir -p ~/.claude nano ~/.claude/settings.json贴入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 } }这里 Base URL、Key、Model ID 三件套齐全缺一个都可能报 401 或模型不存在。再说 Codex CLI。它的配置分两个文件~/.codex/config.toml和~/.codex/auth.json。先建目录mkdir -p ~/.codex nano ~/.codex/config.toml贴入model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api wire_api chat然后写 auth.jsonnano ~/.codex/auth.json{ OPENAI_API_KEY: sk-你的TaoToken密钥 }注意 config.toml 里的base_url和 auth.json 里的 Key 要对应同一个 TaoToken 账号否则会出现「Key 有效但模型列表为空」的怪现象。接着说 Cline 和 Continue 这类 VS Code 插件。它们通常在插件设置界面填 Base URL但也可以写进工作区的.vscode/settings.json或用户级 settings。以 Continue 为例配置在~/.continue/config.json{ models: [ { title: TaoToken Claude, provider: anthropic, model: claude-sonnet-4-5, apiBase: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥 } ] }Cline 的 MCP 配置如果涉及外部服务同样把 Base URL 指向 TaoTokenKey 用同一把。这里提醒一句MCP 直连生产数据库这种操作不要做配置里只放 API 通道别把数据库连接串塞进去。最后是 CC Switch 这类多环境切换工具。它的配置文件一般在~/.cc-switch/config.json结构类似{ current: taotoken, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5 } } }三件套Base URL Key Model ID在每一个配置文件里都要完整出现这是最容易漏的地方。很多人只改了 Base URL忘了 Model ID结果请求发出去返回「model not found」还以为是通道问题。4. 验证请求curl 打通与成功结果长什么样配置写完别急着开工具先用 curl 验证链路。这一步能帮你把「配置问题」和「工具问题」分开。验证 OpenAI 兼容接口curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $OPENAI_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o, messages: [{role: user, content: 只回复两个字通了}] }成功的话你会看到一段 JSON里面有choices数组message.content是「通了」。如果返回{error:{message:...,type:...}}那就是 Key 或模型的问题往下看排错节。验证 Anthropic 兼容接口curl -s https://taotoken.net/api/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-5, max_tokens: 64, messages: [{role: user, content: 只回复两个字通了}] }注意 Anthropic 协议用的是x-api-key头不是Authorization: Bearer这是两个协议的区别别搞混。成功返回里content数组第一项的text就是模型回复。两个 curl 都通了说明 WSL2 的网络、TaoToken 的 Key、Base URL、Model ID 全部正确。这时候再去开 Claude Code 或 Codex CLI如果还报错问题就在工具自己的配置读取上而不是通道。再补一个查模型列表的请求确认你的 Key 能看到哪些模型curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $OPENAI_API_KEY返回的data数组里就是可用模型 ID把你配置文件里的 Model ID 跟这个列表对一下能避免很多「模型不存在」的报错。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth排错这节按真实报错来你遇到哪个对哪个。401 Unauthorized。最常见。原因通常是 Key 没生效或写错。先在 WSL2 里echo $OPENAI_API_KEY看有没有值没有就是~/.bashrc没 source 或写错文件。有值但还 401检查 Key 前后有没有多余空格或换行复制的时候容易带上。再确认你用的是 TaoToken 控制台生成的 Key不是别处的。如果配置文件里也写了 Key确认配置文件的 Key 和环境变量一致。local proxy failed / connection refused。这个报错说明请求根本没发出去卡在本地。检查两点一是 Base URL 是不是写成了https://taotoken.net/api/带尾斜杠有些工具拼接路径时会变成双斜杠导致失败去掉尾斜杠二是 WSL2 的 DNS 或网络有问题试试curl -v https://taotoken.net/api/v1/models看卡在哪一步。如果是 DNS 解析失败在/etc/resolv.conf里确认 nameserver或者重启 WSLPowerShell 里wsl --shutdown再进。reading choices 相关报错比如cannot read property choices of undefined或reading choices。这是工具拿到了非预期响应通常是返回体里没有choices字段。原因可能是 Base URL 指错了路径比如把/v1重复拼了或者用 OpenAI 协议去请求了 Anthropic 的端点。检查你的工具用的是哪个协议OpenAI 协议走/v1/chat/completionsAnthropic 协议走/v1/messages别交叉。OAuth 相关报错比如提示要登录、要授权、token 过期。这类工具默认走 OAuth 登录流程你改成 API Key 模式后它还在尝试 OAuth。解决办法是在工具配置里显式关闭 OAuth或者删掉旧的凭据缓存。Claude Code 的凭据缓存在~/.claude/下Codex 在~/.codex/下把旧的 auth 文件备份后重建。如果工具支持--api-key启动参数直接用它覆盖。模型不存在 / model not found。对照第 4 节的模型列表请求确认 Model ID 拼写。注意大小写和连字符claude-sonnet-4-5和claude-sonnet-4.5是两回事。改了配置不生效。工具可能缓存了配置重启工具环境变量改了要新开终端或sourceVS Code 插件要重载窗口CtrlShiftP → Reload Window。排错时记住一个原则先用 curl 确认通道通再查工具。curl 通了工具不通一定是工具配置问题curl 都不通先解决网络和 Key。6. 把链路固定下来长期编码与 Agent 场景的收尾配置一次不难难的是长期用的时候不反复踩坑。我的做法是把 WSL2 里的环境变量和工具配置当成「基础设施」维护而不是每次临时改。具体来说~/.bashrc里的那几行 export 是总开关所有工具优先读它。工具自己的配置文件作为补充只在工具不认环境变量时才写。这样你换 Key 的时候只改~/.bashrc一处source一下所有工具都跟着变。如果你同时用多个 TaoToken 账号或多种模型可以在~/.bashrc里定义多组变量用的时候export切换或者用 CC Switch 这类工具管理多套配置。长期跑 Agent 任务的话建议单独开一个 WSL2 终端专门跑别和日常开发混在一起。Agent 会持续发请求日志量大混在一起不好排查。另外把 Base URL 和 Key 通过环境变量注入而不是硬编码在脚本里这样脚本可以进 GitKey 不会泄露。如果你还没生成 Key去 https://taotoken.net/api-keys 建一个接入细节和协议说明看 https://taotoken.net/doc 想先在网页里试模型通不通用 https://taotoken.net/chat 要长期跑编码和 Agent 任务看 Coding Plan 页面 https://taotoken.net/coding-plan 。把 WSL2 里的链路一次性打通之后后面换工具、加工具都只是往这套环境变量上挂不用再从头配一遍。