​
身份验证方法

设置Claude Code需要访问Anthropic模型。对于团队，您可以通过以下三种方式之一设置Claude Code访问：
  • 通过Anthropic控制台的Anthropic API
  • Amazon Bedrock
  • Google Vertex AI

​
Anthropic API身份验证

通过Anthropic API为您的团队设置Claude Code访问：
  1. 使用您现有的Anthropic控制台账户或创建新的Anthropic控制台账户
  2. 您可以通过以下任一方法添加用户：
    • 从控制台内批量邀请用户（控制台 -> 设置 -> 成员 -> 邀请）
    • 设置SSO
  3. 邀请用户时，他们需要以下角色之一：
    • “Claude Code”角色意味着用户只能创建Claude Code API密钥
    • “开发者”角色意味着用户可以创建任何类型的API密钥
  4. 每个受邀用户需要完成以下步骤：

​
云提供商身份验证

通过Bedrock或Vertex为您的团队设置Claude Code访问：
  1. 遵循Bedrock文档或Vertex文档
  2. 向您的用户分发环境变量和生成云凭据的说明。阅读更多关于如何在此处管理配置。
  3. 用户可以安装Claude Code

​
访问控制和权限

我们支持细粒度权限，以便您能够精确指定代理被允许做什么（例如运行测试、运行linter）以及不被允许做什么（例如更新云基础设施）。这些权限设置可以检入版本控制并分发给您组织中的所有开发者，也可以由个别开发者自定义。

​
权限系统

Claude Code使用分层权限系统来平衡功能和安全性：
工具类型示例需要批准”是的，不要再问”行为
只读文件读取、LS、Grep否不适用
Bash命令Shell执行是每个项目目录和命令永久生效
文件修改编辑/写入文件是直到会话结束

​
配置权限

您可以使用/permissions查看和管理Claude Code的工具权限。此UI列出所有权限规则和它们来源的settings.json文件。
  • 允许规则将允许Claude Code使用指定工具而无需进一步的手动批准。
  • 询问规则将在Claude Code尝试使用指定工具时询问用户确认。询问规则优先于允许规则。
  • 拒绝规则将阻止Claude Code使用指定工具。拒绝规则优先于允许和询问规则。
  • 附加目录将Claude的文件访问扩展到初始工作目录之外的目录。
  • 默认模式控制Claude在遇到新请求时的权限行为。
权限规则使用格式：工具或工具(可选说明符) 仅为工具名称的规则匹配该工具的任何使用。例如，将Bash添加到允许规则列表中将允许Claude Code使用Bash工具而无需用户批准。

​
权限模式

Claude Code支持几种权限模式，可以在设置文件中设置为defaultMode：
模式描述
default标准行为 - 在首次使用每个工具时提示权限
acceptEdits自动接受会话的文件编辑权限
plan计划模式 - Claude可以分析但不能修改文件或执行命令
bypassPermissions跳过所有权限提示（需要安全环境 - 请参阅下面的警告）

​
工作目录

默认情况下，Claude可以访问启动它的目录中的文件。您可以扩展此访问权限：
  • 启动期间：使用--add-dir <path> CLI参数
  • 会话期间：使用/add-dir斜杠命令
  • 持久配置：添加到设置文件中的additionalDirectories
附加目录中的文件遵循与原始工作目录相同的权限规则 - 它们变得可读而无需提示，文件编辑权限遵循当前权限模式。

​
工具特定权限规则

某些工具支持更细粒度的权限控制： Bash
  • Bash(npm run build) 匹配确切的Bash命令npm run build
  • Bash(npm run test:*) 匹配以npm run test开头的Bash命令
  • Bash(curl http://site.com/:*) 匹配以确切的curl http://site.com/开头的curl命令
Claude Code了解shell操作符（如&&），因此像Bash(safe-cmd:*)这样的前缀匹配规则不会给它运行命令safe-cmd && other-cmd的权限
Bash权限模式的重要限制：
  1. 此工具使用前缀匹配，而不是正则表达式或glob模式
  2. 通配符:*只能在模式末尾使用以匹配任何延续
  3. 像Bash(curl http://github.com/:*)这样的模式可以通过多种方式绕过：
    • URL前的选项：curl -X GET http://github.com/...不会匹配
    • 不同协议：curl https://github.com/...不会匹配
    • 重定向：curl -L http://bit.ly/xyz（重定向到github）
    • 变量：URL=http://github.com && curl $URL不会匹配
    • 额外空格：curl http://github.com不会匹配
为了更可靠的URL过滤，请考虑：
  • 使用带有WebFetch(domain:github.com)权限的WebFetch工具
  • 通过CLAUDE.md指示Claude Code您允许的curl模式
  • 使用钩子进行自定义权限验证
读取和编辑 Edit规则适用于所有编辑文件的内置工具。Claude将尽力将Read规则应用于所有读取文件的内置工具，如Grep、Glob和LS。 读取和编辑规则都遵循gitignore规范，具有四种不同的模式类型：
模式含义示例匹配
//path从文件系统根目录的绝对路径Read(//Users/alice/secrets/**)/Users/alice/secrets/**
~/path从主目录的路径Read(~/Documents/*.pdf)/Users/alice/Documents/*.pdf
/path相对于设置文件的路径Edit(/src/**/*.ts)<设置文件路径>/src/**/*.ts
path或./path相对于当前目录的路径Read(*.env)<cwd>/*.env
像/Users/alice/file这样的模式不是绝对路径 - 它是相对于您的设置文件的！使用//Users/alice/file表示绝对路径。
  • Edit(/docs/**) - 在<项目>/docs/中编辑（不是/docs/！）
  • Read(~/.zshrc) - 读取您主目录的.zshrc
  • Edit(//tmp/scratch.txt) - 编辑绝对路径/tmp/scratch.txt
  • Read(src/**) - 从<当前目录>/src/读取
WebFetch
  • WebFetch(domain:example.com) 匹配对example.com的获取请求
MCP
  • mcp__puppeteer 匹配puppeteer服务器提供的任何工具（在Claude Code中配置的名称）
  • mcp__puppeteer__puppeteer_navigate 匹配puppeteer服务器提供的puppeteer_navigate工具
与其他权限类型不同，MCP权限不支持通配符（*）。要批准MCP服务器的所有工具：
  • ✅ 使用：mcp__github（批准所有GitHub工具）
  • ❌ 不要使用：mcp__github__*（不支持通配符）
要仅批准特定工具，请列出每一个：
  • ✅ 使用：mcp__github__get_issue
  • ✅ 使用：mcp__github__list_issues

​
使用钩子进行额外权限控制

Claude Code钩子提供了一种注册自定义shell命令以在运行时执行权限评估的方法。当Claude Code进行工具调用时，PreToolUse钩子在权限系统运行之前运行，钩子输出可以决定是否批准或拒绝工具调用以代替权限系统。

​
企业管理策略设置

对于Claude Code的企业部署，我们支持企业管理策略设置，这些设置优先于用户和项目设置。这允许系统管理员强制执行用户无法覆盖的安全策略。 系统管理员可以将策略部署到：
  • macOS：/Library/Application Support/ClaudeCode/managed-settings.json
  • Linux和WSL：/etc/claude-code/managed-settings.json
  • Windows：C:\ProgramData\ClaudeCode\managed-settings.json
这些策略文件遵循与常规设置文件相同的格式，但不能被用户或项目设置覆盖。这确保了您组织中一致的安全策略。

​
设置优先级

当存在多个设置源时，它们按以下顺序应用（从最高到最低优先级）：
  1. 企业策略
  2. 命令行参数
  3. 本地项目设置（.claude/settings.local.json）
  4. 共享项目设置（.claude/settings.json）
  5. 用户设置（~/.claude/settings.json）
此层次结构确保始终执行组织策略，同时在适当的情况下仍允许在项目和用户级别的灵活性。

​
凭据管理

Claude Code安全地管理您的身份验证凭据：
  • 存储位置：在macOS上，API密钥、OAuth令牌和其他凭据存储在加密的macOS钥匙串中。
  • 支持的身份验证类型：Claude.ai凭据、Anthropic API凭据、Bedrock Auth和Vertex Auth。
  • 自定义凭据脚本：apiKeyHelper设置可以配置为运行返回API密钥的shell脚本。
  • 刷新间隔：默认情况下，apiKeyHelper在5分钟后或在HTTP 401响应时被调用。设置CLAUDE_CODE_API_KEY_HELPER_TTL_MS环境变量以自定义刷新间隔。