常见问题
本文档解答使用 Carry Code 时最常见的问题。
Q：安装失败怎么办？
Section titled “Q：安装失败怎么办？”解决方法：
- 检查网络连接
- 确认系统是否在支持列表中
- 尝试手动下载安装：访问 https://carrycode.ai/releases
- 如果是权限问题，使用
sudo运行安装脚本
Q：提示权限不足？
Section titled “Q：提示权限不足？”Linux/macOS 使用 sudo 运行安装脚本：
sudo sh install.shWindows 以管理员身份运行 PowerShell。
Q：如何验证安装成功？
Section titled “Q：如何验证安装成功？”carry --help如果看到帮助信息，说明安装成功。
API Key 问题
Section titled “API Key 问题”Q：API Key 怎么获取？
Section titled “Q：API Key 怎么获取？”DeepSeek（推荐国内用户）：
- 访问 https://platform.deepseek.com
- 注册账号
- 进入「API Keys」页面
- 点击「创建 API Key」
- 复制密钥
OpenAI：
- 访问 https://platform.openai.com
- 注册并登录
- 进入「API Keys」页面
- 创建新密钥
其他服务商：大多流程类似，注册后在设置中找到「API Keys」。
Q：API Key 错误或无效？
Section titled “Q：API Key 错误或无效？”- 检查 Key 是否复制完整
- 确认 Key 没有过期
- 检查是否超额使用
- 尝试重新生成 Key
Q：API Key 存储在哪里？
Section titled “Q：API Key 存储在哪里？”- 配置文件：
~/.carry/carrycode.json - 仅存储在你本地电脑，不会上传
Q：应该选择哪个模型？
Section titled “Q：应该选择哪个模型？”| 场景 | 推荐模型 |
|---|---|
| 编程任务 | Claude Sonnet、GPT-4o |
| 中文任务 | DeepSeek、Kimi |
| 免费使用 | Ollama 本地部署 |
| 性价比 | DeepSeek |
Q：模型切换会丢失上下文吗？
Section titled “Q：模型切换会丢失上下文吗？”不会。切换模型后会话上下文会保留。
Q：支持哪些模型？
Section titled “Q：支持哪些模型？”Carry Code 支持 17+ 服务商的 240+ 模型，包括：
- OpenAI: GPT-4o, GPT-5.2
- Anthropic: Claude Opus 4.5, Claude Sonnet
- Google: Gemini 3 Pro
- DeepSeek: DeepSeek R1, V3
- 阿里云: 通义千问 Qwen3
- 本地: Ollama, vLLM
Q：如何更新到最新版本？
Section titled “Q：如何更新到最新版本？”在 Carry Code 中输入：
/update或者重新运行安装脚本：
curl -fsSL https://carrycode.ai/install.sh | sudo shQ：如何切换语言？
Section titled “Q：如何切换语言？”输入：
/language然后选择你想要的语言。
Q：会话内容会保存吗？
Section titled “Q：会话内容会保存吗？”是的！你的所有对话都会自动保存。使用 /session 可以查看和管理之前的会话。
Q：数据安全吗？
Section titled “Q：数据安全吗？”- API Key：存储在你本地电脑上，不会上传
- 对话内容：发送给 AI 服务商处理，请勿发送敏感信息
- 代码文件：只在你允许的情况下才会被读取和修改
Q：什么是 Build 模式和 Plan 模式？
Section titled “Q：什么是 Build 模式和 Plan 模式？”- Build 模式：AI 可以读写文件、执行命令
- Plan 模式：AI 只能读取，不能修改
按 Shift + Tab 切换。
Q：MCP 是什么？
Section titled “Q：MCP 是什么？”MCP（Model Context Protocol）是 AI 扩展协议，可以让你连接外部工具和服务。
Q：Skill 是什么？
Section titled “Q：Skill 是什么？”Skill 是预设的指令模板，可以引导 AI 按照特定方式工作。
Q：AGENTS.md 是什么？
Section titled “Q：AGENTS.md 是什么？”项目根目录的规则文件，让 AI 按照项目的编码规范工作。
Q：响应速度慢怎么办？
Section titled “Q：响应速度慢怎么办？”- 选择网络延迟更低的服务商
- 使用更小的模型
- 检查网络连接
- 尝试使用本地模型（Ollama）
Q：token 限制怎么办？
Section titled “Q：token 限制怎么办？”使用 /compact 压缩上下文，或创建新会话。
Q：如何节省 API 调用成本？
Section titled “Q：如何节省 API 调用成本？”- 使用性价比高的模型（如 DeepSeek）
- 定期压缩上下文
- 使用 Plan 模式进行分析
Q：界面显示异常？
Section titled “Q：界面显示异常？”- 尝试切换主题：
/theme - 检查终端是否支持真彩色
- 尝试使用不同的终端
Q：快捷键不工作？
Section titled “Q：快捷键不工作？”- 确认使用的是正确按键
- 某些终端可能不支持所有快捷键
Q：如何反馈问题？
Section titled “Q：如何反馈问题？”- GitHub Issue：https://github.com/carrycode/carrycode/issues