AI / AI Tools

AI 工具集

Claude CLI / Codex CLI / Agy CLI / Copilot CLI 命令详解。

Claude CLI(官方名称 Claude Code)是 Anthropic 推出的智能编程命令行工具。它可以理解你的代码库、编辑文件、运行测试并处理 Git 工作流。

📦 安装

通过 npm 安装(需要 Node.js ≥18):

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

# 或使用 npx(无需全局安装)
npx @anthropic-ai/claude-code

# 验证安装
claude --version

前置要求:Node.js 18+,以及 Anthropic API Key 或 Claude Pro/Max 订阅。

🔑 身份认证

# 交互式登录(打开浏览器)
claude auth

# 通过环境变量设置 API Key
export ANTHROPIC_API_KEY="sk-ant-..."

# 使用自定义 API 地址(通过代理时)
claude --api-key "sk-..." --model claude-3-5-sonnet-20241022

⚡ 核心命令

命令说明
claude在当前目录启动交互式 REPL 会话
claude "提示词"发送一次性提示并输出回复
claude -p "提示词"打印模式 — 将回复输出到 stdout(适合管道操作)
claude -c继续最近的对话
claude --model <模型>指定使用的 Claude 模型
claude --max-tokens <N>设置回复的最大 Token 数
claude --temperature <N>设置采样温度(0–1)

🖥️ 交互模式命令

进入 REPL 后,使用以下斜杠命令:

命令说明
/help显示可用命令
/clear清除对话历史
/model <名称>在会话中切换模型
/compact压缩对话以节省 Token
/diff显示待定的文件变更
/undo撤销上一次文件修改
/commit用变更内容创建 Git 提交
exit / quit退出 REPL

🔌 高级功能 & MCP 集成

# 附带上下文文件运行
claude "review this code" --context src/*.py

# 使用 MCP(模型上下文协议)服务器
claude mcp add --transport http server-name https://...

# 列出已配置的 MCP 服务器
claude mcp list

# 在"无头"CI 模式下运行
claude -p "write tests" --output-format json

Codex CLI(官方命令 codex)是 OpenAI 官方推出的轻量级终端 AI 编程助手与 Agent 编排工具。它能够与你的本地代码库进行深度交互,提供代码解释、重构、Bug 修复及命令行任务自动化能力。

📦 安装

需要 Node.js ≥18,可以通过 npm 全局安装:

# 通过 npm 全局安装
npm install -g @openai/codex

# macOS 也可以通过 Homebrew 安装
brew install --cask codex

# 验证安装
codex --version

🔑 身份认证

首次运行 codex 命令时,终端会引导你进行登录。可以直接通过浏览器 OAuth 授权登录你的 ChatGPT 账号(支持 Plus、Pro、Team、Enterprise 等),或者在配置中提供 OpenAI API Key。

# 启动并进行首次身份认证
codex

⚡ 核心命令与选项

命令 / 选项说明
codex启动交互式 Terminal User Interface (TUI) 会话
codex "提示词"单次提示词运行并直接在终端输出结果(非交互式)
-c key=value / --config在当前运行中临时覆盖配置项(如 -c model=gpt-4o
-a <mode> / --ask-for-approval设置工具执行审批策略(可选:untrusted, on-request, never
--add-dir <path>授予额外的目录读写和执行权限
--profile <name>加载指定的配置文件 Profile
--skip-git-repo-check在运行时跳过 Git 仓库状态检查

🔧 配置文件 (config.toml)

Codex CLI 默认从 ~/.codex/config.toml 读取用户级配置。你可以自定义默认模型、安全策略及 MCP 工具:

# 示例配置文件 ~/.codex/config.toml
model = "gpt-4o"
approval_policy = "on-request"

# 配置 MCP (Model Context Protocol) 服务
[mcp_servers.my_helper]
enabled = true
command = "node"
args = ["/path/to/server.js"]

项目级别配置可以通过在项目根目录下创建 .codex/config.toml 来覆盖全局配置(需标记项目为信任)。

🤖 交互式会话快捷指令

codex 交互式对话中,可以通过输入 / 打开快捷指令弹窗。常用指令如下:

快捷指令说明
/agent切换或查看已创建的子 Agent 线程
/apps浏览并关联特定的应用程序或外部数据源链接器
/approvals调整工具执行的审批模式(如 Auto, Read Only, Full Access 等)
/clear清空当前对话上下文与终端屏幕,开启全新会话
/compact压缩/总结对话历史记录以释放上下文 Token 额度
/diff显示 Git 代码库的修改差异(包含未跟踪文件)以供审核
/fork克隆当前会话的上下文并分叉进入一个新会话线程
/ide将当前 IDE 编辑器中的上下文(打开的文件、选中代码段)导入 AI 上下文
/model快速切换当前会话所使用的 AI 模型
/permissions管理工具和文件操作的自动批准/运行授权规则
/plugins管理、启用或安装第三方扩展插件工具
/review让 AI 自动对当前本地修改进行代码质量与 Bug 审查
/side开启一个临时侧边话题线程进行发散性探索(完成后可并回)
/status查看当前的连接状态、组织计费信息及 API 速率限制
/theme预览并设置终端用户界面的颜色主题与语法高亮
/usage显示详细的 Token 用量图表与历史活动统计
/exit / /quit退出当前 Codex CLI 会话

⚠️ 安全警告

在安装 @openai/codex 前,请务必核实 npm 包名是否拼写正确。在 npm 生态中存在某些冒充官方 Codex 命令行工具的恶意包(如 codexui-android 等),其目的是窃取 ~/.codex/auth.json 中的认证令牌。切勿安装未经核实的第三方包。

Agy CLI — Google 的 Antigravity (Agy) CLI 是一款轻量级的终端智能 AI 编程与 Agent 编排工具,将强大的 AI 辅助开发能力直接带入你的命令行环境。

📦 安装

在终端中运行以下命令安装 agy

# macOS & Linux 安装
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows (PowerShell) 安装
irm https://antigravity.google/cli/install.ps1 | iex

# 验证安装
agy --version

🔑 身份认证

首次运行时,直接输入 agy,按回车键将自动打开浏览器进行 Google 账户 OAuth 登录认证,完成后将授权码粘贴回终端即可。

# 启动并进行首次登录
agy

# 登出当前账户
# 在交互式会话中运行 /logout

⚡ 核心命令

命令说明
agy启动交互式 Terminal User Interface (TUI) 会话
agy -p "提示词" / agy --print "提示词"单次提示词运行并直接在终端输出结果(非交互式)
agy -c / agy --continue继续上一次的对话会话
agy --conversation <ID>通过会话 ID 恢复并继续之前的对话
agy --model <模型>指定当前会话使用的 AI 模型
agy --sandbox在沙箱模式下运行,限制终端命令执行权限
agy --dangerously-skip-permissions自动同意所有工具执行的权限请求(不进行提示)

📁 子命令

子命令说明
agy changelog显示产品更新日志与发布说明
agy models列出当前可用的 AI 模型
agy plugin / plugins管理插件(支持 install, uninstall, list, enable, disable 等)
agy update更新 Agy CLI 到最新版本
agy install配置环境变量与 Shell 自动补全设置

🤖 交互式会话快捷指令

agy 交互式命令行中,可以使用以下快捷斜杠指令进行状态和上下文操作:

快捷指令说明
/add-dir添加新目录到当前项目工作区
/agents列出所有活跃的子 Agent 及自定义组件(如 Fleet)
/artifact打开 TUI 成果物(Artifact)视图查看器
/btw在不启动完整智能体运行的情况下发起快速旁听提问
/changelog显示产品更新日志与发布说明
/clear / /new清空当前对话上下文与终端屏幕
/config / /settings打开 TUI 设置面板自定义 CLI 配置
/context显示当前已载入 AI 上下文的文件和符号
/copy将最新的 AI 回复复制到系统剪贴板
/diff显示 AI 对当前代码库所做的修改差异(diff)
/fork / /branch复制并分叉当前会话到新线程,保留历史记录
/help显示帮助菜单、常用命令与键盘快捷键
/hooks列出所有注册的生命周期钩子(lifecycle hooks)
/keybindings配置和查看所有活跃的 CLI 键盘快捷键
/logout登出当前的 Google 账户会话
/mcp列出当前活跃的 MCP 服务器及其工具
/model快速切换当前会话所使用的 AI 模型
/open在本地首选编辑器(如 vim, nano, auto)中打开指定文件
/permissions管理工具和文件访问的允许/拒绝执行权限列表
/planning打开图形化任务规划与进度管理器
/rename对当前活动会话线程进行重命名
/skills列出当前启用的 Agent 技能列表
/tasks显示当前后台任务执行的列表与进度
/usage / /quota显示 Token 使用情况、会话费用及配额统计
/exit / /quit退出当前 Agy CLI 会话

🔌 通过 Antigravity Python SDK 使用

可以使用官方的 Antigravity Python SDK 在代码中编排 Agent:

pip install google-antigravity
import asyncio
from google.antigravity import Agent, LocalAgentConfig, CapabilitiesConfig

async def main():
    # 默认只读模式,如需写入权限可传入 CapabilitiesConfig()
    config = LocalAgentConfig(
        system_instructions="你是一个代码库导航专家助手。",
        capabilities=CapabilitiesConfig()
    )
    
    async with Agent(config) as agent:
        response = await agent.chat("写一个列出当前目录文件的 Python 脚本")
        # 实时流式输出回复
        async for token in response:
            print(token, end="", flush=True)

if __name__ == "__main__":
    asyncio.run(main())

GitHub Copilot CLI(官方命令 copilot,包名 @github/copilot)是 GitHub 官方推出的终端原生 AI 编程 Agent 助手。它允许你在命令行中以自然语言与代码库交互,自动执行规划、代码生成、调试等任务。

📦 安装

需要 Node.js ≥22,通过 npm 全局安装:

# 通过 npm 全局安装
npm install -g @github/copilot

# 验证安装
copilot --version

注:曾用包名 @githubnext/github-copilot-cli 已被弃用,请确保使用最新的 @github/copilot 包。

🔑 身份认证

首次运行 copilot 命令或在交互会话中输入 /login 进行 GitHub 账户登录授权:

# 启动 Copilot CLI
copilot

# 在会话中进行登录
/login

需要拥有 GitHub Copilot 订阅 权限。

⚡ 核心模式与交互

快捷键 / 操作说明
Shift + Tab切换至 **Plan(规划)模式**,用于在执行前规划和设计任务
@文件名在提示词中输入 @ 可以引用特定的文件加入 AI 上下文
Ctrl + C清空当前输入或中断正在执行的命令
Ctrl + L清空终端屏幕
Esc取消当前正在进行的操作

🤖 交互式会话快捷指令

copilot 交互式对话中,可以使用以 / 开头的快捷斜杠指令进行操作:

快捷指令说明
/login进行 GitHub 账户登录认证
/model选择或切换当前会话所使用的 AI 模型(如 Claude 3.5 Sonnet, GPT-4o 等)
/help显示帮助文档和命令详细指南
/pr通过 CLI 直接管理和操作 GitHub Pull Requests
/fleet启用多子 Agent(Fleet)协作模式以加快处理多步骤复杂任务
/experimental启用或关闭实验性功能选项
/exit退出当前 Copilot CLI 会话

🔌 通过 GitHub Copilot SDK 使用

对于需要在 Node.js / TypeScript 代码中以编程方式控制 Copilot Agent 运行的用户,GitHub 提供了官方 SDK:

# 安装官方 Copilot SDK
npm install @github/copilot-sdk

该 SDK 支持通过 JSON-RPC 与 Copilot CLI 或底层 Runtime 建立连接,实现任务自动规划、工具调用及代码修改等自动化开发任务。