安装与启动
本指南将帮助你完成 Carry Code 的安装和首次启动。
| 操作系统 | 支持的架构 |
|---|---|
| macOS | ARM64 (Apple Silicon), x64 (Intel) |
| Linux | x64, ARM64, musl |
| Windows | x64 (PowerShell) |
macOS / Linux
Section titled “macOS / Linux”打开终端,复制粘贴以下命令:
curl -fsSL https://carrycode.ai/install.sh | sudo shWindows
Section titled “Windows”打开 PowerShell(右键开始菜单 → Windows PowerShell),复制粘贴:
irm https://carrycode.ai/install.ps1 | iex安装脚本会自动:
- 检测你的操作系统和架构
- 下载对应的二进制文件
- 验证文件完整性
- 安装到
/usr/local/bin(Linux/macOS)或当前目录(Windows)
安装完成后,在终端中输入:
carry --help如果看到帮助信息,说明安装成功!
Carry Code - Your AI Coding Agent
Usage: carry [options] 启动交互模式 carry --once "prompt" 单次执行模式 carry --help 显示帮助信息启动 Carry Code
Section titled “启动 Carry Code”在终端中输入:
carry首次启动时,会自动弹出设置向导,引导你完成基本配置:
- 选择语言 — 选择「中文」或「English」
- 选择主题 — 亮色或暗色主题,根据你的喜好选择
- 配置 AI 模型 — 选择一个服务商,输入你的 API Key

什么是 API Key?
Section titled “什么是 API Key?”API Key 就像一把钥匙,让你能够使用 AI 服务。大多数服务商都提供免费试用额度。
推荐的 AI 服务商
Section titled “推荐的 AI 服务商”| 服务商 | 特点 | 推荐理由 |
|---|---|---|
| DeepSeek | 性价比高 | 国内可直接访问,价格实惠 |
| OpenAI | GPT 系列 | 能力全面,国际领先 |
| Anthropic | Claude 系列 | 编程能力强,适合代码任务 |
| 阿里云 | 通义千问 | 国内服务,稳定可靠 |
如何获取 API Key?
Section titled “如何获取 API Key?”DeepSeek(推荐国内用户):
- 访问 https://platform.deepseek.com
- 注册账号
- 进入「API Keys」页面
- 点击「创建 API Key」
- 复制密钥备用
OpenAI:
- 访问 https://platform.openai.com
- 注册并登录
- 进入「API Keys」页面
- 创建新密钥
其他服务商:流程类似,注册后在设置中找到「API Keys」。
VSCode 插件(可选)
Section titled “VSCode 插件(可选)”如果你使用 VSCode,还可以安装 Carry Code 插件,获得更好的体验:
- 打开 VSCode
- 点击侧边栏「扩展」
- 搜索「carrycode」
- 点击安装
Q:安装失败怎么办?
Section titled “Q:安装失败怎么办?”- 检查网络连接
- 确认系统是否支持
- 尝试手动下载安装:访问 https://carrycode.ai/releases
Q:提示权限不足?
Section titled “Q:提示权限不足?”Linux/macOS 使用 sudo 运行安装脚本:
sudo sh install.shQ:如何更新到最新版本?
Section titled “Q:如何更新到最新版本?”在 Carry Code 中输入 /update,或者重新运行安装脚本。