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:
1 parent
ea1819f1d2
commit
4fa489691f
1 file changed
+23
-2
@@ -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`
|
||||
|
||||
|
||||
Reference in new issue
Block a user