Skip to content
Carry Code | Docs

FAQ

This document answers the most common questions about using Carry Code.

Installation Issues

Section titled “Installation Issues”

Q: Installation failed?

Section titled “Q: Installation failed?”

Solutions:

  1. Check network connection
  2. Confirm your system is supported
  3. Try manual download: visit https://carrycode.ai/releases

Q: Permission denied?

Section titled “Q: Permission denied?”

Solutions:

Terminal window
# Linux/macOS
sudo sh install.sh


# Windows
Run PowerShell as administrator

Q: How to verify installation?

Section titled “Q: How to verify installation?”
Terminal window
carry --help

If you see help information, installation was successful.

API Key Issues

Section titled “API Key Issues”

Q: How to get an API key?

Section titled “Q: How to get an API key?”

DeepSeek (Recommended for China users):

  1. Visit https://platform.deepseek.com
  2. Register an account
  3. Go to “API Keys” page
  4. Click “Create API Key”
  5. Copy the key

OpenAI:

  1. Visit https://platform.openai.com
  2. Register and log in
  3. Go to “API Keys” page
  4. Create a new key

Other providers: Similar process - register and find “API Keys” in settings.

Q: API key error or invalid?

Section titled “Q: API key error or invalid?”
  1. Check if the key was copied completely
  2. Check if the key has expired
  3. Check if usage quota is exceeded
  4. Try regenerating the key

Q: Where is the API key stored?

Section titled “Q: Where is the API key stored?”
  • Config file: ~/.carry/carrycode.json
  • Only stored on your local computer, never uploaded

Model Issues

Section titled “Model Issues”

Q: Which model should I choose?

Section titled “Q: Which model should I choose?”
ScenarioRecommended Model
Programming tasksClaude Sonnet, GPT-4o
Chinese tasksDeepSeek, Kimi
Free usageOllama local deployment

Q: Will switching models lose context?

Section titled “Q: Will switching models lose context?”

No. Conversation context is preserved when switching models.

Q: What models are supported?

Section titled “Q: What models are supported?”

Carry Code supports 17+ providers with 240+ models, including:

  • OpenAI: GPT-4o, GPT-5.2
  • Anthropic: Claude Opus 4.5, Claude Sonnet
  • Google: Gemini 3 Pro
  • DeepSeek: DeepSeek R1, V3
  • Alibaba Cloud: Tongyi Qianwen Qwen3
  • Local: Ollama, vLLM

Usage Issues

Section titled “Usage Issues”

Q: How to update to the latest version?

Section titled “Q: How to update to the latest version?”

In Carry Code, enter:

/update

Or run the installation script again:

Terminal window
curl -fsSL https://carrycode.ai/install.sh | sudo sh

Q: How to switch language?

Section titled “Q: How to switch language?”

Enter:

/language

Then select your desired language.

Q: Will conversations be saved?

Section titled “Q: Will conversations be saved?”

Yes! All your conversations are automatically saved. Use /session to view and manage previous sessions.

Q: Is my data secure?

Section titled “Q: Is my data secure?”
  • API Key: Stored on your local computer, never uploaded
  • Conversation content: Sent to AI provider for processing, avoid sending sensitive information
  • Code files: Only read and modified with your permission

Feature Issues

Section titled “Feature Issues”

Q: What are Build mode and Plan mode?

Section titled “Q: What are Build mode and Plan mode?”
  • Build mode: AI can read/write files and execute commands
  • Plan mode: AI can only read, cannot modify anything

Press Shift + Tab to switch.

Q: What is MCP?

Section titled “Q: What is MCP?”

MCP (Model Context Protocol) is an AI extension protocol that lets you connect to external tools and services.

Q: What are Skills?

Section titled “Q: What are Skills?”

Skills are preset instruction templates that guide AI to work in specific ways.

Q: What is AGENTS.md?

Section titled “Q: What is AGENTS.md?”

A rule file in the project root that makes AI follow your project’s coding standards.

Performance Issues

Section titled “Performance Issues”

Q: Slow response?

Section titled “Q: Slow response?”
  1. Choose a provider with lower network latency
  2. Use a smaller model
  3. Check network connection
  4. Try using local models (Ollama)

Q: Token limit reached?

Section titled “Q: Token limit reached?”

Use /compact to compress context, or create a new session.

Q: How to save API costs?

Section titled “Q: How to save API costs?”
  1. Use cost-effective models (like DeepSeek)
  2. Regularly compress context
  3. Use Plan mode for analysis

Terminal Issues

Section titled “Terminal Issues”

Q: Interface display issues?

Section titled “Q: Interface display issues?”
  1. Try switching themes: /theme
  2. Check if terminal supports true color
  3. Try a different terminal

Q: Keyboard shortcuts not working?

Section titled “Q: Keyboard shortcuts not working?”
  1. Check if using correct keys
  2. Some terminals may not support all shortcuts

Other Issues

Section titled “Other Issues”

Q: How to report issues?

Section titled “Q: How to report issues?”

Q: Is there a community?

Section titled “Q: Is there a community?”

Next Steps

Section titled “Next Steps”