Claude Code

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.296；发布历史、具体变更和验收边界统一记录在 CHANGELOG.md。

安装与运行

方式一：安装公开 launcher

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

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

方式二：从源码构建

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

只构建 JavaScript CLI：

主要功能

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

开发约定

修改 TypeScript 后至少运行：

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

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

技术文档（Ref）

入门与构建

- docs/README.md — 文档中心、分类和推荐阅读顺序。
- docs/features/ — 每项功能的说明、配置与终端效果。
- docs/guides/build.md — 环境要求、构建、运行、验证和故障排查。
- docs/guides/secondary-development.md —…