使用其他llm模型初次启动claude code如何绕过新用户登录onboarding?


最新版的 Claude Code(2026 年 4 月版本,如 2.1.9x 系列)在首次启动(onboarding)机制上加强了检查,导致单纯靠环境变量或 CC-Switch 写入 settings.json 经常无法完全绕过。这是因为 Claude Code 在启动时会优先检查 ~/.claude.json 文件中的 hasCompletedOnboarding 标志。如果这个文件不存在或该字段为 false,它就会强制进入 onboarding 流程(要求登录官方账号或完成初始设置),即使你已经在 ~/.claude/settings.json 里配置了其他家 的 ANTHROPIC_BASE_URL 和 Key,也会被忽略或后置处理(cc-Switch最新版绕过配置也不管用)。
最有效的方法是在cli里面使用node.js如下一键设置命令:
node --eval "
const fs = require('fs');
const path = require('path');
const homeDir = require('os').homedir();
const filePath = path.join(homeDir, '.claude.json');
let config = {};
if (fs.existsSync(filePath)) {
config = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
}
config.hasCompletedOnboarding = true;
fs.writeFileSync(filePath, JSON.stringify(config, null, 2), 'utf-8');
console.log('已设置 hasCompletedOnboarding = true');
"
执行完后,重启终端,再尝试运行 claude 即可直接进入。
post-image
此页面可能包含第三方内容,仅供参考(非陈述/保证),不应被视为 Gate 认可其观点表述,也不得被视为财务或专业建议。详见声明
  • 赞赏
  • 评论
  • 转发
  • 分享
评论
请输入评论内容
请输入评论内容
暂无评论