✅ Claude Code 跳过官方登录 + 代理配置成功经验

🎯 目标实现

在 Linux 服务器上安装 Claude Code，连接到国内代理，使用 DeepSeek 模型，无需官方 API Key。

---

📖 完整可复用步骤

第一步：安装 Claude Code CLI

# 用国内镜像加速（避免 npm 官方源慢）
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 验证安装
claude --version

第二步：创建 ~/.claude.json（跳过官方引导）

printf "{\n  \"hasCompletedOnboarding\": true\n}\n" > ~/.claude.json

为什么这样做：Claude Code 首次运行会强制登录 Anthropic 官方账号。设置这个标志让它跳过引导流程。

验证：

cat ~/.claude.json

第三步：创建 ~/.claude/settings.json（配置代理 + 模型）

mkdir -p ~/.claude

printf "{\n  \"env\": {\n    \"ANTHROPIC_AUTH_TOKEN\": \"[你的代理-API-Key]\",\n    \"ANTHROPIC_BASE_URL\": \"[代理服务的API端点]\",\n    \"ANTHROPIC_MODEL\": \"deepseek-v4-flash\"\n  }\n}\n" > ~/.claude/settings.json

三个关键配置：

• ANTHROPIC_AUTH_TOKEN: 代理服务提供的密钥（保密，不使用官方 Anthropic Key）
• ANTHROPIC_BASE_URL: 代理服务的 API 端点（保密，示例: https://xxxxx.io/v1）
• ANTHROPIC_MODEL: 要使用的模型名称（deepseek-v4-flash）

验证：

cat ~/.claude/settings.json

第四步：测试运行

claude --version    # 显示版本信息
claude -h          # 显示帮助文档

如果能正常输出，说明配置成功。

---

🔧 核心要点（防踩坑）

要点	说明
用 printf 不用 cat	printf 直接输出，cat <<EOF 容易转义错误
每步都验证	写完用 cat 查看文件内容，确保 JSON 格式正确
两个文件都要创建	一个控制登录跳过，一个控制 API 代理。缺一不可
保管好 API Key	不要提交到 Git，不要公开分享
模型名称要匹配	使用代理支持的模型名称

---

🚀 成功标志

运行以下命令，看到正常输出（不报错、不要求登录）：

$ claude --version
claude 2.1.128

📚 后续可选操作

安装其他工具：

npm install -g @getpaseo/cli --registry=https://registry.npmmirror.com

查看 Claude Code 的所有可用命令：

claude -h

---

💡 为什么这个方案有效

1. ✅ 跳过官方登录 — .claude.json 标记完成引导，不触发强制认证流程
2. ✅ 使用国内代理 — 通过代理中转，国内用户可直连
3. ✅ 无需官方 Key — 代理处理所有 API 转发，只需要代理提供的密钥
4. ✅ 支持国内模型 — DeepSeek 是国内大模型，速度快、成本低
5. ✅ 一次配置永久生效 — 写入 ~/.claude/ 后，后续所有 claude 命令都自动使用这个配置

---

📝 配置文件快速查阅

~/.claude.json 最少内容：

{ "hasCompletedOnboarding": true }

~/.claude/settings.json 最少内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "[你的API-Key]",
    "ANTHROPIC_BASE_URL": "[代理API端点]",
    "ANTHROPIC_MODEL": "deepseek-v4-flash"
  }
}

⚠️ 提示：将括号内的内容替换为你的代理服务信息

---

✨ 最终成就

• ✅ Claude Code CLI 成功安装
• ✅ 跳过官方登录引导
• ✅ 连接到国内代理服务
• ✅ 使用 DeepSeek 模型
• ✅ 可以直接在服务器上运行 claude 命令进行 AI 编程

所有配置一次性完成，无需重复设置。