1. 内网环境跑 Claude Code 的真实困境与离线安装思路
先说清楚这篇要解决什么问题。Claude Code 是 Anthropic 推出的终端级代码助手，能在命令行里读项目、改文件、跑测试，对日常写代码帮助很大。但它的默认工作方式依赖外网：安装脚本要从远端拉包，运行时要把请求发到远端模型服务。一旦你所在的环境是内网、安全实验室、合规隔离区，或者干脆就是一台不允许出网的开发机，默认流程直接卡死。
我试过的典型场景是这样的：目标机器能装 Node，能跑 npm，但 npm registry 指向内网私服，公网域名一律不通。这时候npm install -g @anthropic-ai/claude-code要么超时，要么报ETIMEDOUT、ECONNREFUSED。就算你手动把包塞进去，启动后它还是会去连默认的远端 endpoint，鉴权链路一样断。
所以离线安装要拆成两件事：一是把 Claude Code 本体和它的依赖完整搬到目标机，二是把它的请求出口改到一个内网可达、统一鉴权的通道上。第二件事正是 TaoToken 要承担的角色——它提供统一的 Key 和 API 通道，你只要把 endpoint 和鉴权配置指过去，Claude Code 就能在隔离环境里正常发请求。
这篇会交付可复制的离线包目录结构、环境变量与配置文件片段，以及断网后逐条验证的操作步骤。核心检索词就是 Claude Code 离线安装、内网部署、endpoint 与 auth.json 改造。适合谁：需要在无外网机器上部署 AI 编码助手的企业开发、运维，以及做安全隔离实验的同学。
需要提前说明的是，离线不等于把大模型权重搬到本地。Claude Code 本身是客户端，模型推理仍在服务端完成。所谓离线，指的是安装过程离线、依赖离线，而请求出口走内网可达的统一通道。这一点想清楚，后面的配置才不会跑偏。
2. TaoToken 前置准备：统一 Key 与 API 通道怎么接
在动手打包之前，先把通道这头准备好。TaoToken 的作用是给你一个统一的 API 入口和 Key 管理，Claude Code 这类工具只要把 Base URL 和 Key 指过来，就能复用同一套鉴权，不用在每个工具里各配一份。
第一步，拿到你的 API Key。打开控制台，进入 API Keys 页面创建或复制一个 Key。地址是 https://taotoken.net/console ，创建后先存到安全的地方，后面写进配置文件要用。
第二步，确认 API 入口地址。TaoToken 的 API 根地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数。Claude Code 走的是 Anthropic 兼容协议，所以 Base URL 要填到能对接 Anthropic 接口的那一层，具体以接入文档为准，文档在 https://taotoken.net/doc 。
第三步，选模型 ID。Claude Code 默认会用 Anthropic 的模型名，你在 TaoToken 侧要确认对应模型可用，把 Model ID 记下来。这一步别跳过，很多人配置完报model not found，就是 Model ID 没对上。
这里有个关键点：Claude Code 的鉴权不走普通的Authorization: Bearer，它读的是环境变量和auth.json。所以你要准备三件套——Base URL、Key、Model ID，分别落到环境变量和配置文件里。下面这张表先对照一下：
| 配置项 | 作用 | 落点 |
|---|---|---|
| Base URL | 请求出口地址 | 环境变量ANTHROPIC_BASE_URL |
| API Key | 统一鉴权凭证 | 环境变量ANTHROPIC_API_KEY或 auth.json |
| Model ID | 指定调用的模型 | 环境变量ANTHROPIC_MODEL |
如果你后续还要用 Coding Plan 做长期编码或 Agent 任务，可以在 https://taotoken.net/coding-plan 了解套餐，把额度规划好。前置准备做完，就可以进入离线打包环节了。
3. 可复制的离线包结构与配置文件片段
这一节是重点，直接给可复制的目录结构和配置片段。离线包的核心思路是：在有网机器上把所有依赖下全，打成压缩包，搬到目标机解压安装。
先看离线包目录结构，建议这样组织：
claude-code-offline/ ├── npm-global/ # 全局包缓存 │ └── @anthropic-ai/ │ └── claude-code/ ├── node-runtime/ # Node 运行时（如目标机没有） │ └── node-v20.x-linux-x64.tar.xz ├── config/ │ ├── settings.json # Claude Code 设置 │ └── auth.json # 鉴权配置 ├── install.sh # 离线安装脚本 └── README.md在有网机器上准备包缓存，用 npm 把包和依赖一起下到本地目录：
mkdir -p claude-code-offline/npm-global npm install -g @anthropic-ai/claude-code \ --prefix ./claude-code-offline/npm-global \ --cache ./claude-code-offline/npm-cache这样包和缓存都落在本地，整个目录拷走即可。目标机上不需要再联网。
接下来是配置文件。Claude Code 的设置文件放在用户目录下的.claude/settings.json，鉴权信息放在.claude/auth.json。先写 settings.json：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_MODEL": "你的ModelID" }, "permissions": { "allow": [] } }再写 auth.json，把 Key 放进去：
{ "apiKey": "你的TaoTokenKey" }注意路径要和实际一致：Linux/macOS 下是~/.claude/settings.json和~/.claude/auth.json，Windows 下是%USERPROFILE%\.claude\settings.json。如果你更习惯用环境变量，也可以不写 auth.json，直接在 shell 里导出：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="你的TaoTokenKey" export ANTHROPIC_MODEL="你的ModelID"三件套 Base URL、Key、Model ID 一个都不能少。写进 settings.json 的 env 段和写进 shell 环境变量效果类似，但配置文件更利于离线机器重启后保持。安装脚本 install.sh 可以这样写：
#!/usr/bin/env bash set -e PREFIX="$(pwd)/npm-global" export PATH="$PREFIX/bin:$PATH" mkdir -p "$HOME/.claude" cp config/settings.json "$HOME/.claude/settings.json" cp config/auth.json "$HOME/.claude/auth.json" echo "Claude Code 离线安装完成"把整个目录拷到目标机，执行bash install.sh，再把npm-global/bin加进 PATH，安装就完成了。整个过程不碰公网。
4. 断网后逐条验证安装与请求连通
装完不等于能用，必须逐条验证。下面这套步骤在完全断网的目标机上跑一遍，能定位到具体哪一环断了。
第一条，验证 Claude Code 本体能启动。执行：
claude --version能打印版本号，说明包和 Node 运行时没问题。如果报command not found，是 PATH 没配好，回到上一步把npm-global/bin加进 PATH。
第二条，验证配置文件被正确读取。执行：
cat ~/.claude/settings.json cat ~/.claude/auth.json确认 Base URL 指向https://taotoken.net/api，Key 和 Model ID 都在。这一步是排查鉴权问题的第一现场。
第三条，验证网络出口。虽然目标机不能出公网，但内网到 TaoToken 通道要通。用 curl 直接打接口：
curl -sS https://taotoken.net/api/v1/messages \ -H "x-api-key: 你的TaoTokenKey" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "你的ModelID", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}] }'返回里带content字段，说明通道和鉴权都通了。如果返回 401，是 Key 不对；返回 404，多半是路径或 Model ID 不对。
第四条，在 Claude Code 里发一个真实请求。进入任意项目目录，执行：
claude然后在交互里输入一句简单指令，比如让它解释当前目录的某个文件。能正常返回，说明端到端链路打通。这一步成功，离线部署就算完成。
第五条，验证断网状态。把目标机的公网出口彻底关掉（保留到 TaoToken 的内网路由），重复第四条。如果仍然能返回，说明你的请求确实走的是统一通道，没有偷偷回落到公网。
实测下来，最容易出问题的是第三条和第四条之间的落差：curl 通了但 Claude Code 不通，通常是 settings.json 里的 env 没生效，或者 shell 里又覆盖了旧的环境变量。排查时先env | grep ANTHROPIC看一眼当前生效的值。
5. 本篇常见报错排查：401、local proxy failed 与 reading choices
离线部署踩的坑比较集中，这里按真实报错逐条对照。
401 Unauthorized。最常见。原因有三种：Key 写错、Key 没被读到、请求头格式不对。先确认 auth.json 里的apiKey和你在控制台创建的一致；再确认 settings.json 的 env 段没有被 shell 环境变量覆盖。Claude Code 读 Key 的优先级是环境变量高于 auth.json，如果你之前 export 过一个旧 Key，它会优先用旧的。排查命令：
env | grep ANTHROPIC_API_KEY有输出就说明环境变量在起作用，把它清掉再试。
local proxy failed。这个报错通常出现在你给 Claude Code 配了本地代理，但代理进程没起来或端口不对。离线环境里如果不需要代理，就把相关环境变量清掉：
unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy注意，这里说的是清掉本地代理配置，不是让你去搭什么通道。离线部署的原则就是请求直接走内网可达的统一入口，中间不要挂多余的东西。
reading choices 相关报错。这类报错一般出现在响应体解析阶段，说明请求发出去了但返回结构不符合预期。常见原因是 Base URL 填错了层级，比如把/api写成了/api/v1，导致路径拼接后多了一层。回到 settings.json，确认ANTHROPIC_BASE_URL就是https://taotoken.net/api，不要自己加后缀。
OAuth 相关报错。Claude Code 某些版本会尝试走 OAuth 登录流程，离线环境下这个流程走不通。解决办法是强制用 API Key 模式，确保 auth.json 存在且apiKey有效，同时不要在交互里触发登录命令。如果它提示要登录，检查是不是 auth.json 路径不对——Windows 上很容易把文件放到错误目录。
model not found。Model ID 没对上。回到 TaoToken 侧确认可用模型名，填进ANTHROPIC_MODEL。这个错误和鉴权无关，纯粹是名字问题。
排查顺序建议固定下来：先claude --version确认本体，再env | grep ANTHROPIC确认变量，再 curl 确认通道，最后进交互确认端到端。按这个顺序走，基本不会绕圈。
6. 把通道固定下来：长期编码与后续接入
离线部署做完，接下来要考虑的是长期可用。Claude Code 在隔离环境里跑起来之后，所有请求都通过 TaoToken 的统一 Key 和 API 通道出去，这意味着你只需要维护一份鉴权配置，不用在每个工具里重复填。
如果你打算把它用在日常编码或 Agent 任务上，建议把额度规划好，Coding Plan 页面在 https://taotoken.net/coding-plan ，可以先了解再决定。需要重新生成或轮换 Key 时，回到 https://taotoken.net/api-keys 操作，换完 Key 记得同步更新目标机的 auth.json。
接入细节和协议兼容性以官方文档为准，文档入口是 https://taotoken.net/doc 。如果只是想先验证模型对话是否正常，可以用 https://taotoken.net/models 快速试一条请求，确认通道没问题再往离线机器上搬。
最后给一个实用技巧：把离线包里的 settings.json 和 auth.json 做成模板，Key 用占位符，每次部署时用脚本替换。这样多台隔离机器部署时不会把 Key 写死在包里，轮换也方便。整个流程的核心就一句话——安装离线，出口统一，三件套 Base URL、Key、Model ID 对齐，剩下的就是按验证步骤逐条确认。
