🚀 CCGO：我开发的 Claude Code 启动器，解决首次启动的各种报错
更新日期：2026.3.2
前言
最近在工作中推荐同事使用 Claude Code + 自定义模型 的方案来体验 AI 编程，但频繁遇到安装之后提示「地区不可用」或者「Invalid API key」的问题。主要原因还是环境变量设置失败，以及未跳过初始化流程的问题。
为了解决这些痛点，开发了 CCGO 一个轻量级的 Claude Code 启动工具。
🔗 项目地址
- GitHub: github.com/willflow/cc…
- NPM: www.npmjs.com/package/ccg…
❓ 为什么开发这个工具
痛点一：首次启动报错
安装官方 Claude Code 后，第一次运行 claude 命令时，经常会遇到：
- 🌐 网络连接失败，无法完成初始认证
- 🚫 提示「地区不可用」
- 🔑 Invalid API key 错误
这是因为 Claude Code 首次启动需要完成 Onboarding 流程，而网络问题会导致这一步失败。
痛点二：API 配置麻烦
想要使用自定义的 API 端点（比如代理服务或国内模型），需要手动设置环境变量：
export ANTHROPIC_BASE_URL="your_base_url"
export ANTHROPIC_AUTH_TOKEN="your_api_key"
每次切换都要重新设置，非常繁琐。
痛点三：多配置切换困难
如果你同时使用多个 API 服务（比如官方 API、代理服务、国内模型），切换时需要记住不同的环境变量配置，容易出错。
✨ CCGO 的解决方案
- ✅ 跳过初始认证：自动配置
hasCompletedOnboarding，避免卡在首次启动界面 - ✅ 环境变量注入：支持自定义 API 端点和密钥，启动时自动注入
- ✅ 多配置切换：支持多个 Profile 配置，轻松切换不同的 API 服务
📦 安装教程
安装 Claude Code
安装 Claude Code，-g 表示全局安装，遇到权限错误请添加 sudo 命令：
npm install -g @anthropic-ai/claude-code
国内镜像：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
安装 CCGO
npm install -g ccgo
⚠️ 重要：安装成功之后，执行
ccgo，之后都通过ccgo来启动 Claude Code！
🚀 快速开始
1. 初始化配置（必需）
ccgo init
这会配置 ~/.claude.json，设置 hasCompletedOnboarding: true，跳过官方的初次认证流程。
2. 配置环境变量（可选）
ccgo config
命令会输出共享配置文件路径和配置示例。按提示手动编辑该配置文件。
配置示例：
{
"profiles": {
"default": {
"ANTHROPIC_BASE_URL": "your_base_url",
"ANTHROPIC_AUTH_TOKEN": "your_api_key"
},
"kimi": {
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your_api_key",
"ANTHROPIC_MODEL": "kimi-k2.5"
}
}
}
3. 启动 Claude Code
ccgo
有多个 profile 时，会交互选择一个。
4. 无头模式执行任务
ccgo -p "执行xxx任务"
无头模式下如果有多个 profile，默认使用第一个 profile。
配置文件位置
配置文件存储在：
- macOS/Linux:
~/.config/cc-code-status/config.json - Windows:
%APPDATA%\cc-code-status\config.json
📖 命令一览
| 命令 | 说明 |
|---|---|
ccgo init | 【首次使用必须】 初始化配置，跳过初始认证 |
ccgo | 启动 Claude Code（多配置时交互选择） |
ccgo -p "任务" | Headless 模式执行任务 |
ccgo config | 查看配置文件位置和示例 |
ccgo config add | 添加新的模型配置 |
ccgo help | 显示帮助信息 |
ccgo -v | 显示版本号 |
🔄 多配置切换
你可以执行 ccgo config add 添加多个模型配置，便捷地切换不同的 API 服务：
