前言
如果你是 Obsidian 用户，又想在笔记中直接使用 Claude AI，那 Claudian 插件是个不错的选择。但直接调用 Anthropic API 有几个痛点：
- API 密钥散落在各处配置文件中，不安全
- 无法统一管理多个客户端的 API 调用
- 难以监控和调试请求
本文介绍一种解决方案：通过本地代理服务器 claude-code-router 统一管理 API 调用。只需配置 6 个环境变量，3 分钟搞定。
一、什么是 claude-code-router？
claude-code-router 是一个轻量级的本地代理服务器（npm 包：@musistudio/claude-code-router），它的作用是：
| 功能 | 说明 |
|---|---|
| API 请求转发 | 拦截 Claudian 的请求，转发到 Anthropic |
| 集中认证 | API 密钥只需在 router 端配置一次 |
| 请求监控 | 终端实时查看请求日志，方便调试 |
默认运行在 http://127.0.0.1:3456。
二、环境准备
开始之前，确保你已安装：
三、安装并启动 claude-code-router
打开终端，执行：
# 全局安装
npm install -g @musistudio/claude-code-router
# 启动服务
claude-code-router
看到以下输出说明启动成功：
Claude Code Router running on http://127.0.0.1:3456
提示：保持这个终端窗口运行，不要关闭。
四、配置 Claudian 插件（核心步骤）
4.1 打开配置页面
在 Obsidian 中进入：
Settings → Claudian → Environment → Custom variables
快捷键：Cmd + ,（Mac）或 Ctrl + ,（Windows）
4.2 添加环境变量
在 Custom variables 区域，粘贴以下配置：
ANTHROPIC_AUTH_TOKEN="test"
ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
NO_PROXY="127.0.0.1"
DISABLE_TELEMETRY="true"
DISABLE_COST_WARNINGS="true"
API_TIMEOUT_MS="600000"
4.3 配置说明
| 变量 | 值 | 为什么这样设置？ |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | test | 占位符，实际认证由 router 处理 |
ANTHROPIC_BASE_URL | http://127.0.0.1:3456 | 指向本地 router |
NO_PROXY | 127.0.0.1 | 绕过系统代理，直连本地服务 |
API_TIMEOUT_MS | 600000 | 超时设为 10 分钟，避免长请求中断 |
4.4 重启插件
配置完成后，二选一：
- 方法一：Settings → Community plugins → 关闭再开启 Claudian
- 方法二：重启 Obsidian
五、验证配置
- 确保
claude-code-router终端正在运行 - 在 Obsidian 中打开 Claudian 对话面板
- 发送一条消息，如 "Hello"
- 查看 router 终端，应该能看到请求日志
看到日志输出，说明配置成功。
六、常见问题
Q1: 连接失败 / Connection refused
| 检查项 | 解决方案 |
|---|---|
| Router 是否运行？ | 终端执行 claude-code-router |
| 端口是否被占用？ | 执行 lsof -i :3456 检查 |
| URL 是否正确？ | 确保有 http:// 前缀 |
Q2: 请求超时
- 增大
API_TIMEOUT_MS值，如900000（15分钟） - 检查 router 终端是否有报错
Q3: 认证错误
- 检查 router 端的 API 密钥是否配置正确
- Claudian 侧
ANTHROPIC_AUTH_TOKEN保持test即可
Q4: 配置不生效
- 完全退出 Obsidian 后重新打开
- 检查环境变量是否有多余空格
- 变量名区分大小写
七、进阶玩法
自定义端口
如果 3456 被占用：
claude-code-router --port 8080
对应修改 Claudian 配置：
ANTHROPIC_BASE_URL="http://127.0.0.1:8080"
多 Vault 共享
只需启动一个 router 实例，所有 Vault 的 Claudian 都可以连接同一个地址。
总结
通过 claude-code-router 代理，你可以：
- 集中管理 API 密钥，更安全
- 统一监控所有 Claude 请求
- 多客户端共享一个认证配置
完整配置只需要 6 行环境变量，复制粘贴即可。
相关链接：
如果这篇文章对你有帮助，欢迎点赞收藏。有问题可以在评论区交流。
