跳转到主要内容

Claude Code 常见问题解答

本文汇总了关于 Claude Code 的常见问题,涉及身份验证、集成、配置等多个方面。如果您想了解更多关于 Claude Code 的信息,请参阅我们的 Claude 文档:Claude Code 概览

如何为 Claude Code 设置单点登录 (SSO)?

我们为团队、企业或控制台组织提供了详细的单点登录设置说明,请参阅:设置单点登录 (SSO)

有没有办法在整个组织中禁用 Claude Code 中的 Opus 模型访问权限?

如果您是 Claude 控制台用户,可以通过控制台组织中的速率限制来配置此功能。如果您使用 Bedrock 或 Vertex,请在 Vertex/Bedrock 项目设置中将 Opus 速率限制设置为 0。请注意,即使在 Vertex 中禁用,用户仍可能在 Claude Code 中切换模型,因此速率限制是最有效的方法。

Claude Code 是否支持 Microsoft Visual Studio IDE 集成(不是 VS Code)?

目前不存在 Visual Studio 2022 集成。Claude Code 目前支持 VS Code、Cursor(及其他 VS Code 分支)、Intellij、Pycharm(及其他 Jetbrains IDE)。

我们如何使用 Claude Code 实现拉取请求审查自动化?

虽然目前还没有现成的拉取请求审查解决方案,但您可以使用 Claude Code GitHub Actions 集成 进行自动审查。目前,您可以使用安全审查操作作为模板,并针对常规拉取请求审查进行自定义。这也是 Claude Code SDK 的一个很好的用例。

我收到一条错误消息,说"需要 Claude Max 或 Pro 才能连接到 Claude Code",但我应该可以通过我的组织的团队或企业计划访问。我该如何排查故障?

这表示您从 Claude Code 设置屏幕中选择了错误的登录方法。请尝试再次运行 /login,并选择与您的主要工作电子邮件地址关联的帐户。如果您仍然无法连接,请参阅 使用您的团队或企业帐户访问 Claude Code 时遇到问题?

使用 Claude Code 与 Bedrock/Vertex API 密钥时,哪些数据会发送到 Anthropic?

当配置了 Bedrock/Vertex 并设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 时,仅发送必要的遥测数据。所有模型 API 请求直接发送到您的 Bedrock/Vertex 端点。请查看 数据流文档 了解完整详情。

有没有办法在不暴露密钥/访问密钥的情况下通过 Bedrock/Vertex 访问 Claude Code?

有。我们的 BedrockVertex 设置指南展示了如何启用此功能。例如,在 Bedrock 的情况下,您可以在添加必要的 配置 并使用 Bedrock 运行 Claude Code 之前运行 `aws configure` 来配置 AWS CLI,或者您可以使用 Bedrock API 密钥,这是 AWS 的一项新功能,可为 Bedrock 使用启用 API 密钥,而无需完整的 AWS 凭证。

Claude Code 中是否提供 1M 上下文窗口,用户是否会收到关于更高定价的警告?

1M 上下文(之前需要使用额度)现已包含在 Claude Code 中,供 Max、Team 和 Enterprise 用户使用 Opus 4.6 或 4.7。使用这些模型的会话可以自动使用完整的 1M 上下文窗口,这意味着更少的压缩和更多的对话保持完整。

我们如何在整个组织中使用自定义环境变量和权限部署 Claude Code?

创建在运行 Claude Code 之前设置环境变量的包装脚本。对于权限,使用带有允许/拒绝列表的 .claude/settings.json 文件。请注意,通配符模式 (*) 并不总是按预期匹配 - 请彻底测试权限。企业团队通常注入标准化的 Claude.md 文件以实现一致的配置。

Claude Code 的路线图上是否有公共代码过滤或归属功能?

不,公共代码过滤和归属功能目前不在路线图上。一些客户使用 BlackDuck 进行代码扫描,但关于成本和误报的反馈好坏参半。我们意识到这是扩展 Claude Code 用户群的一个障碍,正在寻找解决方案。

Claude Code SDK 和 GitHub Actions 中是否提供子代理?

子代理可通过 Claude Code SDK 获得。它们尚未集成到 GitHub Actions 中,但我们正在考虑这一点。当超过三个子代理并行运行时,用户体验会折叠输出以管理复杂性。

可以将子代理配置为使用特定的 MCP 工具吗?

可以,创建子代理时,您可以使用配置中的 `tools` 字段指定它可以访问哪些工具。在子代理配置文件中,您可以省略 tools 字段以继承主线程中的所有工具,或者可以将单个工具指定为逗号分隔列表以获得更精细的控制。在我们的 Claude 文档中了解更多信息:子代理 - 可用工具

我们如何管理 Claude Code 成本,特别是对于自动化工作流?

对于安全审查等自动化工作流,使用 claude --model <alias|name> 配置选项 从 Opus 切换到 Sonnet 以节省成本。您还可以通过控制台仪表板监控使用情况并设置适当的速率限制。请注意,您可以使用工作区为不同的用户组设置更精细的支出限制。在此处了解有关工作区的更多信息:在 Claude 控制台中创建和管理工作区。我们还允许您在控制台中查看每个 API 密钥的支出。有关更多信息,请参阅本文:Claude 控制台中的成本和使用情况报告

Claude Code 能否通过 LiteLLM 等企业代理工作?

是的,Claude Code 支持企业代理配置,只要它们支持 Anthropic API 规范。请按照我们 Claude 文档中的代理设置说明进行操作:代理配置。常见问题源于受限环境中的端口限制。

使用控制台帐户时,我们如何向 Claude Code 添加用户?

直接将用户添加到您的控制台组织,具有 Claude Code 用户或开发者角色 - 这就是所需的全部。然后用户从 Claude Code 中运行 /login 并选择预期的控制台帐户。不要尝试在 Claude Code 工作区中手动创建 API 密钥。

除了 Claude.md 文件之外,是否有基于团队的内存或知识共享?

目前,Claude.md 文件是主要机制。IT 团队可以将标准化的 Claude.md 文件注入到每台机器的 .claude 目录中,以实现组织范围的配置。更高级的团队内存功能正在探索中,但尚未提供。

Claude Code 中的权限如何工作,为什么我的允许列表没有被遵守?

权限在 .claude/settings.json 或 settings.local.json 中使用模式匹配。通配符语法可能很棘手 - "Bash(atlassian-api:*)" 应该可以工作,但可能需要精确的命令匹配。使用 "是的,以后不要再问类似的命令" 来逐步构建权限。检查全局 (~/.claude/settings.json) 和本地设置文件。

Claude Code 是否索引我的整个代码库或使用向量数据库来存储有关我的代码库的信息?

不。Claude Code 可以访问系统提示和一系列工具,可以用来按需导航您的代码库。例如,如果 Claude Code 需要了解有关您的代码库的信息,它将使用搜索工具来搜索您的代码库并按需读取文件。我们发现这比完整的代码库索引更有效和灵活:Claude Code 真的很擅长知道如何筛选代码库以动态收集所需的上下文!

Claude Code 能否与 CI/CD、版本控制和可观测性平台集成?

是的,Claude Code 与 GitHub Actions 集成用于 CI/CD,支持 git 操作,并可以通过 MCP 服务器连接到各种平台。有关更多信息,请参阅我们的 Claude 文档:

为什么我在 GitHub Actions 中看到 "工作流验证失败" 错误?

这通常发生在可重用工作流中。检查您的工作流语法是否正确,以及是否传递了所有必需的参数。如果错误仍然存在,请在此处提交问题,并附上您的工作流配置:github.com/anthropics/claude-code-action

这是否解答了您的问题?