mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-31 16:33:34 +08:00
c2cd615824
The site had drifted from the product. Every screenshot predated the v0.5.0 UI redesign, the reading experience shipped no search and no syntax highlighting, and a third of the pages were internal process artefacts — migration task lists addressed to agentic workers, a release runbook, a proposal marked "historical". Reorganise around the only two people who read this: someone getting the desktop app running for the first time, and someone reading the source. Five sections replace nine — start / desktop / im / cli / internals — and the pages that served neither reader are gone. Site rewrite: - Palette lifted from the desktop app's 「纸·墨·印」 themes, so the site and the product read as one thing. Light mirrors 纯白, dark mirrors 墨夜, and dark mode exists at all now. - Fonts are self-hosted. The old @import from Google Fonts is unreachable from mainland China, which left every heading in a fallback serif; it also only requested weight 600 while the CSS asked for 900, so Latin and CJK in the same heading disagreed. - Docs were shipped as one 968KB manifest downloaded on every page view. Split into a 32KB index plus one lazily imported chunk per page; the entry bundle is now 101KB gzipped. - Add search, syntax highlighting, per-route meta with canonical and hreflang, a sitemap, and an error boundary. Replace the 44vh mobile sidebar with a drawer. - Image dimensions are read at build time and written into the tag, so lazy images reserve their space instead of collapsing. Screenshots are recaptured from a real v0.5.0 build against a clean demo project, with tokens, QR codes and paired accounts redacted. The previous set is deleted rather than kept alongside. Routes follow file paths, so the restructure would have broken every inbound link; 37 old paths redirect, in both languages. The PR policy gate and CODEOWNERS also hardcoded docs/guide/contributing.md. Verified: check:docs 78 pages / 323 links / 0 problems, check:policy 127 pass. Walked every route at 1440 and 390 in both themes for overflow, contrast, keyboard reachability and focus management.
116 lines
3.6 KiB
Markdown
116 lines
3.6 KiB
Markdown
---
|
||
title: 安装与启动
|
||
nav_title: 安装与启动
|
||
description: 从源码运行 CLI：安装依赖、配置模型服务、在任意目录启动。
|
||
order: 0
|
||
---
|
||
|
||
# 安装与启动
|
||
|
||
CLI 是 Claude Code Haha 的内核，桌面端每个会话背后跑的都是它。如果你只想用图形界面，装桌面端就够了，见 [下载与安装](../start/install.md)；下面这些步骤是给需要终端交互、`--print` 脚本自动化，或者准备读源码、提 PR 的人看的。
|
||
|
||
CLI 目前只从源码运行，没有单独的安装包。
|
||
|
||
## 获取源码
|
||
|
||
先装好 [Git](https://git-scm.com/downloads) 和 [Bun](https://bun.sh)，然后：
|
||
|
||
```bash
|
||
git clone https://github.com/NanmiCoder/cc-haha.git
|
||
cd cc-haha
|
||
bun install
|
||
```
|
||
|
||
## 配置模型服务
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
编辑 `.env`，至少给出一种可用的认证方式、接口地址和模型。一个 Anthropic 兼容接口的最小配置是这样：
|
||
|
||
```ini
|
||
ANTHROPIC_AUTH_TOKEN=sk-example
|
||
ANTHROPIC_BASE_URL=https://provider.example.com/anthropic
|
||
ANTHROPIC_MODEL=provider-model
|
||
```
|
||
|
||
变量含义、认证头的区别、Azure 与其他协议的写法见 [环境变量](./env.md)。如果你已经在桌面端配好了服务商，CLI 会直接复用那份配置，不需要再写 `.env`。
|
||
|
||
不要把真实 API Key 提交到 Git，也不要在 Issue、截图或诊断附件里公开它。
|
||
|
||
## 启动并验证
|
||
|
||
macOS、Linux 或 Git Bash：
|
||
|
||
```bash
|
||
./bin/claude-haha
|
||
./bin/claude-haha -p "概括当前项目的目录结构"
|
||
```
|
||
|
||
Windows PowerShell 或 cmd：
|
||
|
||
```powershell
|
||
bun --env-file=.env ./src/entrypoints/cli.tsx
|
||
```
|
||
|
||
看到流式回复和工具调用，说明模型服务、项目目录和 CLI 已经连通。
|
||
|
||
## 在任意目录启动
|
||
|
||
`./bin/claude-haha` 只在仓库里能用。把它加进 `PATH`，就能在任何项目目录直接敲 `claude-haha`，CLI 会自动把当前工作目录当成项目根。
|
||
|
||
macOS 和 Linux 在 `~/.bashrc` 或 `~/.zshrc` 中添加：
|
||
|
||
```bash
|
||
# 方式一：加入 PATH（推荐）
|
||
export PATH="$HOME/path/to/claude-code-haha/bin:$PATH"
|
||
|
||
# 方式二：alias
|
||
alias claude-haha="$HOME/path/to/claude-code-haha/bin/claude-haha"
|
||
```
|
||
|
||
改完重新加载：
|
||
|
||
```bash
|
||
source ~/.zshrc # 或 source ~/.bashrc
|
||
```
|
||
|
||
Windows 的 Git Bash 同样在 `~/.bashrc` 中加 `PATH`：
|
||
|
||
```bash
|
||
export PATH="$HOME/path/to/claude-code-haha/bin:$PATH"
|
||
```
|
||
|
||
验证方式是换个目录再启动，然后问它「当前目录是什么」：
|
||
|
||
```bash
|
||
cd ~/your-other-project
|
||
claude-haha
|
||
```
|
||
|
||
### Windows 配 WSL 工具链
|
||
|
||
如果 `claude-haha` 跑在 Windows 或 Git Bash 里，而 Node、Python、uv、bun 这些工具装在 WSL 中，可以显式经 WSL 调用：
|
||
|
||
```bash
|
||
wsl -e bash -lc 'node --version && python3 --version'
|
||
```
|
||
|
||
检测到 `wsl` / `wsl.exe` 调用时，CLI 会自动设置 `MSYS2_ARG_CONV_EXCL=*`，避免 Git Bash 把 `/home/...` 这类 WSL 路径错误转换成 `C:/Program Files/Git/home/...`。
|
||
|
||
想让 Bash 工具默认进 WSL，启动前设置：
|
||
|
||
```bash
|
||
export CLAUDE_CODE_SHELL_PREFIX='wsl -e bash -lc'
|
||
```
|
||
|
||
Computer Use 控制的仍然是 Windows 桌面应用，WSL 内的命令行工具不需要写进 `computer-use-config.json`。只用 WSL 工具链、不需要桌面控制时，加 `--no-computer-use`，或在 设置 → Computer Use 里关掉它。
|
||
|
||
## 下一步
|
||
|
||
- [命令参考](./reference.md)：命令行参数、无头模式与恢复模式
|
||
- [环境变量](./env.md)：认证、模型与本地运行变量的完整清单
|
||
- [架构总览](../internals/index.md)：CLI、Server、桌面壳与 Adapter 的分工
|
||
- [参与贡献与质量门禁](../internals/contributing.md)：提 PR 之前要跑哪些检查
|