结论:在服务器、容器或 CI 里跑 Claude Code,常见卡点是 npm 全局安装权限报错、环境变量在多 shell/SSH 会话间不持久、容器里每次重建都要重配。解法分别是改全局安装目录(或用官方原生安装方式绕开 npm)、把变量写进 ~/.bashrc/~/.zshrc 或 settings.json、以及把配置固化进镜像或流水线环境变量。适用条件:你在 Linux 服务器、Docker 容器或 CI 流水线上用官方 claude 命令行。
在 Linux 服务器上用 npm install -g 装 Claude Code,遇到 EACCES: permission denied 是最常见的一类报错。两种解法:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc验证方法(读者可自行跑):
claude --version # 能输出版本号即安装成功
which claude # 确认 PATH 指向的安装位置在当前 shell 里 export 了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,新开一个 SSH 会话或 tmux 窗口就失效、再次报 401——这是环境变量没做持久化,不是 Key 坏了。解法按场景分:
echo 'export ANTHROPIC_BASE_URL="你的接入地址"' >> ~/.bashrc # zsh 用户写 ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的Key"' >> ~/.bashrc
source ~/.bashrc
echo $ANTHROPIC_BASE_URL # 应输出接入地址settings.json(通常在 ~/.claude/ 下)配置,优先级独立于 shell 环境变量,多 shell 场景更稳。容器每次重建都丢配置、CI 每次任务都是全新环境,逐条解法:
ENV,或运行时用 -e 传入,配置随镜像固化:ENV ANTHROPIC_BASE_URL=你的接入地址
ENV ANTHROPIC_AUTH_TOKEN=你的Key注意:Key 写进镜像层有泄露风险,生产环境建议用 -e 或 secret 方式在运行时注入。
claude --version
echo $ANTHROPIC_BASE_URL # 为空说明 secret 没配对名字报错 | 在服务器 / 容器 / CI 里的高频原因 | 排查命令 |
|---|---|---|
401 | secret 名字拼错、token 带 shell 转义字符、订阅到期 |
|
404 | 模型 ID 拼写错,或接入地址被镜像默认值覆盖 |
|
connection error | 容器内 DNS 解析失败、CI runner 网络受限、代理干扰 | 在容器里 |
条件结论:
settings.json;ENV 固化接入地址 + 运行时注入 Key;claude CLI。选订阅制接入服务时,付费前先确认三件事:支付方式是否支持微信/支付宝、运营主体能否在公开企业信息库核验、退款条款是否公开可读。
ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写进 ~/.bashrc(zsh 用户写 ~/.zshrc),或改用 settings.json 配置。ENV,Key 在运行时用 -e 或 secret 注入,避免写进镜像层。echo $ANTHROPIC_AUTH_TOKEN 确认 secret 名字拼对、变量非空且完整,再确认订阅是否到期。利益披露:作者在做 Code2AI 的订阅接入服务,属于上面「订阅制接入服务」这一类。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。