.NET
```csharp
using GitHub.Copilot;
// Default: uses logged-in user credentials
await using CopilotClient client = new();
```
Go
```golang
import copilot "github.com/github/copilot-sdk/go"
// Default: uses logged-in user credentials
client := copilot.NewClient(nil)
```
Java
```java
import com.github.copilot.CopilotClient;
// Default: uses logged-in user credentials
var client = new CopilotClient();
client.start().get();
```
Python
```python
from copilot import CopilotClient
# Default: uses logged-in user credentials
client = CopilotClient()
await client.start()
```
Rust
```rust
use github_copilot_sdk::{Client, ClientOptions};
// Default: uses logged-in user credentials
let client = Client::start(ClientOptions::default()).await?;
```
TypeScript
```typescript
import { CopilotClient } from "@github/copilot-sdk";
// Default: uses logged-in user credentials
const client = new CopilotClient();
```
**何时使用**：
* 用户直接交互的桌面应用程序
* 开发和测试环境
* 用户可以以交互方式登录的任何方案
## GitHub OAuth 应用
使用 OAuth GitHub 应用通过应用程序对用户进行身份验证，并将其凭据传递给 SDK。 这使应用程序能够代表授权应用的用户发出Copilot API 请求。
**工作原理**：
1. 用户已授权您的 OAuth GitHub 应用
2. 你的应用接收用户访问令牌（`gho_` 或 `ghu_` 前缀）
3. 通过其客户端配置将令牌传递到 SDK
**SDK 配置：**
.NET
```csharp
using GitHub.Copilot;
await using var client = new CopilotClient(new CopilotClientOptions
{
GitHubToken = userAccessToken, // Token from OAuth flow
UseLoggedInUser = false, // Don't use stored CLI credentials
});
```
Go
```golang
import copilot "github.com/github/copilot-sdk/go"
client := copilot.NewClient(&copilot.ClientOptions{
GitHubToken: userAccessToken, // Token from OAuth flow
UseLoggedInUser: copilot.Bool(false), // Don't use stored CLI credentials
})
```
Java
```java
import com.github.copilot.CopilotClient;
import com.github.copilot.rpc.*;
var client = new CopilotClient(new CopilotClientOptions()
.setGitHubToken(userAccessToken) // Token from OAuth flow
.setUseLoggedInUser(false) // Don't use stored CLI credentials
);
client.start().get();
```
Python
```python
from copilot import CopilotClient
client = CopilotClient({
"github_token": user_access_token, # Token from OAuth flow
"use_logged_in_user": False, # Don't use stored CLI credentials
})
await client.start()
```
Rust
```rust
use github_copilot_sdk::{Client, ClientOptions};
let client = Client::start(
ClientOptions::default()
.with_github_token(user_access_token)
.with_use_logged_in_user(false),
).await?;
```
TypeScript
```typescript
import { CopilotClient } from "@github/copilot-sdk";
const client = new CopilotClient({
gitHubToken: userAccessToken, // Token from OAuth flow
useLoggedInUser: false, // Don't use stored CLI credentials
});
```
**支持的令牌类型：**
* `gho_` - OAuth 用户访问令牌
* `ghu_` - GitHub应用用户访问令牌
* `github_pat_` - 细粒度个人访问令牌
**不支持：**
* `ghp_` - 经典个人访问令牌（已弃用）
**何时使用**：
* 用户通过GitHub登录的 Web 应用程序
* 基于 Copilot 构建的 SaaS 应用程序
* 需要代表不同用户发出请求的任何多用户应用程序
有关详细信息，请参阅“[GitHub OAuth 设置](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/setup/github-oauth)”。
## 环境变量
对于自动化、CI/CD 管道和服务器到服务器方案，可以使用环境变量进行身份验证。
有关不应使用用户个人访问令牌的组织特性化自动化，请参阅 [服务器到服务器身份验证](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/auth/server-to-server-tokens)。
**支持的环境变量（按优先级顺序）：**
1. `COPILOT_GITHUB_TOKEN` - 推荐用于显式 Copilot 使用场景
2. `GH_TOKEN` - GitHub CLI 兼容
3. `GITHUB_TOKEN` - GitHub Actions兼容
**工作原理**：
1. 使用有效令牌设置受支持的环境变量之一
2. SDK 会自动检测和使用令牌
**SDK 配置：**
无需更改代码 - SDK 会自动检测环境变量：
.NET
```csharp
using GitHub.Copilot;
// Token is read from environment variable automatically
await using CopilotClient client = new();
```
Go
```golang
import copilot "github.com/github/copilot-sdk/go"
// Token is read from environment variable automatically
client := copilot.NewClient(nil)
```
Java
```java
import com.github.copilot.CopilotClient;
// Token is read from environment variable automatically
var client = new CopilotClient();
client.start().get();
```
Python
```python
from copilot import CopilotClient
# Token is read from environment variable automatically
client = CopilotClient()
await client.start()
```
Rust
```rust
use github_copilot_sdk::{Client, ClientOptions};
// Token is read from environment variable automatically
let client = Client::start(ClientOptions::default()).await?;
```
TypeScript
```typescript
import { CopilotClient } from "@github/copilot-sdk";
// Token is read from environment variable automatically
const client = new CopilotClient();
```
**何时使用**：
* CI/CD 管道（GitHub Actions、Jenkins 等）
* 自动测试
* 具有服务帐户的服务器端应用程序
* 在不想使用交互式登录时进行开发
## BYOK （自带密钥）
BYOK 允许你从模型提供程序（如 Microsoft Foundry、OpenAI 或 Anthropic）使用自己的 API 密钥。 这会完全绕过GitHub Copilot身份验证。
**主要优势：**
* 无需GitHub Copilot订阅
* 使用企业模型部署
* 使用模型提供商进行直接计费
* 支持 Microsoft Foundry、OpenAI、Anthropic 以及与 OpenAI 兼容的端点
**有关完整详细信息，请参阅 [BYOK （自带密钥）](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/auth/byok)**，包括：
* Microsoft Foundry 设置
* 提供程序配置选项
* 限制和注意事项
* 完整代码示例
## 身份验证优先级
当有多个身份验证方法可用时，SDK 会按以下优先级顺序使用这些方法：
1. **显式 `gitHubToken`** - 直接传递给 SDK 客户端或会话配置的令牌
2. **直接 API 令牌** - `GITHUB_COPILOT_API_TOKEN`，搭配 `COPILOT_API_URL` 使用
3. **环境变量令牌** - `COPILOT_GITHUB_TOKEN``GH_TOKEN` →→`GITHUB_TOKEN`
4. **已存储的 OAuth 凭据** - 来自之前的 `copilot` CLI 登录
5. **GitHub CLI** - `gh auth` 凭据
对于多用户服务器模式，请传递每会话`gitHubToken`，以便每个会话都使用正确的GitHub标识运行;请参阅 [多租户与服务器部署](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/setup/multi-tenancy)。
## 禁用自动登录
若要防止 SDK 自动使用已存储的凭据或 `gh` CLI 身份验证，请将其配置为禁用已登录用户回退机制：
.NET
```csharp
await using var client = new CopilotClient(new CopilotClientOptions
{
UseLoggedInUser = false, // Only use explicit tokens
});
```
Go
```golang
client := copilot.NewClient(&copilot.ClientOptions{
UseLoggedInUser: copilot.Bool(false), // Only use explicit tokens
})
```
Java
```java
import com.github.copilot.CopilotClient;
import com.github.copilot.rpc.*;
var client = new CopilotClient(new CopilotClientOptions()
.setUseLoggedInUser(false) // Only use explicit tokens
);
client.start().get();
```
Python
```python
client = CopilotClient({
"use_logged_in_user": False, # Only use explicit tokens
})
```
Rust
```rust
use github_copilot_sdk::{Client, ClientOptions};
let client = Client::start(
ClientOptions::default().with_use_logged_in_user(false),
).await?;
```
TypeScript
```typescript
const client = new CopilotClient({
useLoggedInUser: false, // Only use explicit tokens
});
```
## 后续步骤
* [BYOK （自带密钥）](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/auth/byok) - 了解如何使用自己的 API 密钥
* [构建你的第一个由 Copilot 提供支持的应用](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/getting-started) - 生成第一个Copilot驱动的应用
* [将 MCP 服务器与 GitHub Copilot SDK 配合使用](/zh/enterprise-cloud@latest/copilot/how-tos/copilot-sdk/features/mcp) - 连接到外部工具