CC 开源版完整安装部署指南

CCClaude-Code-Compiled开源版完整安装部署指南前言CCClaude-Code-Compiled是一款基于 Claude 生态的轻量化命令行代码助手工具基于 Bun 运行时实现高效编译与执行。本文将手把手带你完成环境依赖安装 → 项目构建 → 环境配置 → 启动运行全流程新手也能快速部署成功。一、环境准备服务器推荐使用Ubuntu/Debian 系统全程基于命令行操作无需图形化界面。1. 安装解压工具 unzip项目部署需要解压相关文件先安装 unzip 依赖apt install unzip -y2. 安装 Bun 运行时CC 基于 Bun 构建执行以下命令一键安装 Buncurl -fsSL https://bun.sh/install | bash安装完成后Bun 会自动配置环境变量无需手动额外设置。二、项目克隆与构建1. 克隆开源仓库从 GitHub 拉取 CC 项目源码git clone https://github.com/roger2ai/Claude-Code-Compiled.git2. 进入项目目录cd Claude-Code-Compiled3. 安装项目依赖Bun 会自动安装所有依赖并自动生成存根、修补 Commander.js无需手动干预bun install4. 编译项目将源码编译为可执行文件指定 Bun 运行目标并输出到dist目录bun build shims/macro.ts src/main.tsx --targetbun --outdir./dist5. 打包为单文件合并编译后的文件生成最终可执行的单文件包# 合并编译文件 cat dist/shims/macro.js dist/src/main.js dist/bundle.js # 添加执行入口 echo if (typeof main function) main().catch(e { console.error(e); process.exit(1); }); dist/bundle.js三、环境变量配置1. 编辑 bashrc 配置文件通过 vim 编辑系统环境变量配置文件路径/root/.bashrcvim /root/.bashrc2. 添加 API 配置与命令别名在文件末尾添加以下内容务必替换为自己的实际信息# 配置 Anthropic 接口信息 export ANTHROPIC_BASE_URLhttps://api.minimaxi.com/anthropic export ANTHROPIC_MODELMiniMax-M2.7-highspeed export ANTHROPIC_API_KEY你的API密钥 # 配置快捷命令路径替换为项目 bundle.js 实际路径 alias claudebun /usr/Claude-Code-Compiled/dist/bundle.js注意alias后的路径必须是bundle.js的绝对路径可通过pwd命令查看项目实际路径。3. 刷新环境变量修改配置后执行命令让配置立即生效source /root/.bashrc四、启动与初始化配置关键步骤1. 第一次启动会报错属正常现象执行快捷命令启动 CCclaude重要提示第一次启动会触发官方引导程序没有代理会直接报错这是完全正常的无需担心。运行完成后系统会自动生成配置文件/root/.claude.json2. 关闭新手引导编辑自动生成的 CC 配置文件vim /root/.claude.json在文件顶部添加以下配置跳过官方引导hasCompletedOnboarding: true,添加后保存退出。3. 第二次启动正常运行重新执行启动命令即可正常进入工具claude4. 关键选择使用配置文件 API Key第二次启动后程序会询问你是否使用配置文件中的 API KEY默认选项否no你必须手动选择yes 并回车选择是⚠️如果选错了直接删除以下两个文件然后重新启动即可重置rm -rf /root/.claude.json /root/.claude claude至此CC 开源版已完成全部安装部署可直接使用claude命令快速调用工具常见问题排查提示bun: command not found重新执行 Bun 安装命令或重启终端刷新环境变量第一次启动报错正常现象无代理无法完成官方引导修改配置文件后即可解决启动失败检查bundle.js路径是否正确、API Key 是否填写无误接口调用异常确认ANTHROPIC_BASE_URL和ANTHROPIC_MODEL配置与服务商要求一致选错 API Key 选项删除.claude.json和.claude文件夹重启即可。总结核心依赖unzip解压Bun运行时一键安装即可构建关键通过bun build编译、合并文件生成bundle.js配置核心修改.bashrc配置 API 信息和快捷命令刷新后生效启动核心第一次启动报错正常会生成配置文件修改配置文件关闭引导第二次启动必须选 yes 使用配置文件 API Key选错删除配置文件重启即可重置。