Skip to content

快速开始

如果你正在搜索 Claude Code 安装教程、Claude Code 使用教程或 Claude Code 配置教程,或者想找一个更适合新手的 Claude Code 平替,Lucky Code 可以直接一键安装、登录即用。你不需要单独准备 API Key,也不需要先配置模型渠道、账单和充值流程;这些都可以在 Lucky Code 里完成管理。

Lucky Code 面向日常 AI 编程场景,提供终端 TUI 和网页 Web 工作台,价格实惠透明,部分渠道低至官方价格 1 折。

安装终端版 TUI

bash
curl -fsSL https://bridge.annealing.cn/install.sh | sh
powershell
iwr -useb https://bridge.annealing.cn/install.ps1 | iex

Windows 用户提示

如果安装后运行 lucky 报执行策略相关错误,请在 PowerShell 中先运行:

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新运行 lucky

兼容性

支持 macOS 10.15+、Windows 10+、Linux 和 WSL。Windows 没有 Git Bash 时,安装脚本会自动准备运行环境。

启动 TUI

安装完成后,在终端运行:

bash
lucky

首次启动时,如果当前未登录,TUI 会提示登录或注册。也可以在 TUI 中输入 /login 手动打开登录界面。

启动 Web 工作台

需要在浏览器中使用文件树、diff 预览和终端面板时,运行:

bash
lucky web

Lucky Code 会启动本地 Web 服务并打开浏览器。当前未登录时,页面会自动进入登录流程,完成后即可使用 Web 工作台。

下载桌面客户端

Lucky Code Desktop 可以连接本地或远程 Lucky Code,在独立窗口中使用完整 Web 工作台。桌面客户端与终端版 TUI 是并列的使用方式,可按需要选择。

当前桌面客户端版本为 v0.1.1

macOS 安装

下载完成后,可以在安装包所在目录运行:

bash
open Lucky-Code-Desktop-0.1.1-mac-arm64.dmg

打开镜像后,将 Lucky Code 拖入“应用程序”文件夹。

Debian / Ubuntu 安装

下载完成后,在安装包所在目录运行:

bash
sudo apt install ./Lucky-Code-Desktop-0.1.1-linux-amd64.deb

桌面客户端首次启动

  1. 安装并打开 Lucky Code Desktop。
  2. 选择本地连接并进入启动页面。
  3. 如果尚未安装 Lucky Code 内核,主按钮会显示“安装 Lucky Code 内核”;点击按钮并等待安装完成。
  4. 安装完成后,主按钮会切换为“打开 Lucky Code”;点击后客户端会自动进入与 Web 工作台相同的登录流程。
  5. 完成登录或注册后,即可直接在客户端窗口中使用 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 可指定安装目录:

bash
THKJ_INSTALL_DIR="$HOME/.local/share/lucky" curl -fsSL https://bridge.annealing.cn/install.sh | sh
powershell
$env:THKJ_INSTALL_DIR="D:\Lucky"
iwr -useb https://bridge.annealing.cn/install.ps1 | iex

关闭匿名安装统计

bash
LUCKY_DISABLE_TELEMETRY=1 curl -fsSL https://bridge.annealing.cn/install.sh | sh
powershell
$env:LUCKY_DISABLE_TELEMETRY="1"; iwr -useb https://bridge.annealing.cn/install.ps1 | iex

统计只包含系统、架构、安装阶段和成败,不包含邮箱、用户名、token 或项目路径。