1. Ubuntu 20.04 上 Claude Code 接 MiniMax 的真实痛点如果你在 Ubuntu 20.04尤其是 Jetson AGX Orin 这类 ARM 设备上跑 Claude Code又想让它调用 MiniMax 模型大概率会卡在同一个地方Key 和环境变量散落各处。Claude Code 默认认的是 Anthropic 官方那套ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN而 MiniMax 有自己的 Anthropic 兼容端点一旦你同时还想接别的模型~/.bashrc里就会堆满互相覆盖的 export改一个忘一个最后连自己都搞不清当前生效的是哪个。这篇就聚焦一件事在 Ubuntu 20.04 本地用 TaoToken 的统一 Key 把 Claude Code 和 MiniMax 串起来并给出一份可以直接复制的settings.json骨架。适合谁手上有一台 Ubuntu 20.04 机器x86 或 ARM 都行、已经装了 Node.js、想让 Claude Code 稳定调用 MiniMax、又不想每次开终端都手动 export 一堆变量的人。整个过程不需要改系统代理也不需要动网络层配置纯本地文件 环境变量就能跑通。我试过在 Jetson 上直接照搬网上的 bashrc 方案结果换模型时得反复source后来改成settings.json集中管理才清爽。下面按「装客户端 → 配统一 Key → 写 settings.json → 验证 → 排障」的顺序走一遍。2. TaoToken 统一 Key把多模型入口收拢到一处先说清楚 TaoToken 在这里扮演什么角色。它提供的是一个统一的 API 入口和 Key 管理你不需要为每个模型单独记一套地址和密钥。对 Claude Code 来说只要把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址再用一把统一 Key 做鉴权后面具体调 MiniMax 还是别的模型由配置里的模型名决定。TaoToken 官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址注意这个不带 UTM直接用于配置https://taotoken.net/api你需要提前拿到两样东西一把 TaoToken 的 API Key以及确认你要用的 MiniMax 模型名比如MiniMax-M2.7这类。Key 在控制台的 API Keys 页面创建创建后只显示一次记得先存到安全的地方。注意Key 属于敏感凭证不要写进会提交到 Git 的文件里。下面示例里我用占位符sk-你的TaoTokenKey你替换成自己的即可。创建 Key 的入口在这里带 utm方便你直接跳https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档配置字段含义、模型名列表以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content把 Key 拿到手后先别急着写进 bashrc。我们分两层环境变量负责「连到哪、用什么身份」settings.json负责「Claude Code 的行为和模型选择」。这样职责清晰排障时也好定位。3. 可复制配置环境变量 settings.json 骨架3.1 安装 Claude Code 与基础依赖Ubuntu 20.04 自带的 Node 版本可能偏旧先确认 Node 版本建议 18node -v npm -v如果版本太低用 nvm 或 NodeSource 升级。确认没问题后全局安装 Claude Code国内网络可以走镜像源加速sudo npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完验证一下命令是否存在claude --version能打印版本号就说明客户端就位。顺手装个 nano后面改配置用得上sudo apt install nano -y3.2 环境变量指向 TaoToken 统一入口编辑~/.bashrcnano ~/.bashrc在文件末尾追加下面这段。核心是把 base url 指向 TaoTokentoken 用你的统一 Key# Claude Code 通过 TaoToken 统一入口接入 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoTokenKey export API_TIMEOUT_MS3000000 export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1保存退出CtrlO回车CtrlX然后立即生效source ~/.bashrc验证环境变量确实写进去了echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN第一条应输出https://taotoken.net/api第二条输出你的 Key。如果为空说明没 source 成功或者写错了文件。3.3 settings.json 骨架集中管理模型选择Claude Code 支持用settings.json覆盖模型相关配置位置通常在~/.claude/settings.json。先建目录再写文件mkdir -p ~/.claude nano ~/.claude/settings.json粘贴下面这份骨架把模型名换成你在 TaoToken 文档里确认的 MiniMax 模型标识{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoTokenKey, ANTHROPIC_MODEL: MiniMax-M2.7, ANTHROPIC_SMALL_FAST_MODEL: MiniMax-M2.7, ANTHROPIC_DEFAULT_SONNET_MODEL: MiniMax-M2.7, ANTHROPIC_DEFAULT_OPUS_MODEL: MiniMax-M2.7, ANTHROPIC_DEFAULT_HAIKU_MODEL: MiniMax-M2.7, API_TIMEOUT_MS: 3000000, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 } }这份骨架的用意是不管 Claude Code 内部按 Sonnet、Opus 还是 Haiku 去取模型最终都落到同一个 MiniMax 模型上避免它偷偷去请求官方端点。API_TIMEOUT_MS给大一点长任务不容易被掐断。提示settings.json里的env会覆盖同名环境变量。如果你两处都写了以settings.json为准。建议只保留一处避免自己绕晕。字段对照表方便你按需改字段作用建议值ANTHROPIC_BASE_URL请求入口https://taotoken.net/apiANTHROPIC_AUTH_TOKEN鉴权 Key你的 TaoToken KeyANTHROPIC_MODEL主模型MiniMax-M2.7ANTHROPIC_SMALL_FAST_MODEL轻量任务模型MiniMax-M2.7API_TIMEOUT_MS超时毫秒3000000CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关闭非必要外联14. 验证请求确认 Claude Code 真的调到了 MiniMax配置写完别急着开干先做一次最小验证。最直接的方式是让 Claude Code 跑一个简单请求观察它是否正常返回。先清理可能残留的旧缓存避免读到过期配置rm -rf ~/.claude/cache 2/dev/null然后启动claude进入交互界面后输入一句简单的话比如「用一句话说明你当前使用的模型」。如果配置正确你会看到它正常流式返回内容而不是报鉴权错误或连接超时。想更明确地验证走的是 TaoToken 入口可以在另一个终端看请求是否打到taotoken.net。或者用 curl 直接测一次 API 连通性确认 Key 和地址没问题curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoTokenKey \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: MiniMax-M2.7, max_tokens: 64, messages: [{role: user, content: ping}] }如果返回里带有正常的content字段说明 Key、地址、模型名三者都对得上。这一步过了Claude Code 里基本不会再有鉴权层面的问题。成功结果长这样终端里 Claude Code 正常进入对话输入问题后逐字返回curl 返回 JSON 且没有error字段。两者都通过就可以正常拿它写代码、改文件了。5. 本篇常见错排查配置过程中最容易踩的坑集中在下面几类对照着查基本能解决。报 401 / 鉴权失败九成是 Key 写错或没生效。先echo $ANTHROPIC_AUTH_TOKEN看值对不对再确认settings.json里没有旧 Key 覆盖。注意 Key 前后不要有空格复制时容易带上换行。报连接超时 / 无法访问检查ANTHROPIC_BASE_URL是不是写成了带路径的完整地址。这里应该只到https://taotoken.net/api不要自己拼/v1/messages。另外确认机器本身能正常访问外网。模型名不识别ANTHROPIC_MODEL填的模型标识必须和 TaoToken 文档里列出的完全一致大小写、连字符都不能差。填错会返回模型不存在之类的错误。改了配置没反应settings.json改完要重启 Claude Code 进程环境变量改完要source ~/.bashrc或重开终端。两者都改了却还读旧值多半是缓存清掉~/.claude/cache再试。ARM 设备上安装失败Jetson 这类 ARM 平台偶尔遇到原生模块编译问题优先用 npm 镜像源必要时确认 Node 版本是否匹配。装不上时先看 npm 报错的具体模块名。多份配置打架如果你之前按网上教程在 bashrc 里 export 过ANTHROPIC_*现在又写了settings.json两处会互相覆盖。建议只留一处把 bashrc 里旧的 export 注释掉。排障时如果拿不准字段含义直接翻接入文档最稳https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要重新生成或管理 Key去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content6. 长期编码与 Agent 场景的接入建议如果你只是偶尔在终端里问几句上面的配置足够了。但如果你打算把 Claude Code 当成日常编码主力或者跑长时间 Agent 任务有两点值得注意。一是 Key 的集中管理。TaoToken 的统一 Key 好处就在于你换模型时不用换 Key只改settings.json里的模型名即可。这样多项目、多模型切换时凭证只有一份泄露面也小。想验证不同模型的实际表现可以直接在模型对话里对比https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content二是长任务的稳定性。API_TIMEOUT_MS调大只是基础真正跑 Agent 时建议配合 Coding Plan 这类面向长期编码的额度方案避免中途因为额度或超时断掉https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content配置本身不复杂难的是把「入口、鉴权、模型选择」这三件事分清楚。环境变量管入口和身份settings.json管模型和行为各司其职出问题时你一眼就能定位是哪一层。Ubuntu 20.04 上这套跑通之后换机器基本就是复制两个文件的事。
