CC（Claude-Code-Compiled）开源版完整安装部署指南

前言

CC（Claude-Code-Compiled）是一款基于 Claude 生态的轻量化命令行代码助手工具，基于 Bun 运行时实现高效编译与执行。本文将手把手带你完成环境依赖安装 → 项目构建 → 环境配置 → 启动运行全流程，新手也能快速部署成功。

一、环境准备

服务器推荐使用 Ubuntu/Debian 系统，全程基于命令行操作，无需图形化界面。

1. 安装解压工具 unzip

项目部署需要解压相关文件，先安装 unzip 依赖：

apt install unzip -y

2. 安装 Bun 运行时

CC 基于 Bun 构建，执行以下命令一键安装 Bun：

curl -fsSL https://bun.sh/install | bash

安装完成后，Bun 会自动配置环境变量，无需手动额外设置。

二、项目克隆与构建

1. 克隆开源仓库

从 GitHub 拉取 CC 项目源码：

git clone https://github.com/roger2ai/Claude-Code-Compiled.git

2. 进入项目目录

cd Claude-Code-Compiled

3. 安装项目依赖

Bun 会自动安装所有依赖，并自动生成存根、修补 Commander.js，无需手动干预：

bun install

4. 编译项目

将源码编译为可执行文件，指定 Bun 运行目标并输出到 dist 目录：

bun build shims/macro.ts src/main.tsx --target=bun --outdir=./dist

5. 打包为单文件

合并编译后的文件，生成最终可执行的单文件包：

# 合并编译文件
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/.bashrc

2. 添加 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. 第二次启动（正常运行）

重新执行启动命令，即可正常进入工具：

claude

4. 关键选择：使用配置文件 API Key

第二次启动后，程序会询问你：

是否使用配置文件中的 API KEY？

• 默认选项：否（no）

• 你必须手动选择：yes 并回车，选择是

⚠️ 如果选错了：

直接删除以下两个文件，然后重新启动即可重置：

rm -rf /root/.claude.json /root/.claude
claude

至此，CC 开源版已完成全部安装部署，可直接使用 claude 命令快速调用工具！

常见问题排查

1. 提示 bun: command not found：重新执行 Bun 安装命令，或重启终端刷新环境变量；

2. 第一次启动报错：正常现象，无代理无法完成官方引导，修改配置文件后即可解决；

3. 启动失败：检查 bundle.js 路径是否正确、API Key 是否填写无误；

4. 接口调用异常：确认 ANTHROPIC_BASE_URL 和 ANTHROPIC_MODEL 配置与服务商要求一致；

5. 选错 API Key 选项：删除 .claude.json 和 .claude 文件夹重启即可。

---

总结

1. 核心依赖：unzip（解压）+ Bun（运行时），一键安装即可；

2. 构建关键：通过 bun build 编译、合并文件生成 bundle.js；

3. 配置核心：修改 .bashrc 配置 API 信息和快捷命令，刷新后生效；

4. 启动核心：

   • 第一次启动报错正常，会生成配置文件；

   • 修改配置文件关闭引导；

   • 第二次启动必须选 yes 使用配置文件 API Key；

   • 选错删除配置文件重启即可重置。