快速开始
如果你正在搜索 Claude Code 安装教程、Claude Code 使用教程或 Claude Code 配置教程，或者想找一个更适合新手的 Claude Code 平替，Lucky Code 可以直接一键安装、登录即用。你不需要单独准备 API Key，也不需要先配置模型渠道、账单和充值流程；这些都可以在 Lucky Code 里完成管理。
Lucky Code 面向日常 AI 编程场景，提供终端 TUI 和网页 Web 工作台，价格实惠透明，部分渠道低至官方价格 1 折。
安装终端版 TUI
curl -fsSL https://bridge.annealing.cn/install.sh | shiwr -useb https://bridge.annealing.cn/install.ps1 | iexWindows 用户提示
如果安装后运行 lucky 报执行策略相关错误，请在 PowerShell 中先运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后重新运行 lucky。
兼容性
支持 macOS 10.15+、Windows 10+、Linux 和 WSL。Windows 没有 Git Bash 时，安装脚本会自动准备运行环境。
启动 TUI
安装完成后，在终端运行：
lucky首次启动时，如果当前未登录，TUI 会提示登录或注册。也可以在 TUI 中输入 /login 手动打开登录界面。
启动 Web 工作台
需要在浏览器中使用文件树、diff 预览和终端面板时，运行：
lucky webLucky Code 会启动本地 Web 服务并打开浏览器。当前未登录时，页面会自动进入登录流程，完成后即可使用 Web 工作台。
下载桌面客户端
Lucky Code Desktop 可以连接本地或远程 Lucky Code，在独立窗口中使用完整 Web 工作台。桌面客户端与终端版 TUI 是并列的使用方式，可按需要选择。
当前桌面客户端版本为 v0.1.0。
桌面客户端首次启动
- 安装并打开 Lucky Code Desktop。
- 选择本地连接并进入启动页面。
- 如果尚未安装 Lucky Code 内核，主按钮会显示“安装 Lucky Code 内核”；点击按钮并等待安装完成。
- 安装完成后，主按钮会切换为“打开 Lucky Code”；点击后客户端会自动进入与 Web 工作台相同的登录流程。
- 完成登录或注册后，即可直接在客户端窗口中使用 Lucky Code。
桌面客户端也支持连接远程 Lucky Code。选择远程连接并填写带访问 token 的 Lucky Web 地址即可；远程模式不需要在当前电脑安装 Lucky Code 内核。
如何选择
偏好终端操作时使用 TUI；希望通过浏览器访问时运行 lucky web；希望使用独立应用窗口时安装桌面客户端。
常用入口
进入 TUI、Web 工作台或桌面客户端后，可以使用以下常用命令：
| 你想做什么 | 命令 |
|---|---|
| 查看余额、用量和订单 | /billing |
| 充值 | /recharge |
| 开发票 | /invoice |
| 选择模型 | /model |
| 选择服务分组 | /channel |
| 恢复历史会话 | /resume |
| 导出会话 | /export |
| 导入会话 | /import |
| 压缩上下文 | /compact |
| 修改配置 | /config |
| 切换语言 | /language |
自定义安装位置
设置 THKJ_INSTALL_DIR 可指定安装目录：
THKJ_INSTALL_DIR="$HOME/.local/share/lucky" curl -fsSL https://bridge.annealing.cn/install.sh | sh$env:THKJ_INSTALL_DIR="D:\Lucky"
iwr -useb https://bridge.annealing.cn/install.ps1 | iex关闭匿名安装统计
LUCKY_DISABLE_TELEMETRY=1 curl -fsSL https://bridge.annealing.cn/install.sh | sh$env:LUCKY_DISABLE_TELEMETRY="1"; iwr -useb https://bridge.annealing.cn/install.ps1 | iex统计只包含系统、架构、安装阶段和成败，不包含邮箱、用户名、token 或项目路径。