7418andClaude Opus 4.6
c67f3ef82b
- 重写 index.mdx 为真正的快速开始指南，链接服务商配置 - 新增 chat.mdx（对话模式、权限、上下文管理） - 新增 skills.mdx（技能分类、市场、本地管理） - 新增 design-agent.mdx（单张/批量图片生成、参考图、连续编辑） - 新增 gallery.mdx（素材库浏览、筛选、详情操作） - 重写 providers.mdx — CLI 环境认证 vs 手动添加、cc switch 不生效说明、 国内服务商预设、Anthropic 第三方模型映射、服务商优先级链 - 重写 mcp.mdx — 三种传输类型(stdio/SSE/HTTP)、列表+JSON 双视图 - 重写 assistant-workspace.mdx — 对齐实际设置>助理标签页 - 重写 faq.mdx — 更全面的问答覆盖 - 桥接拆分为 5 页：总览(斜杠命令、全局设置) + Telegram + Discord + 飞书 + QQ - Discord 开发者模式获取 ID 说明移入配置流程 - 飞书长连接模式启动顺序说明 - 所有 UI 按钮/菜单名称改为中文翻译（设置、服务商、技能、桥接等） - 扁平化无子页面的 folder/index.mdx → page.mdx，消除侧边栏多余展开三角 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
83 lines
3.1 KiB
Plaintext
83 lines
3.1 KiB
Plaintext
---
|
||
title: 常见问题
|
||
description: 关于 CodePilot 的常见问题解答。
|
||
---
|
||
|
||
# 常见问题
|
||
|
||
## 基本问题
|
||
|
||
### CodePilot 是什么？
|
||
|
||
CodePilot 是 Claude Code 的桌面工作区。它在 Claude Code CLI 的基础上提供图形界面，整合了多服务商管理、MCP 插件、技能、消息桥接和助理工作区等功能。基于 Electron + Next.js 构建。
|
||
|
||
### CodePilot 和 Claude Code CLI 是什么关系？
|
||
|
||
CodePilot 是 Claude Code CLI 的图形前端。它通过 Claude Agent SDK 调用 Claude Code CLI 的能力，同时在上层添加了 GUI 专属的功能（多服务商切换、桥接、素材库等）。使用 CodePilot 需要先安装 Claude Code CLI。
|
||
|
||
### CodePilot 免费吗？
|
||
|
||
CodePilot 本身开源且免费。你需要自备 API 密钥（来自 Anthropic、OpenRouter 或其他支持的服务商）。API 调用费用由服务商收取。
|
||
|
||
### 支持哪些操作系统？
|
||
|
||
- macOS 12+（Apple Silicon 和 Intel）
|
||
- Windows 10+（64 位）
|
||
|
||
## 安装与配置
|
||
|
||
### 首次启动提示找不到 Node.js
|
||
|
||
CodePilot 需要 Node.js 18+。首次启动的设置向导会检测并提供自动安装。你也可以从 [nodejs.org](https://nodejs.org) 手动安装。
|
||
|
||
### 如何获取 API 密钥？
|
||
|
||
- **Anthropic** — [console.anthropic.com](https://console.anthropic.com)
|
||
- **OpenRouter** — [openrouter.ai](https://openrouter.ai)
|
||
- **智谱 GLM** — [open.bigmodel.cn](https://open.bigmodel.cn)
|
||
- **Kimi** — [platform.moonshot.cn](https://platform.moonshot.cn)
|
||
- **火山引擎** — [console.volcengine.com](https://console.volcengine.com)
|
||
- **阿里云百炼** — [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
|
||
|
||
### 可以使用本地大模型吗？
|
||
|
||
可以。任何提供 OpenAI 兼容 API 的本地服务（Ollama、LM Studio、vLLM 等）都可以作为自定义 API 服务商接入。在服务商设置中选择自定义 API，填写本地服务的 URL。
|
||
|
||
### macOS 提示"无法验证开发者"
|
||
|
||
前往 **系统设置 > 隐私与安全性**，找到 CodePilot 相关提示，点击"仍要打开"。
|
||
|
||
## 使用问题
|
||
|
||
### 代码 / 计划 / 问答三种模式有什么区别？
|
||
|
||
- **代码** — Claude 可以读写文件、执行命令，适合日常开发
|
||
- **计划** — Claude 只分析方案不执行操作，适合规划阶段
|
||
- **问答** — Claude 只回答问题不使用工具，适合纯问答
|
||
|
||
### 如何在手机上与 Claude 对话？
|
||
|
||
使用 [消息桥接](/zh/docs/bridge) 功能，将 CodePilot 连接到 Telegram、Discord、飞书或 QQ。桌面端保持运行即可从手机上与 Claude 对话。
|
||
|
||
### Claude 没有响应怎么办？
|
||
|
||
1. 检查 API 密钥是否有效且有余额
|
||
2. 检查网络连接
|
||
3. 尝试切换到其他服务商
|
||
4. 查看 MCP 页面是否有服务器报错
|
||
5. 重启 CodePilot
|
||
|
||
### 如何导入 CLI 的对话历史？
|
||
|
||
在对话页面使用导入功能，可以搜索并导入 Claude Code CLI 中的历史会话。
|
||
|
||
## 反馈与支持
|
||
|
||
### 如何报告 Bug？
|
||
|
||
在 [GitHub Issues](https://github.com/op7418/CodePilot/issues) 提交，请包含：
|
||
|
||
- 操作系统和 CodePilot 版本
|
||
- 复现步骤
|
||
- 相关错误日志
|