AI / AI Tools
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 |
# 附带上下文文件运行
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 仓库状态检查 |
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 在代码中编排 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 会话 |
对于需要在 Node.js / TypeScript 代码中以编程方式控制 Copilot Agent 运行的用户,GitHub 提供了官方 SDK:
# 安装官方 Copilot SDK
npm install @github/copilot-sdk
该 SDK 支持通过 JSON-RPC 与 Copilot CLI 或底层 Runtime 建立连接,实现任务自动规划、工具调用及代码修改等自动化开发任务。