Skip to content

Junie CLI 是 JetBrains 推出的终端编程 agent,原生支持 OpenRouter 作为 BYOK(自带 Key)Provider。只需设置 JUNIE_OPENROUTER_API_KEY 环境变量,即可将 Junie 接入 OpenRouter,访问数百个 AI 模型。支持 @ 文件附加、/ 斜杠命令,以及 CI/CD 无头模式——通过 GitHub Actions 官方 action 可在 PR 流水线中自动触发代码审查。

Junie CLI 是 JetBrains 开发的终端 AI 编程 agent,通过 OpenRouter 接入后可使用 Anthropic、OpenAI、Google、Meta 等数百个模型。

为什么要通过 OpenRouter 使用 Junie?

  • 访问数百个模型:单一 API key 可调用所有 OpenRouter 上可用的模型
  • Provider 故障转移:某个 Provider 限流或不可用时自动切换
  • 集中计费:在 OpenRouter 活动面板 统一追踪消费
  • 团队管控:为组织设置预算上限和用量监控

前置要求

第一步:安装 Junie CLI

Linux / macOS:

bash
curl -fsSL https://junie.jetbrains.com/install.sh | bash
junie --version

Windows:参见 Junie 官方文档

第二步:配置 OpenRouter

Junie 原生支持 OpenRouter 作为 BYOK Provider。将 JUNIE_OPENROUTER_API_KEY 环境变量加入 shell profile:

bash
# 添加到 ~/.zshrc 或 ~/.bashrc
export JUNIE_OPENROUTER_API_KEY="<你的 OpenRouter API key>"

保存后执行 source ~/.zshrc 或重启终端使配置生效。

API key 以 sk-or-v1- 开头,在 OpenRouter 密钥页面 创建。

第三步:开始编程

bash
cd /path/to/your/project
junie

在交互界面输入 prompt 即可开始:

> give me an overview of this codebase
  • 使用 @ 可将文件或目录附加到请求上下文
  • 使用 / 查看可用斜杠命令

CI/CD 无头模式

Junie 支持非交互式无头模式,配合 OpenRouter 可在自动化流水线中实现统一计费:

bash
export JUNIE_OPENROUTER_API_KEY="$OPENROUTER_API_KEY"
junie "Review and fix any code quality issues in the latest commit"

GitHub Actions 示例

yaml
name: Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
      issues: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 1
      - uses: JetBrains/junie-github-action@v0
        with:
          openrouter_api_key: ${{ secrets.OPENROUTER_API_KEY }}
          prompt: "code-review"

OPENROUTER_API_KEY 存储为 GitHub Secret,即可在每次 PR 时自动运行 Junie 代码审查。

GitLab CI/CD

按照 Junie Workspace 配置说明 设置项目,然后将 JUNIE_OPENROUTER_API_KEY 添加为 CI/CD 变量。配置完成后,在 MR 上评论即可触发:

#junie code-review

验证连接

启动会话后,访问 OpenRouter 活动面板 确认请求已通过 OpenRouter 路由。

常见问题

Q: Junie CLI 接 OpenRouter 和直接用 JetBrains 内置模型有什么区别?

A: 主要区别是模型选择范围和计费方式。通过 OpenRouter 可以访问 OpenRouter 平台上所有可用的模型(不限 JetBrains 内置的),计费走 OpenRouter 积分,并可使用 OpenRouter 的用量监控和团队管控功能。

Q: 团队中多个开发者如何共享 Junie 的用量追踪?

A: 在 OpenRouter 中创建组织,所有成员使用同一个组织 API key。所有 Junie 请求统一从组织积分池扣除,可在活动面板中查看各成员消耗。

Q: 无头模式下如何指定使用特定模型?

A: Junie CLI 目前通过 JUNIE_OPENROUTER_API_KEY 接入 OpenRouter,模型路由由 OpenRouter 决定。如需固定模型,可在 OpenRouter 的 Provider 路由设置中配置偏好。