跳到主要内容

OpenRouter CLI:一个专为软件开发者设计的终端AI助手

· 阅读需 7 分钟
Knox Anderson
OpenRouter 核心团队

OpenRouter CLI 是一款面向软件开发者的终端AI助手,它结合了多种AI模型强大能力与超高速的原生文件系统工具,通过交互式聊天界面帮助您理解代码库、直接从终端构建、调试和分析代码。

✨ 核心功能

🤖 多模型AI集成

  • 多AI提供商支持:OpenRouter、OpenAI、Anthropic、Gemini等
  • 模型切换:在对话中无缝切换GPT-4o、Claude、Gemini等模型
  • 推理模式:支持在兼容模型上选择低/中/高推理强度
  • 上下文感知:自动从.buddyrules.cursorrulesCLAUDE.md等文件加载项目上下文

超高速原生文件系统工具

  • 14种原生工具调用:比传统MCP实现快5-10倍
  • 文件操作:读取、写入、修改、删除、复制、移动文件(含高级安全检查)
  • 目录管理:列表展示、创建、树状视图、递归操作
  • 搜索与分析:内容搜索、文件模式匹配、代码分析
  • 权限系统:基于路径白名单和审计日志的完善安全机制

🎨 专业终端界面

  • 美观界面:支持语法高亮和主题的现代化TUI
  • 快捷键:类似Vim的导航和效率快捷键
  • 会话管理:支持多会话及历史记录持久化
  • 文件浏览器:集成文件选择器和附件系统
  • 实时更新:动态状态指示器和进度反馈

🔧 高级开发功能

  • LSP集成:支持语言服务器协议提供智能代码辅助
  • 代码生成:AI驱动的代码创建与修改
  • 差异对比:美观的并排代码比较视图
  • RAG系统:基于检索增强生成的代码库理解
  • 智能编辑:上下文感知的代码修改与重构

🚀 快速开始

安装

下载二进制文件

访问我们的发布页面下载对应平台的二进制文件。

1. 选择对应版本

为您的平台选择合适版本:

# For macOS (Intel)
./dist/or-darwin-amd64

# For macOS (Apple Silicon)
./dist/or-darwin-arm64

# For Linux (Intel/AMD)
./dist/or-linux-amd64

# For Linux (ARM)
./dist/or-linux-arm64

# For Windows
./dist/or-windows-amd64.exe

2. 简易安装方法

选项 A:复制到系统 PATH(推荐)

# For macOS/Linux - copy to a directory in your PATH
sudo cp dist/or-darwin-arm64 /usr/local/bin/or

# Make executable
sudo chmod +x /usr/local/bin/or

# Now you can use it from anywhere
or

选项 B: 添加至路径

# Add the dist directory to your PATH
export PATH="$PWD/dist:$PATH"

# Add to your shell profile for permanent access
echo 'export PATH="$PWD/dist:$PATH"' >> ~/.bashrc # for bash
echo 'export PATH="$PWD/dist:$PATH"' >> ~/.zshrc # for zsh
``

### 3. 首次设置

#### 设置您的 API 密钥

```bash
# Set OpenRouter API key
export OPENROUTER_API_KEY="您的-api-密钥"

# Add to your shell profile for permanent access
echo 'export OPENROUTER_API_KEY="您的-api-密钥"' >> ~/.bashrc # for bash
echo 'export OPENROUTER_API_KEY="您的-api-密钥"' >> ~/.zshrc # for zsh

配置

  1. 设置您的API密钥:
export OPENROUTER_API_KEY="您的-api-密钥"
  1. 首次运行:
or

该应用程序将在您的项目目录中创建一个.openrouter.json配置文件,并提供合理的默认配置。

🎯 使用示例

交互模式

# 启动 OpenRouter CLI
or

# 启动于指定目录
or -c /path/to/project

非交互模式

# Single prompt execution
or -p "Explain this Go code structure"

# JSON output format
or -p "List all Go files in this project" -f json

# Quiet mode (minimal output)
or -p "Check for security issues" -q

示例对话

代码库分享:

你:你能分析这个 Go 项目结构并解释其主要组件吗?

AI:我将使用我的文件系统工具分析你的代码库。让我来探索一下结构...

[使用 list_directory 和 read_file 工具]

这是一个结构良好的 Go CLI 应用程序,具有以下架构:
- cmd/ - 使用 Cobra 定义的 CLI 命令
- internal/ - 核心应用逻辑,具有清晰的分离
- internal/tui/ - 使用 Bubble Tea 框架的终端 UI
- internal/llm/ - 与多个提供商的 AI 集成
- internal/tools/ - 本地文件系统工具(14 个超快工具)
...

代码生成:

你:创建一个基于JWT令牌的用户身份认证REST API处理器

AI:我会为你创建一个全面的认证处理器...

[使用 write_file 和 create_directory 工具来生成代码]

已创建以下文件:
- handlers/auth.go - JWT认证处理器
- middleware/auth.go - 认证中间件
- models/user.go - 包含验证功能的用户模型
- utils/jwt.go - JWT令牌工具
...

🛠️ 文件系统工具调用

OpenRouter CLI 包含 14 个超高速的原生文件系统工具,按功能分类如下:

📁 文件操作

  • read_file - 读取完整文件内容,支持编码检测
  • write_file - 创建或覆盖文件,支持备份
  • modify_file - 查找并替换文本,支持正则表达式
  • delete_file - 安全删除文件,带确认提示
  • copy_file - 复制文件和目录,带进度跟踪
  • move_file - 移动或重命名文件,带冲突解决
  • get_file_info - 详细的文件元数据和统计信息
  • read_multiple_files - 高效批量读取多个文件

📂 目录操作

  • list_directory - 列出内容并显示详细信息
  • create_directory - 递归创建目录
  • tree - 显示目录树结构,支持过滤
  • list_allowed_directories - 显示可访问的目录

🔍 搜索操作

  • search_files - 按名称、扩展名或模式查找文件
  • search_within_files - 内容搜索,支持正则表达式

⌨️ 键盘快捷键

快捷键功能
Ctrl+C退出应用
Ctrl+O打开模型选择
Ctrl+S切换会话
Ctrl+F打开文件选择器
Ctrl+T切换文件系统工具
Ctrl+D切换调试模式
Ctrl+?显示帮助
Ctrl+R刷新界面
Tab自动补全
↑/↓浏览历史记录

🔧 配置

主配置文件 (.openrouter.json)

{
"providers": {
"openrouter": {
"apiKey": "your-api-key",
"disabled": false
}
},
"agents": {
"coder": {
"model": "openrouter.claude-sonnet-4",
"maxTokens": 16438,
"reasoningEffort": "medium"
},
"task": {
"model": "openrouter.gpt-4o",
"maxTokens": 4096
}
},
"data": {
"directory": ".openrouter"
},
"tui": {
"theme": "openrouter"
},
"lsp": {
"go": {
"command": "gopls",
"args": ["serve"],
"disabled": false
}
}
}

LSP 配置

配置 Language Server Protocol 集成以实现智能代码辅助:

{
"lsp": {
"go": {
"command": "gopls",
"args": ["serve"]
},
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"]
},
"python": {
"command": "pylsp"
}
}
}

🚀 性能

基准测试

  • 原生工具:比传统 MCP 实现快 5-10 倍
  • 内存占用:优化低内存占用(通常约 50MB)
  • 启动时间:冷启动在 500 毫秒内
  • 文件操作:并行处理与智能缓存

优化功能

  • 并发处理:并行文件操作与 AI 请求
  • 智能缓存:文件内容与 AI 响应的智能缓存
  • 内存管理:通过垃圾回收优化实现高效内存使用
  • 连接池:重用 AI 提供商连接

🔒 安全

权限系统

  • 路径白名单:限制文件访问至批准目录
  • 操作审计:文件操作全面日志记录
  • 安全默认值:保守权限设置,危险操作需显式启用
  • 备份系统:破坏性操作前自动备份

最佳实践

  • API 密钥管理:支持环境变量与安全存储
  • 输入验证:全面验证用户输入与 AI 响应
  • 错误处理:优雅的错误处理与详细日志记录
  • 审计追踪:完整记录所有操作

性能监控

  • 内置性能分析:支持内存与 CPU 分析
  • 工具使用统计:跟踪文件系统工具使用与性能
  • 会话分析:会话长度、模型使用情况及响应时间