Installation

CoDev Code runs on Windows, Linux, and macOS. This guide walks you through requesting network access, preparing your environment, installing and configuring CoDev Code, and signing in with SSO.

Request network access

If you don't have internal access to yet, request a connection to the destination IP 10.255.62.213 on ports 80 and 443.

Prepare your environment

CoDev Code requires Node.js >= 24. Check your versions by running node -v and npm -v in a terminal or PowerShell. If Node.js isn't installed yet, download the installers from DataSecurity and follow the steps below for internal networks.

Windows

Download node-v24.15.0-x64.msi and install it (you may need to ask your unit's information-security or IT contact for install permissions). Open PowerShell and check with node -v and npm -v.

If node -v works but npm -v fails

Run the following in PowerShell, type A (if prompted), press Enter, then close and reopen the terminal:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Linux

Download the node-v24.15.0-linux.tar.xz binary and extract it:

tar -xzf node-v24.15.0-linux.tar.xz

Then, from the folder containing the extracted Node.js, run:

# Create the Node.js directory
sudo mkdir -p /usr/local/lib/nodejs
 
# Copy the extracted Node.js into it
sudo cp -ra node-v24.15.0-linux /usr/local/lib/nodejs/

Add these lines to ~/.bashrc:

export NODEJS_HOME=/usr/local/lib/nodejs/node-v24.15.0-linux/bin
export PATH=$NODEJS_HOME:$PATH

Reload your shell with source ~/.bashrc (or open a new terminal), then verify with node -v and npm -v.

Linux with nvm

If you use nvm, install the binary into nvm's versions folder:

# Create the Node.js folder inside nvm
mkdir -p ~/.nvm/versions/node/v24.15.0
 
# Copy the extracted Node.js into it
cp -rn ./node-v24.15.0-linux/. ~/.nvm/versions/node/v24.15.0/

Open a new terminal and run nvm use 24 to use Node.js 24. Optionally make it the default for future terminals:

nvm alias default 24

Verify with node -v and npm -v.

Install and configure

CoDev Code works on both external and internal networks.

Internal network: set the npm registry

On an internal-only machine, npm connects through Nexus, so you may need to point npm at the internal registry (check with your IT contact whether the Nexus connection is in place). Run:

npm config set registry http://10.60.129.132/repository/npm-proxy

Install CoDev Code

Install CoDev Code from npm:

npm i -g codev-code

If you hit a 403 error, unset the proxy first.

Windows PowerShell:

$env:HTTPS_PROXY = $null; $env:HTTP_PROXY = $null; $env:https_proxy = $null; $env:http_proxy = $null

Linux:

unset HTTPS_PROXY HTTP_PROXY https_proxy http_proxy

Without restarting your terminal, re-run npm i -g codev-code.

You can now navigate to a project that you want to work on and run CoDev Code.

cd /path/to/project
codev

On an environment with a browser, it opens automatically so you can sign in. If it doesn't open — or you're on a headless machine — copy the URL from the terminal (just press C) and paste it into another browser. After signing in, copy the code shown and paste it back into the terminal, then press Enter.

If you want to log in again, use the /configure slash command.

If you see "Login failed"

First remove *.viettel.vn from NO_PROXY, then add the proxy environment variables for your OS.

Windows: search for Edit environment variables for your account (not Edit the system environment variables — the two look almost identical). Under User variables, click New… and add:

HTTP_PROXY = <PROXY-IP>:<PROXY-PORT>
HTTPS_PROXY = <PROXY-IP>:<PROXY-PORT>
NODE_USE_SYSTEM_CA = 1
NODE_USE_ENV_PROXY = 1

Then restart PowerShell.

Linux: add this line to the end of ~/.bashrc or ~/.zshrc:

export HTTP_PROXY=<PROXY-IP>:<PROXY-PORT> HTTPS_PROXY=<PROXY-IP>:<PROXY-PORT> http_proxy=<PROXY-IP>:<PROXY-PORT> https_proxy=<PROXY-IP>:<PROXY-PORT> NODE_USE_SYSTEM_CA=1 NODE_USE_ENV_PROXY=1

Then run source ~/.bashrc (or source ~/.zshrc, or open a new terminal).