GitHub Copilot CLI 接入¶
GitHub Copilot CLI 是独立应用,应用 ID 为 copilot(兼容 copilot-cli、github-copilot),对应 npm 包 @github/copilot、命令 copilot。数据目录为 ~/.copilot,设置 COPILOT_HOME 后全部跟随该目录(CC Switch 进程需要继承这个环境变量)。
以下格式均以本机 Copilot CLI 1.0.103 的 copilot help providers、copilot help environment、copilot help config 和隔离 COPILOT_HOME 实测为准。
使用方式¶
- 在「应用」页安装 GitHub Copilot CLI(
npm i -g @github/copilot@latest;Homebrew caskcopilot-cli的安装也能识别和卸载)。 - 在侧栏选择 Copilot CLI,点击「添加供应商」:
- GitHub Copilot(官方):用 Copilot CLI 自己的 GitHub 登录。可选模型(以
--model传入,只对这次会话生效);可以绑定授权中心里的 GitHub 账号,打开终端时经COPILOT_GITHUB_TOKEN只给这一个进程使用该账号,卡片同时显示该账号的 Premium 额度。 - 自带模型(BYOK):从「模型厂商」「第三方平台」「云服务商」「本地」中选预设(复用 Pi 的供应商目录,换算为 Copilot 的协议字段),或「自定义配置」。选择接口格式(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Azure OpenAI 的 Chat Completions / Responses,一项同时决定
COPILOT_PROVIDER_TYPE和COPILOT_PROVIDER_WIRE_API),填写地址、Key 和模型;「获取模型」从地址的/models读取可用模型。
- GitHub Copilot(官方):用 Copilot CLI 自己的 GitHub 登录。可选模型(以
- 卡片只有「打开终端」,没有「启用」。从卡片打开的终端按这张卡启动
copilot。
为什么没有「启用」¶
结论:Copilot CLI 只能用启动形式,不能像 Kimi、OpenCode 那样以添加(共存)形式写进原生配置。依据(Copilot CLI 1.0.103):
copilot help config列出的settings.json设置里没有任何供应商、地址或 Key 字段;copilot help providers只给出COPILOT_PROVIDER_*环境变量。- 实测在
settings.json写"env": { "COPILOT_PROVIDER_BASE_URL": … }无效:只靠它启动时 CLI 仍提示需要设置COPILOT_PROVIDER_BASE_URL。 - CLI 内置的「Provider discovery」只发现扩展、Foundry Local 等运行时提供的模型,没有用户可写的持久化 BYOK 配置;SDK / ACP 会话的
provider参数也只对单个会话有效。
Copilot CLI 的自带模型只能经进程环境变量 COPILOT_PROVIDER_* 配置,没有对应的配置文件字段;写进 shell 启动文件会影响所有终端,也会让 Key 常驻磁盘。所以与 Antigravity 相同:
- 卡片里存的就是这些环境变量:
{ "env": { "COPILOT_PROVIDER_BASE_URL": …, "COPILOT_PROVIDER_TYPE": …, "COPILOT_PROVIDER_WIRE_API": …, "COPILOT_PROVIDER_API_KEY": …, "COPILOT_MODEL": … } }。其他COPILOT_PROVIDER_*(BEARER_TOKEN、MODEL_ID、WIRE_MODEL、MAX_PROMPT_TOKENS、MAX_OUTPUT_TOKENS、HEADERS、TRANSPORT、AZURE_API_VERSION)可在环境变量 JSON 里填写。 - 「打开终端」:macOS / Linux 的启动脚本先读入一个
0600的临时文件,读完立即删除,再经env把变量交给这一个 copilot 进程;Windows 写进.bat的setlocal段。Key 不出现在命令行参数里,也不写进任何常驻文件。卡上没填的同名变量会被env -u清掉,避免与用户 rc 里 export 的值混用;官方卡会清掉全部COPILOT_PROVIDER_*,防止 rc 里的 BYOK 变量把它悄悄变成自带模型。 COPILOT_PROVIDER_HEADERS的多行值在传给进程前转成字面量\n分隔(Copilot CLI 同样认这种写法),以便 Windows 批处理也能承载。- 卡片可选「推理强度」(
settingsConfig.reasoningEffort:none / minimal / low / medium / high / xhigh / max),「打开终端」时作为--reasoning-effort传入;Copilot CLI 没有对应的环境变量或设置项。Responses 接口下 Copilot 默认在请求里带reasoning.summary,不认这个字段的中转会返回 400(如unknown field "summary");选none时不带这个字段(实测本地中转 + DeepSeek 可正常回复)。 ~/.copilot/settings.json不被供应商功能改写;直接运行copilot永远是 Copilot 自己的登录和/model选择。
保存前校验:值必须是字符串、不能含控制字符(HEADERS 允许换行);有凭据或选项时必须有地址;自带模型必须有模型(COPILOT_MODEL、COPILOT_PROVIDER_MODEL_ID 或 COPILOT_PROVIDER_WIRE_MODEL);协议、接口、传输取值与 token 上限必须是 Copilot CLI 认的值。
已有 settings.json 带 model 时,首次进入会导入为一张 default 官方卡;只有界面设置的 settings.json 不导入。
配置与能力¶
| 能力 | 原生位置 / 行为 |
|---|---|
| 供应商 | 仅「打开终端」时经进程环境传入,不落盘 |
| 官方账号 | Copilot CLI 自己的登录;或绑定授权中心 GitHub 账号,经 COPILOT_GITHUB_TOKEN / COPILOT_GH_HOST 传入 |
| 官方额度 | 卡片显示 GitHub Copilot 的 Premium 额度,在卡片「更多 → 配置用量查询」里开关(只有 Copilot 额度一种模板)。绑了授权中心账号的卡默认打开并查该账号;没绑的卡默认关闭,打开后读 ~/.copilot/config.json 的 lastLoggedInUser,按用户名和域名在授权中心找对应账号来查;找不到或 Copilot CLI 未登录时卡片上提示原因 |
| MCP | ~/.copilot/mcp-config.json:stdio 写为 "type": "local",另有 http、sse;新条目带 "tools": ["*"],已有条目的 tools、timeout 保留。停用时移除条目;导入时 settings.json 的 disabledMcpServers 记为未启用 |
| Skills | ~/.copilot/skills/,与 Kimi 相同的原生目录保护(同名外部目录不覆盖、不删除) |
| 全局提示词 | ~/.copilot/copilot-instructions.md(copilot instruction list 中的 Personal instructions) |
| 会话 | ~/.copilot/session-state/<id>/events.jsonl 与 workspace.yaml;旧版本没有 workspace.yaml 时退回 session.start |
| 恢复会话 | copilot --resume=<id> |
| 用量 | 导入 session.usage_record(新版本才写出);按项目价格表估算费用 |
| 连通性检查 | 自带模型卡检查 COPILOT_PROVIDER_BASE_URL;官方卡不提供 |
| 深链接 | resource=provider&app=copilot,apiFormat 支持 openai_chat、openai_responses、anthropic;config 可为 {env:{…}} 或扁平 COPILOT_*,只取地址、Key、模型;导入后只保存,不启用。MCP 用 apps=copilot |
会话与 Token 语义¶
- 主会话只展示
user.message、assistant.message(含reasoningText、toolRequests)、tool.execution_complete和压缩摘要;带parentToolCallId的子代理内部消息不进主会话,report_intent意图标签不作为工具调用显示。 session.usage_record在对应回复之前写出,会话里挂到下一条回复上。inputTokens包含缓存命中:新输入取copilotUsage.tokenDetails的input,没有时用inputTokens − cacheReadTokens − cacheWriteTokens。耗时、首字时间取duration、timeToFirstTokenMs。- 用量按
copilot:<会话>:<事件 ID>去重,去重账本与明细同事务提交;未变化的文件按大小和修改时间跳过,写到一半的尾行下次再读。旧版本只有汇总、没有逐次记录的会话不导入,不做估算。 - Copilot 订阅按 Premium 请求 / AI Credits 计费,表中费用是按 token 价格表的估算;缺少价格时为 0,不代表免费。
- 会话删除在 Copilot CLI 中完成,以保持
session-store.db与会话目录一致。
验证¶
- 单元与集成测试:
cargo test --lib copilot、cargo test --test integration copilot_commands::、pnpm vitest run tests/components/CopilotProviderForm.test.tsx src/config/copilotProviderPresets.test.ts。 - 真实 CLI:在临时
COPILOT_HOME中用copilot mcp add/disable核对 MCP 原生格式;用本地 OpenAI 兼容端点以 BYOK 环境变量运行copilot -p,确认请求成功,并用生成的会话目录运行CCS_COPILOT_SMOKE_HOME=<目录> cargo test --lib real_copilot_home -- --ignored核对会话和用量解析。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cc/cc-switch