10分钟上手coldcard-airgap从安装到第一条cc-tool命令的零基础教程【免费下载链接】coldcard-airgapOffline utilities for Coldcard hardware wallet users: PSBT inspection, BIP39/dice entropy, Seed XOR split/combine, BBQr encode/decode, output descriptors, and firmware verification guidance. Companion to official Coldcard firmware. Not affiliated with Coinkite.项目地址: https://gitcode.com/gh_mirrors/co/coldcard-airgapcoldcard-airgap 是一款面向 Coldcard 硬件钱包用户的免费开源离线工具集Offline Toolkit提供 PSBT 检查、骰子熵与 BIP39 助记词操作、Seed XOR 拆分/合并、BBQr 编解码、输出描述符生成与固件验证指引等能力。安装后只需一条cc-tool命令入口即可在本地离线机器上完成这些操作。本教程面向零基础新手带你从克隆仓库、环境检查到运行第一条cc-tool命令10 分钟跑通全流程。一、认识 coldcard-airgap5 个核心命令一览这套工具全部本地运行不需要把你的私钥、种子交给任何在线服务。安装后你会得到一个统一的cc-tool入口命令它背后由 5 个子命令组成子命令功能典型场景psbt-inspect离线解析 PSBT输入、输出、手续费、脚本类型与风险提示在隔离机上审查待签名交易seed-ops骰子熵、BIP39 生成/校验、Seed XOR 拆分/合并用骰子掷种子、校验助记词bbqrBBQr 分段编码/解码配合 Coldcard Q 的 QR 传输descriptor生成和解释常用输出描述符搭建 descriptor 钱包verify-fw固件版本验证指引与熵建议检查固件升级后核查 项目与官方 Coldcard 固件是伴侣关系独立社区维护与 Coinkite 无隶属关系。所有核心工具均可在断网环境下工作。二、环境准备2 分钟确认你的电脑在动手安装前先确认两件事可跳过出问题再回来查Python 版本需要 Python 3.10 或更高python3 --version查看三个依赖包click、embit、base58会随安装自动处理无需手动安装。仓库自带了一个环境检查脚本 scripts/check_environment.sh它会依次检查 Python 版本、依赖包以及cc-tool是否可用安装前后各跑一次心里就有底了。三、三条命令完成安装最快配置方法第 1 步克隆仓库git clone https://gitcode.com/gh_mirrors/co/coldcard-airgap cd coldcard-airgap第 2 步创建并激活虚拟环境python3 -m venv .venv source .venv/bin/activate # Windows 用户.venv\Scripts\activate第 3 步安装工具包pip install -e .完成后cc-tool命令就注册好了。依赖清单见 requirements.txt项目配置见 pyproject.toml。四、运行第一条 cc-tool 命令激活虚拟环境后输入cc-tool info看到类似下面的输出就说明安装成功了 Coldcard Airgap Toolkit v0.1.0 Offline utilities for Coldcard hardware wallet users. Commands: psbt-inspect Analyze a PSBT offline seed-ops Dice entropy, BIP39, Seed XOR, seed derivation bbqr Encode / decode BBQr parts descriptor Create or describe output descriptors verify-fw Firmware verification guidance再运行cc-tool --help可以查看完整参数说明。命令入口定义在 src/coldcard_airgap/launch.py各子命令的具体实现在 src/coldcard_airgap/cli.py。五、5 分钟体验每个命令跑一个例子1️⃣ 离线检查一份 PSBT仓库里带了一份示例数据data/sample_psbt_base64.txt配套说明见 data/sample_psbt_notes.txt可以直接用 Base64 参数解析cc-tool psbt-inspect --b64 cHNidP8BAHUCAAAA...有 PSBT 文件时也可以直接cc-tool psbt-inspect transaction.psbt报告里会列出每个输入的金额、输出的地址与脚本类型、总手续费并给出风险提示——这正是离线审查交易的核心用途详细流程参考 docs/psbt-review.md 与 docs/airgap-workflow.md。2️⃣ 校验一份助记词cc-tool seed-ops check --mnemonic abandon abandon ... about它会检查词表成员和 BIP39 校验和适合验证你在纸上抄写的单词是否完整无误。3️⃣ 骰子熵估算纯练习安全无副作用cc-tool seed-ops entropy-est --rolls 99 cc-tool seed-ops dice --rolls 1,5,3,6,2,4 --bits 256相关背景与推荐做法如 24 词建议至少 99 次骰子掷出见 docs/entropy-notes.md 和 examples/dice_to_coldcard.md。4️⃣ BBQr 编码/解码cc-tool bbqr encode --file transaction.psbt --type P cc-tool bbqr decode --data B$ZP0100...|B$ZP0101...用 Coldcard Q 扫码传输交易时BBQr 会把文件切成可扫描的二维码段原理笔记在 docs/bbqr-notes.md。5️⃣ 生成输出描述符cc-tool descriptor make --xpub xpub... --type p2wpkh --fingerprint abcd1234 cc-tool verify-fw --version 5.6.0 --model mk描述符与固件验证的更多说明分别在 docs/multisig.md 和 docs/firmware-verification.md。六、新手常见问题速查踩坑指南❓cc-tool: command not found虚拟环境没有激活或没有执行pip install -e .。重新激活后检查pip show coldcard-airgap-toolkit是否安装成功。❓ Windows 上激活不了虚拟环境Windows 的激活路径是.venv\Scripts\activate注意是反斜杠。❓ PSBT 解析报embit library required缺少embit库在虚拟环境里执行pip install embit即可。❓ 输出的风险提示看不懂对照 docs/security-notes.md 与 docs/security.md 逐项理解签名前务必在 Coldcard 屏幕上核对地址与金额。七、安全须知新手必读 ⚠️永远不要把真实种子输入联网电脑。所有涉及真实种子的操作都应在完全隔离、可信的离线机器上进行助记词与 BIP39 助记词短语的管理细节见 docs/seed-management.mdSeed XOR 份额拆分适合学习理解真实资金备份建议以 Coldcard 官方设备实现为准签名前地址、金额、手续费一律以 Coldcard 屏幕显示为准。八、总结与下一步到这里你已经完成了克隆仓库 → 虚拟环境安装 → 运行cc-tool info→ 体验五大核心命令。接下来推荐按 examples/basic_workflow.md 走一遍完整流程在线机生成 PSBT → 离线机cc-tool psbt-inspect审查 → 导入 Coldcard 签名 → 广播交易10 分钟上手离线安全从此触手可及。✅【免费下载链接】coldcard-airgapOffline utilities for Coldcard hardware wallet users: PSBT inspection, BIP39/dice entropy, Seed XOR split/combine, BBQr encode/decode, output descriptors, and firmware verification guidance. Companion to official Coldcard firmware. Not affiliated with Coinkite.项目地址: https://gitcode.com/gh_mirrors/co/coldcard-airgap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考