本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用承載字符設定 Claude Code
<a name="coding-agents-claude-code-bearer-token"></a>

在此路徑上，Claude Code 會將 OpenTelemetry (OTel) 指標直接傳送至 Amazon CloudWatch 原生 OTLP 指標端點，並使用承載字符 (CloudWatch 指標 API 金鑰） 進行驗證。不需要 OpenTelemetry 收集器。這是個別開發人員或小型團隊取得 Claude Code 指標到 Coding Agent Insights 儀表板的最快方式。

**重要**  
承載字符是長期憑證。我們建議僅在短期 AWS 登入資料不可行的情況下使用，例如外部的開發人員筆記型電腦 AWS。如需安全權衡和金鑰輪換指引，請參閱 [設定指標的承載字符身分驗證](CloudWatch-OTLP-MetricsBearerTokenAuth.md)。透過公司 SSO 聯合身分的組織應該改為使用企業推展搭配 Claude 應用程式閘道。請參閱 [使用 Claude 應用程式閘道設定 Claude Code](coding-agents-claude-code-gateway.md)。

## 先決條件
<a name="coding-agents-claude-code-bearer-token-prereqs"></a>
+ 安裝在開發人員機器上的 Claude Code。
+ Claude Code 呼叫模型以進行推論的工作方式。此遙測設定與推論無關，因此您可以使用 Anthropic 帳戶 （預設 Claude Code 供應商） 或 Amazon Bedrock。若要使用 Amazon Bedrock 進行推論，請參閱 [Claude Code 文件中的 Amazon Bedrock 上的](https://code.claude.com/docs/en/amazon-bedrock) Claude Code。
+ CloudWatch 指標 API 金鑰 （承載字符），從具有 CloudWatch 指標許可的 IAM 使用者建立。如需建立 IAM 使用者並產生金鑰的程序，請參閱 [設定指標的承載字符身分驗證](CloudWatch-OTLP-MetricsBearerTokenAuth.md)。

## 設定指標匯出工具
<a name="coding-agents-claude-code-bearer-token-configure"></a>

Claude Code 透過環境變數設定 OpenTelemetry。在 Shell 中設定下列變數，以啟動 Claude Code （或 shell 描述檔） 來啟用指標、選取 OTLP/HTTP 通訊協定，並在 `Authorization`標頭中使用承載字符將指標匯出器指向 CloudWatch 指標端點。包含完整`/v1/metrics`路徑。

```
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://monitoring.{{region}}.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer {{YOUR_API_KEY}}"
```

**注意**  
將承載字符視為秘密。避免將其遞交至以不安全方式共用或備份的來源控制或 shell 設定檔。如中所述定期輪換金鑰[設定指標的承載字符身分驗證](CloudWatch-OTLP-MetricsBearerTokenAuth.md)。

## 新增身分和組織屬性
<a name="coding-agents-claude-code-bearer-token-attributes"></a>

編碼 Agent Insights 儀表板會依開發人員、團隊、部門和其他組織維度將用量分組。透過`OTEL_RESOURCE_ATTRIBUTES`環境變數提供這些做為 OTel *資源*屬性。從開發人員的身分和組織的結構設定值。

```
export OTEL_RESOURCE_ATTRIBUTES="\
user.id={{alias}},\
user.email={{developer@example.com}},\
user.name={{Jane Doe}},\
department={{engineering}},\
team.id={{platform}},\
cost_center={{cc-1234}},\
organization={{example-corp}},\
location={{us-seattle}},\
role={{software-engineer}},\
manager={{manager@example.com}}"
```

**注意**  
將這些設定為資源屬性 （而不是每個資料點屬性） 符合儀表板預期的形狀，因此您可以依 `@resource.team.id`、 `@resource.department`和類似的標籤分組。Claude Code 會自動在指標`type`上標記指標層級維度，例如 `model`和 。

## 驗證和檢視
<a name="coding-agents-claude-code-bearer-token-verify"></a>

執行 Claude Code 來產生指標，然後確認到達 CloudWatch 的資料。

**驗證指標**

1. 執行執行一些工作的 Claude Code 工作階段。

1. 在 CloudWatch 主控台中，選擇 **GenAI 可觀測性**、**編碼客服人員洞見**，然後選擇 Claude Code 索引標籤。指標通常會在幾分鐘內顯示。

1. 或者，直接使用 PromQL 查詢指標。如需詳細資訊，請參閱[PromQL 查詢](CloudWatch-PromQL-Querying.md)。

如需完整、持續更新的指引，請參閱 GitHub 上[搭配 Amazon Bedrock 的 Claude Code 指南](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock)。