Unofficial Claude Code

https://github.com/user-attachments/assets/7299b965-da57-45c4-899a-0a1685ae4bdf

基于 Claude Code 分发产物恢复的非官方 TypeScript/TSX 源码工作区，并持续维护本地 CLI、Agent、Workflow、OpenAI/Codex 兼容和调试能力。

本项目不是 Anthropic 官方产品、官方源码分发或官方 Claude Code release，也未获得 Anthropic 背书。公开包只分发 launcher 与对应平台二进制，不包含本仓库源码。

作者与维护者

• 项目维护者：Esonhugh
• 原始产品与上游实现：Anthropic Claude Code
• 公开包：@esonhugh/claude-code

本仓库包含从公开 bundle/source map 恢复的上游代码和本地维护改动。上游归属与本地维护者身份应分别理解；完整本地变更以 CHANGELOG.md 为准。

项目概况

本项目主要用于：

1. 保存从 Claude Code 分发产物恢复的可读 TypeScript/TSX 源码树。
2. 提供可构建、可调试、可进行受控二次开发的本地 Claude Code CLI。
3. 维护 Agent、Workflow、OpenAI/Codex、交互终端和会话命令等扩展。
4. 保留恢复工程中的类型声明、stub 与 build shim，便于后续逐步替换或验证。
5. 通过 binary-only 流程发布非官方 launcher，不公开分发本仓库源码。

开发环境与产物

• 包管理器：Bun
• Node.js：>=18
• JavaScript 构建产物：dist/cli.js
• 本地 binary：built-claude

当前发布版本为 2.1.295；发布历史、具体变更和验收边界统一记录在 CHANGELOG.md。

安装与运行

方式一：安装公开 launcher

公开包会根据 process.platform 和 process.arch 加载对应的平台二进制 optional dependency：

bun add --global @esonhugh/claude-code
claude --version

公开包仅包含 launcher 和平台二进制，不包含恢复源码。当前 release workflow 的普通平台包覆盖 Linux x64、Linux arm64、macOS arm64 和 Windows x64；不应假设其他 OS/architecture 组合（例如 macOS x64）已有产物。Linux 还会构建 baseline x64 和 musl 验证产物，但 baseline 不作为普通 npm 平台包。若当前平台没有对应 binary package，launcher 会返回缺少平台包的错误。

方式二：从源码构建

git clone <repository-url>
cd claude-code
bun install
make build
./built-claude --version

make build 构建平台 binary，并生成根目录下的 built-claude。

只构建 JavaScript CLI：

bun run build
bun ./dist/cli.js --version
bun ./dist/cli.js --help

主要功能

每项功能的作用、配置写法与可选值、不同配置下的终端效果见对应文档；完整索引见 docs/features/，变更历史见 CHANGELOG.md。设置写入用户级或项目级 settings.json，使用时与现有 JSON 合并。

开发约定

修改 TypeScript 后至少运行：

bunx tsc --noEmit --pretty false
bun run build
bun run lint
bun run audit:missing
git diff --check

涉及 binary、CLI 入口或交互行为时，再运行：

make build
./built-claude --version
./built-claude --help

本项目仍包含恢复阶段的类型边界。修复类型时应优先使用精确 interface、discriminated union、unknown、assertion function 和 type guard，避免为消除局部错误而放宽全局核心类型。

技术文档（Ref）

入门与构建

• docs/README.md — 文档中心、分类和推荐阅读顺序。
• docs/features/ — 每项功能的说明、配置与终端效果。
• docs/guides/build.md — 环境要求、构建、运行、验证和故障排查。
• docs/guides/secondary-development.md — 恢复源码的二次开发流程与约束。
• docs/guides/recovery-workspace.md — 源码恢复背景、目录和恢复方法。
• docs/guides/agent-development.md — Agent、Tool、Hook 和 Plugin 入门。

架构

• docs/architecture/runtime-internals.md — CLI、REPL、查询循环、工具和 Agent 主链路。
• docs/architecture/agent.md — AgentTool、runAgent、前后台运行与恢复。
• docs/architecture/agent-team.md — Team、共享任务、消息和协调者生命周期。
• docs/architecture/workflow-orchestration.md — Workflow、Agent、Skill、Hook、权限和隔离。
• docs/architecture/plugin-marketplace.md — Plugin 与 Marketplace 模型。
• docs/architecture/agent-sdk-exports.md — Agent SDK 导出面和扩展 API。

SSH、Workflow、研究与历史

• docs/design/ssh-local-ui-coherence.md — SSH transcript、远端补全、settings/Auth 边界与交互一致性设计。
• docs/research/prompt-context-optimization.md — Prompt context 构成、精简结果、测量方法与剩余风险。
• docs/research/claude-mods.md — Mods 契约、生命周期、官方证据与本地兼容性边界。
• mods-test.md — Mods 收口测试方案、验收结果与证据索引。
• docs/design/workflow-runtime-parity.md — Workflow runtime parity 的行为和证据边界。
• docs/workflows/ — Workflow 示例、兼容性材料和测试 fixture。
• docs/research/ — 二进制分析、CCH、Workflow 和 Codex 对比研究。
• docs/archive/ — 已完成计划、测试计划和历史实施记录。
• CHANGELOG.md — 权威的本地变更与发布记录。

研究和归档文档描述的是特定时间点，不应直接视为当前行为保证；当前使用方法以 README、docs/features/ 和源码为准，历史与验收记录以 CHANGELOG 为准。

安全与适用范围

本仓库用于授权的研究、调试和二次开发。恢复或修改后的 binary 不应未经独立安全、遥测、更新和权限审查直接用于生产环境。

请勿提交 .env、~/.codex/auth.json、API key、OAuth token、cookie、证书或其他私有配置。涉及外部 provider、插件、MCP、Workflow 和自动化任务时，应先确认权限范围及其对本地或共享环境的影响。