docs: switch plugin install to token-embedded URL

simgreek org requires login for git access, so anonymous /plugin
marketplace add fails. Members generate a Gitea access token (read-only
on repository) and embed it in the plugin URL. Token is stored in
Claude Code settings — documented as a caveat with revocation guidance.

Verified: token-embedded clone over HTTPS retrieves all .claude-plugin
manifest files and skills/.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
阿白叔andClaude Opus 4.7 committed 2026-05-25 18:17:09 +08:00
1 parent ea1819f1d2
commit 4fa489691f
1 file changed
+23 -2
+23 -2
View File
@@ -15,14 +15,35 @@ Simgreek 团队的 AI 协作开发约定。**给 AI 看的**——每个项目
## 安装(Claude Code 插件)
simgreek 仓库要求登录访问,所以 plugin URL 里要带个人 access token。每个团队成员一次性配一下。
**第 1 步**:在 Gitea 生成 token
登录 [git.simgreek.com](https://git.simgreek.com) → 右上角头像 → Settings → Applications → 「Manage Access Tokens」 → 生成一个新 token:
- Token 名字:`claude-code-plugin`(或你喜欢的)
- 权限只勾 `repository: read` 就够,越小越好
- **生成后立刻复制保存**——离开页面就看不到了
**第 2 步**:在 Claude Code 装
把下面的 `<YOUR_USERNAME>` 和 `<YOUR_TOKEN>` 替换掉:
```
/plugin marketplace add https://git.simgreek.com/simgreek/praxis
/plugin marketplace add https://<YOUR_USERNAME>:<YOUR_TOKEN>@git.simgreek.com/simgreek/praxis
/plugin install praxis
```
装完之后每次开新 session,praxis 的 `SessionStart` hook 会把 `using-praxis` 内容直接灌进 system context——AI 在做任何事之前都会读到铁律和 red flags。
升级:`/plugin update praxis`
**安全提醒**:
- token 会被 Claude Code 写进本地 settings——别让别人翻你电脑,也别把 settings 文件分享出去
- token 不要提交进任何仓库
- 共用电脑 / 临时机器装完用完,去 Gitea token 页面 revoke 掉
- token 失效或换了,重新跑 `/plugin marketplace add` 用新 URL
升级:`/plugin update praxis`(自动用同一个 token 拉新版本)
卸载:`/plugin uninstall praxis`