# OpenRouter

> 在 nsq 中让 Claude Code、Codex CLI 或 OpenCode 智能体使用任意 OpenRouter 模型——密钥保存在系统密钥库里。

Source: https://docs.neurosquad.ai/zh/cli/openrouter

[OpenRouter](https://openrouter.ai) 用一个密钥即可访问众多服务商的模型。nsq 可以让 Claude Code、Codex CLI 和 OpenCode 智能体通过它运行，而不改动这些 CLI 自己的设置。

## 设置一次密钥

```sh
nsq openrouter set-key          # 按提示粘贴密钥（sk-or-…）
nsq openrouter status           # 是否有可用的密钥？
```

密钥保存在操作系统的密钥库中——Windows 凭据管理器、macOS 钥匙串、Linux 上的 Secret Service。没有密钥库时，改用环境变量 `OPENROUTER_API_KEY`。`nsq openrouter clear-key` 会删除密钥。

## 通过 OpenRouter 运行智能体

```sh
nsq run claude --provider openrouter --model anthropic/claude-sonnet-4.5
```

用 `nsq openrouter models [关键词]` 查找模型 id（附每百万 token 的价格），或在仪表盘中按 `m` 从目录中挑选。启动对话框（`c`）里也有同样的选项。

修改已有智能体：`nsq set <agent> --provider openrouter --model <id>`（或用 `--provider none` 回到 CLI 自己的登录）。新的模型或服务商从智能体下次启动时生效。

## 密钥的去向

- 它只会被放进智能体的环境变量——绝不会出现在命令行、日志或文件里。
- 没有密钥时一切照旧：智能体使用 CLI 自己的登录运行。
- 每个请求都带有 NeuroSquad 在 OpenRouter 上的应用归属信息——注明应用名称及其网站的请求头，让 OpenRouter 知道这些请求来自 NeuroSquad。除此之外不添加任何内容。