跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

​
安装问题

如果安装脚本下载失败：
  1. 检查你的网络连接
  2. 确认已安装 curl：which curl
  3. 尝试启用详细输出：curl -fsSL -v https://cli.devin.ai/install.sh | bash
如果你使用企业代理，可能需要配置代理设置：
export https_proxy=http://your-proxy:port
curl -fsSL https://cli.devin.ai/install.sh | bash
如果 PowerShell 安装脚本执行失败：
  1. 检查你的网络连接
  2. 确保你以普通用户身份运行 PowerShell (除非确有必要，否则不要以管理员身份运行)
  3. 如果看到执行策略错误，请尝试： 
    Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
irm https://static.devin.ai/cli/setup.ps1 | iex
  4. 如果你使用企业代理，请先在 PowerShell 中配置代理设置，然后再运行安装命令
作为 PowerShell 脚本的替代方案，你也可以直接下载并运行独立安装程序：
安装程序需要写入权限才能安装二进制文件。如果你看到权限错误：
  1. 检查安装位置是否有写入权限
  2. 不要使用 sudo 运行安装程序——这可能会导致所有权问题
  3. 如果要安装到系统目录，请确保你的用户具有相应权限
如果安装完成但无法找到 devin：macOS / Linux / WSL：
  1. 重启终端，或运行 source ~/.bashrc (或 ~/.zshrc)
  2. 检查二进制文件所在位置是否在你的 PATH 中：echo $PATH
  3. 确认二进制文件存在：ls -la ~/.local/bin/devin (或安装过程中显示的安装位置)
Windows：
  1. 重启 PowerShell 会话
  2. 检查二进制文件所在位置是否在你的 PATH 中：$env:PATH -split ';'
  3. 确认二进制文件存在于安装过程中显示的安装位置
irm 和 iex 是 PowerShell 的别名。如果你看到此错误，说明你是在 Git Bash 或 CMD 中运行安装命令，而不是在 PowerShell 中。**修复：**打开 PowerShell 并在那里运行安装命令：
irm https://static.devin.ai/cli/setup.ps1 | iex
或者，你也可以在 Git Bash 或 CMD 中显式调用 PowerShell：
powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
安装完成后，你可以在 PowerShell、Windows Terminal 或 Git Bash 中使用 Devin CLI。

​
身份验证问题

如果基于浏览器的登录无法正常进行：
  1. 对于远程/SSH 会话，尝试使用手动令牌流程： 
    devin auth login --force-manual-token-flow
  2. 检查你的浏览器是否可以访问身份验证 URL
  3. 确认你的企业账户已启用 Devin CLI 访问权限
如果你在登录后看到授权错误：
  1. 确认你的账户具有访问 Devin CLI 所需的正确权限。你可能需要联系你的 Admin。对于 Enterprise，请参阅 Devin Auth 或 Windsurf Auth，了解如何配置访问权限。
  2. 尝试退出后重新登录：devin auth logout && devin auth login
  3. 检查你的身份验证状态：devin auth status
身份验证令牌会定期过期。只需运行：
devin auth login
即可刷新你的凭据。

​
运行时问题

如果你看到模型不可用的错误：
  1. 检查你的企业是否在 团队设置 中限制了可用模型
  2. 确认模型名称是否正确——使用 /model 查看可用选项
  3. 尝试其他模型：devin --model sonnet -- your prompt
如果你触及用量限制：
  1. 等待几分钟后再重试
  2. 查看你的组织的用量仪表板，确认配额状态
  3. 如果你需要更高的限制，请联系你的 Admin
如果 Agent 停止响应：
  1. 按 Ctrl+C 中断当前操作
  2. 尝试使用 /clear 开始新的会话
  3. 检查你的网络连接
  4. 重启 Devin CLI

​
MCP 服务器问题

如果 MCP 服务器无法启动：
  1. 确认该命令在 Devin CLI 外也能正常运行： 
    npx -y @modelcontextprotocol/server-github
  2. 检查是否已设置所有必填环境变量
  3. 查看服务器输出中的错误信息
如果 MCP 工具未出现：
  1. 服务器可能需要一点时间完成初始化——请等待几秒钟
  2. 检查服务器是否已在你的配置文件中正确配置
  3. 确认你的企业已在团队设置中允许使用 MCP 服务器
MCP 工具默认需要你手动批准。要自动批准特定工具，请将其添加到你的权限配置中：
{
  "permissions": {
    "allow": ["mcp__github__list_issues"]
  }
}

​
获取帮助

如果你仍然遇到问题：
  • 邮件支持： support@cognition.ai
  • 提交 bug 报告： 在 Devin CLI 中使用 /bug 命令，直接向 Devin CLI 开发团队报告问题
  • 检查更新： 运行 devin update，确保你使用的是最新版本