授权

在码道CLI中，您可以通过进程级配置或系统环境变量配置来完成授权操作。其中，进程级配置适用于临时授权，而系统环境变量配置则用于设置永久授权。

前置准备

参考访问密钥新建访问密钥。
在新建访问密钥页面，勾选协议，单击“下一步”，填写密钥“描述”后，单击“确定”，完成授权。

创建成功后，请单击“立即下载”，保存密钥信息，否则弹窗关闭后将无法再次获取该密钥信息。
根据您的操作系统，参考下述章节并完成环境变量的配置。其中，Access Key Id和Secret Access Key的值，通过您下载保存的credentials.csv文件中获取。

Windows

下面为您介绍在Windows系统中，如何通过进程级配置和系统环境变量配置完成授权操作。

配置进程级变量

通过配置进程级变量，可对当前窗口完成临时授权。

如果您使用CMD，请执行下述命令进行配置。
```
set CODEARTS_CLI_AK=Access Key Id
```
```
set CODEARTS_CLI_SK=Secret Access Key
```
执行完成后，在当前窗口执行如下命令，检验是否生效。
```
echo %CODEARTS_CLI_AK%
echo %CODEARTS_CLI_SK%
```
如果显示您刚设置的内容，则配置生效，如果显示“%CODEARTS_CLI_AK%”或者“%CODEARTS_CLI_SK%”，表示配置未生效。
如果您使用PowerShell，请执行下述命令进行配置。
```
$env:CODEARTS_CLI_AK="Access Key Id"
```
```
$env:CODEARTS_CLI_SK="Secret Access Key"
```
执行完成后，您可以执行下述命令验证是否设置成功。无异常回显则表示配置生效。
```
echo $env:CODEARTS_CLI_AK
```
```
echo $env:CODEARTS_CLI_SK
```

配置系统环境变量

通过配置系统环境变量，可实现配置永久生效。

打开“系统属性”，单击“高级”页签下的“环境变量”。
修改“用户变量”或者“系统变量”，创建CODEARTS_CLI_AK和CODEARTS_CLI_SK。

其中，CODEARTS_CLI_AK的值为“Access Key Id”，CODEARTS_CLI_SK的值为“Secret Access Key”。
配置完成后，您可进入想要启动的项目，鼠标右键“在终端中打开”，输入“codearts”并回车。

进入TUI开发环境，表示永久性配置生效。

macOS

下面为您介绍在macOS系统中，如何通过进程级配置和系统环境变量配置完成授权操作。

配置进程级变量

打开终端并执行下述命令，可对当前窗口完成临时授权。

export CODEARTS_CLI_AK="Access Key Id"
export CODEARTS_CLI_SK="Secret Access Key"

执行完成后，在当前窗口执行如下命令，检验是否生效。
```
echo $CODEARTS_CLI_AK
echo $CODEARTS_CLI_SK
```
如果输出密钥内容，表示配置生效，如果没有输出或者空行，表示配置没有生效。

配置系统环境变量

执行如下命令，把环境变量配置追加写入到“～/.zshrc”文件。

echo 'export CODEARTS_CLI_AK="Access Key Id"' >> ~/.zshrc

echo 'export CODEARTS_CLI_SK="Secret Access Key"' >> ~/.zshrc

执行如下命令，将两个变量永久保存。
```
source ~/.zshrc
```
执行如下命令，验证是否生效。
```
echo $CODEARTS_CLI_AK
echo $CODEARTS_CLI_SK
```
如果输出密钥内容，表示配置生效，如果没有输出或者空行，表示配置没有生效。

Linux

您可以根据您的需要，选择授权方式：

表1 不同授权方式对比
授权方式	生效范围	生命周期	适用Shell	权限要求	典型使用场景
临时进程授权	仅当前终端窗口	关闭终端立即失效，重启服务器清空	bash、zsh、sh	普通用户即可	临时调试、一次性测试、临时执行脚本，不想留存密钥
Bash用户永久授权	当前登录用户，所有新终端	永久保存，重启终端或者服务器仍存在	Linux默认Bash（CentOS、Ubuntu或者麒麟等）	普通用户即可	个人服务器、日常高频使用，本机仅自己操作

临时进程授权

仅当前终端窗口生效，关闭窗口后配置自动失效，适合一次性调试、临时执行命令，不持久存储密钥。

配置临时环境变量（AK/SK）。
在终端中执行以下命令，为当前会话窗口注入临时访问凭证：
```
export CODEARTS_CLI_AK="Access Key Id"
export CODEARTS_CLI_SK="Secret Access Key"
```
其中，Access Key Id和Secret Access Key请替换为您实际获取的密钥值，获取方式请参考前置准备。

验证授权是否成功。

例如，在终端中执行codearts models命令，测试权限是否生效。

如果输出类似如下回显信息，表示授权成功。

root@szvphis32149187:~# codearts models
model_id                                           model_name
-------------------------------------------------------------
huaweicloud-maas/deepseek-v3.2                     DeepSeek-V3.2
huaweicloud-maas/GLM-4.7-SFT-Harmony               GLM-4.7-ArkTS-SPARK
huaweicloud-maas/Glm-5-internal                    GLM-5
huaweicloud-maas/GLM-5.1                           GLM-5.1
huaweicloud-maas/GLM-5.2                           GLM-5.2

如果返回认证失败或错误提示，请执行如下命令，检查配置的AK/SK是否正确。
```
echo $CODEARTS_CLI_AK
echo $CODEARTS_CLI_SK
```

Bash用户永久授权

如果当前登录用户需要长期使用，推荐此方式进行永久授权。新开终端、重启服务器配置均保留，无需管理员权限。

将环境变量追加写入Bash配置文件。
执行以下命令，将CODEARTS_CLI_AK和CODEARTS_CLI_SK环境变量追加到当前用户的“.bashrc”文件中：
```
echo 'export CODEARTS_CLI_AK="Access Key Id"' >> ~/.bashrc
echo 'export CODEARTS_CLI_SK="Secret Access Key"' >> ~/.bashrc
```
其中，Access Key Id和Secret Access Key请替换为您实际获取的密钥值，获取方式请参考前置准备。
重新加载Bash配置，使添加的环境变量立即生效。
```
source ~/.bashrc
```

验证授权是否永久生效。

关闭当前终端窗口，打开一个新的终端会话，执行codearts models命令，测试授权是否生效。

如果回显模型信息，说明永久授权已生效。

root@szvphis32149187:~# codearts models
model_id                                           model_name
-------------------------------------------------------------
huaweicloud-maas/deepseek-v3.2                     DeepSeek-V3.2
huaweicloud-maas/GLM-4.7-SFT-Harmony               GLM-4.7-ArkTS-SPARK
huaweicloud-maas/Glm-5-internal                    GLM-5
huaweicloud-maas/GLM-5.1                           GLM-5.1
huaweicloud-maas/GLM-5.2                           GLM-5.2