配置 Claude Code

Table of contents

Availability: Experimental

Requires: Docker Desktop 4.58 or later

本指南涵盖了在沙箱环境中运行 Claude Code 的身份验证、配置文件和常用选项。

快速开始

要为项目目录创建沙箱并运行 Claude Code：

$ docker sandbox run claude ~/my-project

使用特定提示词启动 Claude：

$ docker sandbox run <sandbox-name> -- "为登录功能添加错误处理"

或者：

$ docker sandbox run <sandbox-name> -- "$(cat prompt.txt)"

这将启动 Claude 并立即处理提示词。

Claude Code 需要一个 Anthropic API 密钥才能工作。推荐的方法是在 shell 配置文件中设置 ANTHROPIC_API_KEY 环境变量。

Docker Sandboxes 通过守护进程运行，不会继承当前 shell 会话的环境变量。为了使 API 密钥在沙箱中可用，您需要在 shell 配置文件中全局设置它。

将 API 密钥添加到您的 shell 配置文件：

~/.bashrc 或 ~/.zshrc

export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

然后应用更改：

$ docker sandbox create claude ~/project
$ docker sandbox run <sandbox-name>

沙箱将检测环境变量并自动使用它。

如果未找到凭据，Claude Code 将在启动时提示您进行身份验证。使用此方法时，您需要为每个工作区分别进行身份验证。

为避免重复身份验证，请使用上述的 ANTHROPIC_API_KEY 环境变量方法。

可以通过 CLI 选项配置 Claude Code。在沙箱名称和 -- 分隔符之后传递的任何参数都会直接传递给 Claude Code。

在沙箱名称后传递选项：

$ docker sandbox run <sandbox-name> -- [claude-options]

例如：

$ docker sandbox run <sandbox-name> -- --continue

有关可用选项，请参阅 Claude Code CLI 参考。

Claude Code 沙箱模板是一个在沙箱虚拟机内运行的容器镜像。它包括：

默认情况下，Claude 在沙箱中以 --dangerously-skip-permissions 启动。

您可以基于 docker/sandbox-templates:claude-code 构建自定义模板。有关详细信息，请参阅自定义模板。