授权方式分为网页端登录授权和AK/SK鉴权授权两种。请根据你所使用的环境，按需选择合适的方式。
网页端登录授权
仅支持TUI开发模式。如果你尚未登录华为云官网，且本地未配置任何AK/SK，可通过以下方式完成授权。以Windows操作系统为例。
- 在目标项目开发目录下，鼠标右键选择“在终端中打开”，自动唤起PowerShell窗口。
- 输入“codearts”命令并回车，将自动跳转至外部浏览器的华为云登录页面。
- 输入你的华为云账号信息并登录，登录成功后系统自动完成授权。
AK/SK鉴权授权
适用于支持TUI/CLI开发模式。AK/SK鉴权授权提供了进程级临时授权和系统环境变量永久授权两种模式，以灵活适配不同场景。
- 进程级临时授权：仅在当前终端会话内生效，窗口关闭后自动失效。无需持久化存储密钥，特别适合临时调试或在公共机器上进行测试，安全便捷。
- 系统环境变量永久授权：将鉴权信息写入系统Shell或Windows环境变量。新开终端或重启设备后依然有效，适合个人本地长期开发使用，避免重复配置。
前置准备
- 你需要参考文档访问密钥，新建访问密钥。
创建成功后，请单击“立即下载”，保存密钥信息，否则弹窗关闭后将无法再次获取该密钥信息。
- 根据你的操作系统，参考下述章节完成环境变量的配置。
其中，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命令，测试权限是否生效。
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命令，测试授权是否生效。
- 如果成功回显model_id、model_name模型信息，说明永久授权已生效。
进入CLI和TUI开发环境
完成授权后，即可进入TUI或CLI开发环境开展编码开发。
- 进入TUI开发环境
- 打开终端（Windows PowerShell /macOS 终端 / Linux Shell）。
- 在目标项目目录下，执行如下命令。
codearts
- 终端自动拉起TUI交互界面。
- 进入CLI开发环境
- 打开终端并切换到目标项目目录。
- 执行命令中命令，回显正常代表已成功进入CLI开发环境。
