CC 开源版完整安装部署指南
CC（Claude-Code-Compiled）开源版完整安装部署指南
前言
CC（Claude-Code-Compiled）是一款基于 Claude 生态的轻量化命令行代码助手工具，基于 Bun 运行时实现高效编译与执行。本文将手把手带你完成环境依赖安装 → 项目构建 → 环境配置 → 启动运行全流程，新手也能快速部署成功。
一、环境准备
服务器推荐使用Ubuntu/Debian 系统，全程基于命令行操作，无需图形化界面。
1. 安装解压工具 unzip
项目部署需要解压相关文件，先安装 unzip 依赖：
apt install unzip -y2. 安装 Bun 运行时
CC 基于 Bun 构建，执行以下命令一键安装 Bun：
curl -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 --target=bun --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/.bashrc）：
vim /root/.bashrc2. 添加 API 配置与命令别名
在文件末尾添加以下内容，务必替换为自己的实际信息：
# 配置 Anthropic 接口信息 export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic" export ANTHROPIC_MODEL="MiniMax-M2.7-highspeed" export ANTHROPIC_API_KEY="你的API密钥" # 配置快捷命令（路径替换为项目 bundle.js 实际路径） alias claude='bun /usr/Claude-Code-Compiled/dist/bundle.js'注意：alias后的路径必须是bundle.js的绝对路径，可通过pwd命令查看项目实际路径。
3. 刷新环境变量
修改配置后，执行命令让配置立即生效：
source /root/.bashrc四、启动与初始化配置（关键步骤）
1. 第一次启动（会报错，属正常现象）
执行快捷命令启动 CC：
claude重要提示：
第一次启动会触发官方引导程序，没有代理会直接报错，这是完全正常的，无需担心。
运行完成后，系统会自动生成配置文件：/root/.claude.json
2. 关闭新手引导
编辑自动生成的 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；
选错删除配置文件重启即可重置。