终端 AI 工具安装与使用指南

前言

除了 IDE 插件外，终端（命令行）中的 AI 工具也能大幅提升开发效率。它们可以帮你：

• 快速理解复杂命令的含义
• 自动生成 Shell 脚本
• 解释错误信息并提供解决方案
• 直接在终端内与 AI 对话解决问题

本教程将介绍几个常用的终端 AI 工具。

Claude Code - 智谱AI开放文档

快速开始--火山方舟大模型服务平台-火山引擎

一、Claude Code 终端工具

Claude Code 是什么

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，可以直接在终端中与 Claude 对话，进行代码开发、文件编辑、调试等操作。

安装前准备

Claude Code 需要 Node.js 环境。如果你还没有安装 Node.js，请参考《1.nodejs介绍.md》进行安装。

Claude Code 安装教程

方式一：使用 npm 安装

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

方式二：使用官方安装脚本（推荐）

macOS / Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

powershell -Command "iwr -useb https://claude.ai/install.ps1 | iex"

配置 Claude Code

1. 获取 API Key

1. 访问 https://console.anthropic.com/
2. 注册/登录 Anthropic 账号
3. 进入 API Keys 页面
4. 点击 "Create Key" 创建新的 API Key
5. 复制生成的 API Key（格式类似 sk-ant-...）

2. 配置 API Key

方式一：通过环境变量配置

# Windows (CMD)
set ANTHROPIC_API_KEY=sk-ant-your-api-key-here

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY="sk-ant-your-api-key-here"

# macOS / Linux (bash/zsh)
export ANTHROPIC_API_KEY="sk-ant-your-api-key-here"

# 永久保存（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export ANTHROPIC_API_KEY="sk-ant-your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

方式二：通过配置文件

Claude Code 首次运行时会引导你配置 API Key：

claude

按照提示粘贴你的 API Key 即可。

Claude Code 基础使用

启动 Claude Code

# 在当前目录启动
claude

# 指定工作目录
claude /path/to/your/project

启动后，你会看到一个交互式界面，可以直接输入问题或指令。

常用功能示例

1. 解释代码

请解释一下这个函数的作用：
def quicksort(arr):
    if len(arr) <= 1:
        return arr
    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]
    return quicksort(left) + middle + quicksort(right)

2. 生成代码

帮我写一个 Python 脚本，遍历当前目录下的所有 .txt 文件，
统计每个文件的行数，并输出行数最多的文件名。

3. 调试问题

我运行这段代码时报错了：ModuleNotFoundError: No module named 'requests'
请问如何解决？

4. 重构代码

这段代码可以优化吗？请让它更简洁易读：
result = []
for i in range(len(items)):
    if items[i] is not None:
        result.append(process_item(items[i]))

Claude Code 高级功能

文件操作

Claude Code 可以直接操作工作目录中的文件：

# 列出当前目录的文件
列出当前目录的文件

# 读取某个文件
读取 src/main.py 文件

# 创建新文件
创建一个名为 utils.py 的文件，包含常用的工具函数

# 编辑文件
在 app.js 中添加一个错误处理中间件

执行命令

Claude Code 可以帮你执行终端命令（需要确认）：

# 安装依赖
安装项目的 npm 依赖

# 运行测试
运行 pytest 测试

# 查看 git 状态
查看当前 git 状态

Slash 命令

Claude Code 内置了一些快捷命令：

其他终端 AI 工具推荐

1. ShellGPT (sgpt)

ShellGPT 是一个流行的终端 AI 工具，可以将自然语言转换为 Shell 命令。

安装：

pip install shell-gpt

配置：

export OPENAI_API_KEY="your-api-key"

使用示例：

# 生成命令
sgpt "查找所有 log 文件并删除"

# 解释命令
sgpt --shell "find . -name '*.log' -delete"

二 、codex 终端工具

npm i -g @openai/codex

二、trae 终端工具

trae 是一个国产 AI 编程助手，除了 IDE 插件外，也提供终端工具。

官网

https://www.trae.cn/

安装步骤

Windows 安装

1. 访问 https://www.trae.cn/ 下载 Windows 版本
2. 解压下载的压缩包
3. 将 trae 可执行文件所在目录添加到系统环境变量 PATH 中

macOS / Linux 安装

# 使用 curl 安装
curl -fsSL https://www.trae.cn/install.sh | bash

# 或者使用 brew（macOS）
brew install trae

验证安装

trae --version

配置

首次使用需要登录：

trae login

按照提示完成登录流程。

常用命令

# 启动对话模式
trae chat

# 解释一个命令
trae explain "git rebase -i HEAD~5"

# 生成命令
trae cmd "查找当前目录下所有大于 100MB 的文件"

# 快速修复命令错误
# 当你输错命令后，可以直接输入 trae fix
trae fix

四、实战练习

练习 1：安装并配置 Claude Code

1. 使用 npm 安装 Claude Code：

   npm install -g @anthropic-ai/claude-code

2. 启动 Claude Code：

   claude

3. 按照提示配置 API Key
4. 测试对话：输入 "你好，请介绍一下你自己"

练习 2：用 Claude Code 帮你写一个脚本

1. 在一个空目录中启动 Claude Code：

   mkdir my-cli-project
   cd my-cli-project
   claude

2. 输入以下提示：

3. 接收一个目录路径作为参数
4. 统计该目录下各种文件类型的数量

5. 用表格形式输出统计结果

   使用 Python 编写，可以使用 argparse 和 tabulate 库。

6. 按照 Claude 的指引完成项目

练习 3：命令修复

1. 故意输入一个错误的命令：

   grep -r "some text" --include="*.py" .
   # 如果这不是你想要的，可以用 AI 帮忙修正

2. 如果你安装了 trae 或类似工具，尝试：

   trae fix

3. 或者直接问 Claude：

   我想查找当前目录下所有 Python 文件中包含 "hello" 的行，
   正确的 grep 命令应该怎么写？

五、常见问题

Q: Claude Code 需要付费吗？

A: Claude Code 本身是免费的，但使用 Claude API 需要付费。Anthropic 提供免费额度供新用户试用。

Q: 有没有完全免费的终端 AI 工具？

A: 可以使用一些支持开源本地模型的工具，如 llamafile、ollama 等，配合本地运行的 LLM 模型使用。

Q: 这些工具会读取我的代码吗？

A: 如果你使用的是云端 API 服务，你的输入（包括代码片段）会被发送到服务器进行处理。如果对隐私敏感，建议使用本地模型方案。

Q: Windows 上使用终端工具有什么注意事项？

A: 推荐使用 PowerShell 或 Windows Terminal，避免使用古老的 CMD。另外注意路径分隔符在 Windows 上是反斜杠 \。

六、参考资源

• Claude Code 官方文档：https://claude.ai/docs
• Anthropic API 文档：https://docs.anthropic.com/
• trae 官网：https://www.trae.cn/
• ShellGPT GitHub：https://github.com/TheR1D/shell_gpt