内容
# Carcará 代码
极简主义的 **Claude Code** IDE，具有 Lovable 的外观。三个面板，零杂乱：
1. **项目导航** — 每个项目一个图标（扫描根目录）。
2. **聊天** — 在该项目中与 Claude Code 对话（通过 Claude Agent SDK，`cwd` = 目录）。
3. **预览** — 检测 `dev`/`start` 脚本，启动服务器并显示嵌入式网站。如果已经运行，则不会再次启动。
## 下载（Windows）
在 **[Releases](../../releases)** 页面获取最新的安装程序。下载 `CarcaraCode-Setup-*.exe`，执行并完成。
> 首次执行时，Windows 可能会显示 SmartScreen 警告（“Windows 已保护您的电脑”），因为安装程序尚未签名。单击 **更多信息 → 仍然运行**。它是安全的 — 代码是开源的，您可以审核所有内容。
## 如何运行（从代码开始）
```bash
npm install
npm start
```
首次使用时，单击项目导航中的 **+** 以选择项目目录（默认为 `~/Documents/github`）。每个子目录都会变成一个图标。
## 要求
- 已安装 **Node.js**。
- 已安装并登录 **Claude Code**（终端中 `claude` 命令可用）— 聊天使用相同的身份验证。
## 注释（MVP）
- 聊天在 `bypassPermissions` 模式下运行，以实现“Lovable”（无需每次步骤确认）的流程。
- 预览通过读取开发服务器的输出（`http://localhost:PORT`）来检测端口。
- 项目状态（聊天/预览）在应用程序打开时保存在内存中。
- 如果从 Claude Code 终端打开，请在之前清除 `ELECTRON_RUN_AS_NODE`（`$env:ELECTRON_RUN_AS_NODE=$null; npm start`）— 该变量使 Electron 以纯 Node 模式运行。在普通终端中不需要。
## 如何贡献
欢迎任何帮助 — 错误、想法、翻译或代码。❤️
1. 打开一个 **[问题](../../issues)** 来描述错误或想法（或领取现有的一个）。
2. 进行 **fork**，创建分支（`git checkout -b 我的改进`）。
3. 使用 `npm install && npm start` 在本地运行以测试。
4. 记住：`src/` 中的编辑在 `npm run build` 后才会生效（应用程序从 `dist/` 加载）。
5. 打开一个 **拉取请求**，解释更改的内容和原因。
不需要完美 — 小而集中的拉取请求最容易审查和接受。
## 技术栈
Electron + React + Vite，CodeMirror（编辑器），xterm + node-pty（终端），Tailwind。
聊天与您已安装的 **Claude Code** 进行交互。
## 许可证
[MIT](LICENSE) © Ygor Andrade — 自由使用、修改和分发。
MCP 市场