---
title: Chord
description: 让 AI 编码体验从容下来——一个轻量、本地优先的终端 Coding Agent，稳定长期运行、模型组合可热切、脱离电脑时还能远程操控。
template: splash
hero:
  tagline: 让 AI 编码体验从容下来——稳定长期运行、模型组合可热切、脱离电脑时还能远程操控。
  actions:
    - text: 快速开始
      link: /chord/zh/quickstart/
      icon: right-arrow
      variant: primary
    - text: GitHub
      link: https://github.com/keakon/chord
      icon: external
      variant: minimal
---

import { Card, CardGrid } from '@astrojs/starlight/components';

## 为什么选 Chord

<CardGrid>
  <Card title="稳定长期运行" icon="document">
    Chord 会在长对话接近模型 token 上限前压缩早期内容，同时保留继续工作所需的信息。
  </Card>
  <Card title="网络状态全程可见" icon="rocket">
    模型调用过程中精确显示请求状态与已等待时间，再也不用猜「是不是卡住了」。
  </Card>
  <Card title="键盘优先、Vim 风格" icon="seti:vim">
    Insert / Normal 模式、消息搜索、完整 Vim 风格导航、模式切换自动切输入法。退出需连按两次。
  </Card>
  <Card title="模型组合热切换" icon="random">
    将模型分到可复用的池（`fast`、`thinking`、`cheap`），运行时用 `/models` 或 `Ctrl+P` 切换。运行时按池内顺序自动 fallback。
  </Card>
  <Card title="资源占用极低" icon="seti:powershell">
    低内存、低 CPU。macOS 上电源感知：工作时阻止系统休眠，空闲后自动放行。
  </Card>
  <Card title="可远程操控" icon="external">
    `chord headless` 提供 stdio JSON 控制面，配合 [chord-gateway](https://github.com/keakon/chord-gateway) 可从任意聊天平台操控，离开桌面也能在手机上用。
  </Card>
  <Card title="一键导入外部会话" icon="import">
    一条命令即可从 Claude Code、Codex、OpenCode 迁移。对话记录和工具调用自动转换，无缝恢复原有上下文。
  </Card>
</CardGrid>

## 三步上手

<CardGrid>
  <Card title="1. 安装" icon="seti:go">
    已安装 Go 1.26+ 时：

    ```bash
    go install github.com/keakon/chord/cmd/chord@latest
    ```

    未安装 Go 1.26+ 时，可从 [GitHub Releases](https://github.com/keakon/chord/releases) 下载预构建二进制，解压后把 `chord` 放到 `PATH` 中。
  </Card>
  <Card title="2. 先运行一次初始化向导" icon="seti:lock">
    在交互式终端里直接运行：

    ```bash
    chord
    ```

    如果缺少 `config.yaml`，Chord 会启动一次性的初始化向导。向导会创建最小可用的 `config.yaml`，必要时再创建 `auth.yaml`。

    如果你更希望手写 YAML，或需要不同的 provider / 模型配置，见[快速开始](/chord/zh/quickstart/)。
  </Card>
  <Card title="3. 在项目里启动" icon="rocket">
    ```bash
    cd my-project
    chord
    ```
    在某个项目中首次运行时，Chord 会按需创建 `.chord/`。
  </Card>
</CardGrid>

## 按任务找文档

<CardGrid>
  <Card title="快速启动" icon="rocket">
    安装、初始化 provider、运行 `chord doctor models`，然后发送第一个任务。
    [前往 →](/chord/zh/quickstart/)
  </Card>
  <Card title="配置模型" icon="document">
    Provider / auth schema，以及常见场景的可复制示例。
    [配置 →](/chord/zh/configuration/) · [示例 →](/chord/zh/examples/)
  </Card>
  <Card title="远程控制" icon="external">
    安全地通过 `chord headless` 和 chord-gateway 从其他入口操控本机 Chord。
    [前往 →](/chord/zh/headless/)
  </Card>
  <Card title="长任务" icon="random">
    用 `/loop` 和 `Done` 承接多步骤实现、验证和修复。
    [前往 →](/chord/zh/usage/#loop--持续执行模式)
  </Card>
  <Card title="扩展定制" icon="setting">
    Agents、skills、MCP、hooks、自定义 slash 命令。
    [定制 →](/chord/zh/customization/) · [Hooks →](/chord/zh/hooks/)
  </Card>
  <Card title="排障" icon="seti:log">
    启动、认证、模型、TUI、上下文和集成问题。
    [前往 →](/chord/zh/troubleshooting/)
  </Card>
</CardGrid>

## 接下来

<CardGrid>
  <Card title="CLI 参考" icon="setting">
    所有命令、子命令、flag——包括 `chord cleanup`、worktree、headless。
    [前往 →](/chord/zh/cli/)
  </Card>
  <Card title="配置与认证" icon="document">
    Provider、模型池、LSP、MCP、hooks——一张速查表覆盖完整 schema。
    [前往 →](/chord/zh/configuration/)
  </Card>
  <Card title="示例配置库" icon="seti:yml">
    最常见的 4 套场景，可直接复制粘贴的 `config.yaml`。
    [前往 →](/chord/zh/examples/)
  </Card>
  <Card title="Headless 集成" icon="external">
    在 Chord 之上构建 bot、网关、自动化脚本。
    [前往 →](/chord/zh/headless/)
  </Card>
</CardGrid>
