Appearance
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 --versionWindows:参见 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 路由设置中配置偏好。